sgpio (1) Linux Manual Page
sgpio – captive backplane LED control utility
Synopsis
sgpio [-h] [-V] [[-d|–disk <device>[,<device>…]] | [-p|–port <port>[,<port>…]]] [-s|–status <status>] [-f|–freq <frequency>]Description
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.Options
- -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.
Examples
- 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