Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SESUTIL(8)		     System Manager's Manual		      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 in-
	     dicate all disks attached to SES controllers.

     fault -u /dev/sesN sesid on|off
	     Change  the state of the external fault LED associated with an ele-
	     ment 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 in-
	     dicate all disks attached to SES controllers.

     locate -u /dev/sesN sesid on|off
	     Change the state of the external locate LED associated with an ele-
	     ment 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  con-
	     troller 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
     The sesutil utility was written by  Baptiste  Daroussin  <bapt@FreeBSD.org>
     and Allan Jude <allanjude@FreeBSD.org>.

FreeBSD ports 15.1		  July 16, 2025 		      SESUTIL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sesutil&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help