sesutil(8)

sesutil8

Manage scsi enclosure services devices

Usage

sesutil {fault [-u /dev/sesN] disk | all on | off}

sesutil {fault -u /dev/sesN sesid on | off}

sesutil {locate [-u /dev/sesN] disk | all on | off}

sesutil {locate -u /dev/sesN sesid on | off}

sesutil map [--libxo options] [-u /dev/sesN]

sesutil show [--libxo options] [-u /dev/sesN]

sesutil status [--libxo options] [-u /dev/sesN]

Overview

The sesutil utility can be used to query and modify various parameter of SCSI Enclosure Services (SES) devices.

List of supported commands:

fault [-u /dev/sesN] disk|all on|off

Change the state of the external fault LED associated with disk. disk can be the device name of the disk, like ‘da12’, or all to indicate all disks attached to SES controllers.

fault -u /dev/sesN sesid on|off

Change the state of the external fault LED associated with an element connected to the SES controller. sesid must be the element ID of a valid item attached to the controller. Use the map command to list the elements attached to a controller.

locate [-u /dev/sesN] disk|all on|off

Change the state of the external locate LED associated with disk. disk can be the device name of the disk, like ‘da12’, or all to indicate all disks attached to SES controllers.

locate -u /dev/sesN sesid on|off

Change the state of the external locate LED associated with an element connected to the SES controller. sesid must be the element ID of a valid item attached to the controller. Use the map command to list the elements attached to a controller.

map [--libxo options] [-u /dev/sesN]

Display a map of all elements connected to the specified ses(4) controller. If no controller is specified, all controllers are mapped.

show [--libxo options] [-u /dev/sesN]

Display user-friendly summary of specified ses(4) controller. If no controller is specified, all controllers are mapped.

status [--libxo options] [-u /dev/sesN]

Display the status of the specified ses(4) controller. If no controller is specified, the status of each controller is returned.

Common options:

--libxo options

Generate output via libxo(3) in a selection of different human and machine readable formats. See xo_options(7).

Examples

Turn off all locate LEDs:

sesutil locate all off

Turn on the locate LED for the drive bay corresponding to da15:

sesutil locate da15 on

Turn on the fault LED for a drive bay not associated with a device:

sesutil fault -u /dev/ses2 7 on

Releases

27 releases since FreeBSD 10.3-RELEASE; the text changed 16 times.

  1. 10.3
  2. 10.4
  3. 11.0
  4. 11.1
  5. 11.2
  6. 11.3
  7. 11.4
  8. 12.0
  9. 12.1
  10. 12.2
  11. 12.3
  12. 12.4
  13. 13.0–13.1
  14. 13.2
  15. 13.3–14.5
  16. 15.0–15.1
  17. 16.0

--libxo since FreeBSD 11.2-RELEASE.

History

The sesutil utility first appeared in FreeBSD 11.0.

Authors

The sesutil utility was written by Baptiste Daroussin ⟨[email protected]⟩ and Allan Jude ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.