table of contents
SG_SAFTE(8) | SG3_UTILS | SG_SAFTE(8) |
NAME¶
sg_safte - access SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) deviceSYNOPSIS¶
sg_safte [ --config] [--devstatus] [--encstatus] [ --flags] [--help] [--hex] [--insertions] [ --raw] [ --usage] [--verbose] [--version] DEVICEDESCRIPTION¶
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-2012 Hannes Reinecke and Douglas GilbertSEE ALSO¶
sg_inq, sg_ses (in sg3_utils package); safte-monitor (internet)November 2012 | sg3_utils-1.35 |