SESUTIL(8)

NAME
sesutil - Utility for managing SCSI Enclosure Services (SES) device

SYNOPSIS
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]

DESCRIPTION
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

SEE ALSO
libxo(3), xo_options(7), ses(4)

HISTORY
The sesutil utility first appeared in FreeBSD 11.0.

AUTHORS
-nosplit The sesutil utility was written by Baptiste Daroussin <bapt@FreeBSD.org> and Allan Jude <allanjude@FreeBSD.org>.