sgpio man page

sgpio — captive backplane LED control utility


sgpio [-h] [-V] [[-d|--disk <device>[,<device>...]] | [-p|--port <port>[,<port>...]]] [-s|--status <status>] [-f|--freq <frequency>]


Serial General Purpose Input Output (SGPIO) is a communication method used between a main board and a variety of internal and external hard disk drive bay enclosures.  This utility can be used to control LEDs in an enclosure. For more information about SGPIO, please consult the SFF-8485 Specification.  


-h, --help

displays a short help text

-V, --version

displays the utility and AHCI SGPIO specification

-d, --disk

disk name of LED location.  Names are sda,sdb,sdc,... Multiple names can be provided in a comma-delimited list.

-p, --port

SATA port number of LED location, can be used if a disk name is no  longer valid. 0,1,2,3,... Multiple ports can be provided in a comma-delimited list.

-s, --status

status of the LED to set.  LED status is: locate, fault, rebuild, off

-f, --freq

Set the frequency at which the LED should blink (in Hz). Frequency should be an integer between 1 and 10.


Set the locate LED on SDA with an Intel Intelligent backplane:

sgpio -d sda -s locate

Set the locate LED on SDA to flash at 3 Hz for non-intelligent backplanes:

sgpio -d sda -s locate -f 3

Set SATA port 2 with fault at a 3 Hz flash rate:

sgpio -p 2 -s fault -f 3

Set disks sda through sdf to fault:

sgpio -d sda,sdb,sdc,sdd,sde,sdf -s fault

Exit Status

sgpio should return zero when successful.  It will return with a  non-zero value if there was a failure.


Eric R. Hall <>


December 2007 version 0.3 USER COMMANDS