Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 ®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	 hard‐
	      ware 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	compo‐
	      nents.

       -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 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 ®(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 ®(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 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.35			 November 2012			   SG_SAFTE(8)

Vote for polarhome