On Apache
Under GNU General Public License
2024-04-28 00:23 @18.217.60.35 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
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 hardware 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 components.
-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 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 (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 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 (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.
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 (C) 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)
sg3_utils-1.35 November 2012 SG_SAFTE(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-28 00:23 @18.217.60.35 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)