SG3UTILS                                            SGSAFTE(1M)



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

SYNOPSIS
     sgsafte [--config]  [--devstatus]  [--encstatus]  [--flags]
     [--help]  [--hex]  [--insertions]  [--raw] [--usage] [--ver-
     bose] [--version] DEVICE

DESCRIPTION
     Fetches enclosure status (via a SCSI READ  BUFER  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
     (Reg.)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  (Reg.)(READ
          BUFER ID 0) cdb to the device, which returns a list of
          the enclosure hardware resources.

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

     -f, --flags
          will issue a Read Global Flags (Reg.)(READ BUFER 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 BUFER command  in  ASCI
          hex to stdout. If used once, output the response to the
          first READ BUFER command (i.e. with bufferid=0). This



sg3utils-1.25     Last change: September 2007                  1






SG3UTILS                                            SGSAFTE(1M)



          should  be  the  enclosure configuration. If used twice
          (or more often), the response to subsequent READ BUFER
          commands is output.

     -i, --insertions
          will issue a Read Device Insertions (Reg.)(READ  BUFER
          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 BUFER command in  binary
          to  stdout.  If  used  once, output the response to the
          first READ BUFER command (i.e. with bufferid=0). This
          should  be  the  enclosure configuration. If used twice
          (or more often), the response to subsequent READ BUFER
          commands is output.

     -u, --usage
          will issue a Read Usage Statistics  (Reg.)(READ  BUFER
          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 docu-
     ment 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 sgses utility.

EXAMPLES
     To view the configuration:

        sgsafte /dev/sg1

     To view the device slot status:

        sgsafte --devstatus /dev/sg1




sg3utils-1.25     Last change: September 2007                  2






SG3UTILS                                            SGSAFTE(1M)



EXIT STATUS
     The exit status of sgsafte is 0 when it is successful. Oth-
     erwise see the sg3utils(1M) man page.

AUTHORS
     Written by Hannes Reinecke and Douglas Gilbert.

REPORTING BUGS
     Report bugs to .

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

SEE ALSO
     sginq, sgses (in sg3utils package); safte-monitor

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWsg3utilsu  
    
     Interface Stability  Committed      
    

NOTES
     Source for sg3utils is available on http:/opensolaris.org.






















sg3utils-1.25     Last change: September 2007                  3