Content-type: text/html; charset=UTF-8
Man page of SG_SAFTE
SG_SAFTE
Section: SG3_UTILS (8)
Updated: November 2012
Index
Return to Main Contents
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
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 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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- NOTES
-
- EXAMPLES
-
- EXIT STATUS
-
- AUTHORS
-
- REPORTING BUGS
-
- COPYRIGHT
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 03:17:26 GMT, June 13, 2014