# man > SG_SAFTE(8)

[SG_SAFTE(8)](https://www.chedong.com/phpMan.php/man/SGSAFTE/8/markdown)                                   SG3_UTILS                                  [SG_SAFTE(8)](https://www.chedong.com/phpMan.php/man/SGSAFTE/8/markdown)



## NAME
       sg_safte - access 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 de‐
       vice  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  re‐
       ported 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 re‐
              turns 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  re‐
              turns 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 re‐
              turns 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  re‐
              turns  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
       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:

       <http://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.

## 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)](https://www.chedong.com/phpMan.php/man/sg3utils/8/markdown)  man
       page.

## AUTHORS
       Written by Hannes Reinecke and Douglas Gilbert.

## REPORTING BUGS
       Report bugs to <dgilbert at interlog dot com>.

## COPYRIGHT
       Copyright © 2004-2016 Hannes Reinecke and Douglas Gilbert
       This software is distributed under a FreeBSD license. There is NO warranty; not even for MER‐
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

## SEE ALSO
       **sg**___**inq,** **sg**___**ses** **(in** **sg3**___**utils** **package);** **safte-monitor** **(internet)**



sg3_utils-1.43                               April 2016                                  [SG_SAFTE(8)](https://www.chedong.com/phpMan.php/man/SGSAFTE/8/markdown)