sg_safte - access SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device

       Written by Hannes Reinecke and Douglas Gilbert.

       Copyright © 2004-2016 Hannes Reinecke and Douglas Gilbert
       This  software  is  distributed  under  a  BSD-2-Clause  license.  There  is  NO  warranty;  not even for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

       Fetches enclosure status (via a SCSI READ BUFFER command).  The DEVICE should be a  SAF-TE  device  which
       may  be  a  storage  array  controller (INQUIRY peripheral device type 0xc) or a generic processor device
       (INQUIRY peripheral device type 0x3).

       If no options are given (only the DEVICE argument) then the overall enclosure status as reported  by  the
       option --config ®is reported.

       To view the configuration:

          sg_safte /dev/sg1

       To view the device slot status:

          sg_safte --devstatus /dev/sg1

       The exit status of sg_safte is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

       sg_safte - access SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device

       This implementation is based on the intermediate review document dated 19970414 and named "SR041497.pdf".
       So it is quite old. Intel and nStor are the authors. Intel have a zip archive containing this and related
       documents  in  the  "SAF-TE:  SCSI Accessed Fault Tolerant Enclosures Interface Specification" section of
       this page:

       https://www.intel.com/content/www/us/en/servers/ipmi/ipmi-technical-resources.html

       Similar functionality is provided by SPC-4 SCSI Enclosure Services (SES) devices (Peripheral device  type
       0xd), which can be queried with the sg_ses utility.

       Arguments  to  long  options  are  mandatory  for  short  options  as  well.  The options are arranged in
       alphabetical order based on the long option name.

       -c, --config
              will issues a ReadEnclosureConfiguration ®(READ BUFFER ID 0) cdb to the device, which returns  a
              list of the enclosure hardware resources.

       -d, --devstatus
              will  issue  a  ReadDeviceSlotStatus  ®(READ  BUFFER  ID 4) cdb to the device, which returns
              information about the current state of each drive or slot.

       -s, --encstatus
              will issue a ReadEnclosureStatus ®(READ BUFFER ID 1)  cdb  to  the  device,  which  returns  the
              operational state of the components.

       -f, --flags
              will  issue  a ReadGlobalFlags ®(READ BUFFER ID 5) cdb to the device, which read the most recent
              state of the global flags of the RAID processor device.

       -h, --help
              output the usage message then exit.

       -H, --hex
              output the response to a READ BUFFER command in ASCII hex to stdout.  If  used  once,  output  the
              response  to  the  first READ BUFFER command (i.e. with buffer_id=0). This should be the enclosure
              configuration. If used twice (or more often), the response to subsequent READ BUFFER  commands  is
              output.

       -i, --insertions
              will  issue  a  ReadDeviceInsertions  ®(READ  BUFFER  ID  3)  cdb to the device, which returns
              information about the number of times devices have  been  inserted  whilst  the  RAID  system  was
              powered on.

       -r, --raw
              output  the  response  to  a  READ  BUFFER  command  in binary to stdout. If used once, output the
              response to the first READ BUFFER command (i.e. with buffer_id=0). This should  be  the  enclosure
              configuration.  If  used twice (or more often), the response to subsequent READ BUFFER commands is
              output.

       -u, --usage
              will issue a ReadUsageStatistics ®(READ BUFFER ID 2)  cdb  to  the  device,  which  returns  the
              information on total usage time and number of power-on cycles of the RAID device.

       -v, --verbose
              increase the level of verbosity, (i.e. debug output).

       -V, --version
              print the version string and then exit.

       Report bugs to <dgilbert at interlog dot com>.

sg_inq,sg_ses(insg3_utilspackage);safte-monitor(internet)

sg3_utils-1.43                                     April 2016                                        SG_SAFTE(8)

sg_safte  [--config]  [--devstatus]  [--encstatus]  [--flags]  [--help]  [--hex]  [--insertions]  [--raw]
       [--usage] [--verbose] [--version] DEVICE