sg_safte - TE) device
sg_safte [--config] [--devstatus] [--encstatus] [--flags] [--help] [--hex] [--insertions] [--raw] [--usage] [--verbose] [--version] DEVICE
SG_SAFTE(8) SG3_UTILS SG_SAFTE(8) 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 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 (R)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 (R)(READ BUFFER ID 0) cdb to the device, which returns a list of the enclosure hard- ware resources. -d, --devstatus will issue a Read Device Slot Status (R)(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 (R)(READ BUFFER ID 1) cdb to the device, which returns the operational state of the compo- nents. -f, --flags will issue a Read Global Flags (R)(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 BUF- FER command (i.e. with buffer_id=0). This should be the enclo- sure configuration. If used twice (or more often), the response to subsequent READ BUFFER commands is output. -i, --insertions will issue a Read Device Insertions (R)(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 std- out. 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 (R)(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. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+--------------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+--------------------------+ |Availability | system/storage/sg3_utils | +---------------+--------------------------+ |Stability | Pass-through uncommitted | +---------------+--------------------------+ 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-techni- cal-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. Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from http://sg.danny.cz/sg/p/sg3_utils-1.46.tgz. Further information about this software can be found on the open source community website at http://sg.danny.cz/sg/sg3_utils.html. 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 (C) 2004-2016 Hannes Reinecke and Douglas Gilbert This software is distributed under a FreeBSD license. There is NO war- ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR- POSE. SEE ALSO sg_inq, sg_ses (in sg3_utils package); safte-monitor (internet) sg3_utils-1.43 April 2016 SG_SAFTE(8)