---
name: "sesutil"
section: "8"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/sesutil"
---

# sesutil(8)

manage SCSI Enclosure Services devices

## NAME

**sesutil** – manage SCSI Enclosure Services devices

## 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)](/ses/4.md) controller. If no controller is specified, all controllers are mapped.

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

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

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

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

Common options:

- **--libxo** *options*

  Generate output via [libxo(3)](/libxo/3.md) in a selection of different human and machine readable formats. See [xo\_options(7)](/xo_options/7.md).

## 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)](/libxo/3.md), [ses(4)](/ses/4.md), [xo\_options(7)](/xo_options/7.md)

## 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*⟩.