1sgpio(1)                         USER COMMANDS                        sgpio(1)
2
3
4

NAME

6       sgpio - captive backplane LED control utility
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

20       -h, --help
21              displays a short help text
22
23       -V, --version
24              displays the utility and AHCI SGPIO specification
25
26       -d, --disk
27              disk name of LED location.  Names are  sda,sdb,sdc,...  Multiple
28              names can be provided in a comma-delimited list.
29
30       -p, --port
31              SATA  port number of LED location, can be used if a disk name is
32              no longer valid. 0,1,2,3,... Multiple ports can be provided in a
33              comma-delimited list.
34
35       -s, --status
36              status  of  the  LED  to  set.   LED  status  is: locate, fault,
37              rebuild, off
38
39       -f, --freq
40              Set the frequency at which the LED should blink  (in  Hz).  Fre‐
41              quency should be an integer between 1 and 10.
42
43

EXAMPLES

45       Set the locate LED on SDA with an Intel Intelligent backplane:
46              sgpio -d sda -s locate
47
48       Set  the  locate  LED on SDA to flash at 3 Hz for non-intelligent back‐
49       planes:
50              sgpio -d sda -s locate -f 3
51
52       Set SATA port 2 with fault at a 3 Hz flash rate:
53              sgpio -p 2 -s fault -f 3
54
55       Set disks sda through sdf to fault:
56              sgpio -d sda,sdb,sdc,sdd,sde,sdf -s fault
57

EXIT STATUS

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

AUTHOR

63       Eric R. Hall <Eric.R.Hall@intel.com>
64
65
66
67version 0.3                      December 2007                        sgpio(1)