Provided by: sg3-utils_1.33-1_amd64 bug

NAME

       sg_safte - Fetch status from a SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device

SYNOPSIS

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

DESCRIPTION

       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.

OPTIONS

       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 Read Enclosure Configuration ®(READ BUFFER ID 0) cdb to  the  device,
              which returns a list of the enclosure hardware resources.

       -d, --devstatus
              will  issue  a Read Device Slot Status ®(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 Read Enclosure Status ®(READ BUFFER ID 1) cdb  to  the  device,  which
              returns the operational state of the components.

       -f, --flags
              will  issue  a  Read Global Flags ®(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  Read Device Insertions ®(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 Read Usage Statistics ®(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.

NOTES

       The implementation is based on the intermediate review document eg as found at

       http://www.intel.com/design/servers/ipmi/saf-te.htm

       As the specification was never finalized this document serves as the de-facto standard.

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

EXAMPLES

       To view the configuration:

          sg_safte /dev/sg1

       To view the device slot status:

          sg_safte --devstatus /dev/sg1

EXIT STATUS

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

AUTHORS

       Written by Hannes Reinecke and Douglas Gilbert.

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

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

SEE ALSO

       sg_inq, sg_ses (in sg3_utils package); safte-monitor (internet)