NAME

       sg_get_elem_status - send SCSI GET PHYSICAL ELEMENT STATUS command

SYNOPSIS

       sg_get_elem_status  [--brief]  [--filter=FLT] [--help] [--hex] [--inhex=FN] [--maxlen=LEN]
       [--raw] [--readonly] [--report-type=RT] [--starting=ELEM] [--verbose] [--version] DEVICE

DESCRIPTION

       Send the SCSI GET PHYSICAL ELEMENT STATUS command to the DEVICE and output  the  response.
       The command was introduced in (draft) SBC-4 revision 16.

       The  default  action is to decode the response into one physical element status descriptor
       per line then output a header and the status descriptors to stdout.  The amount of  output
       can be reduced by the --brief option.

       Rather  than send this SCSI command to DEVICE, if the --inhex=FN option is given, then the
       contents of the file named FN are decoded as ASCII hex and then processed if  it  was  the
       response of this command.

OPTIONS

       Arguments to long options are mandatory for short options as well.

       -b, --brief
              tbd

       -f, --filter=FLT
              where  FLT  is  placed in a two bit field called FILTER in the GET PHYSICAL ELEMENT
              STATUS command. Only two values are defined for  that  field:  0  for  all  element
              descriptors;  1  for  those  element  descriptors  that  are outside 'spec' or have
              depopulation information to report. In both cases  the  REPORT  TYPE  and  STARTING
              ELEMENT  fields  may  further  restrict  (reduce) the number of element descriptors
              returned. The default value is zero.

       -h, --help
              output the usage message then exit.

       -H, --hex
              output response to this command in ASCII hex.

       -i, --inhex=FN
              where FN is a function name whose contents are assumed to be ASCII hexadecimal.  If
              DEVICE  is  also  given then DEVICE is ignored, a warning is issued and the utility
              continues, decoding the file named FN. See the "FORMAT OF  FILES  CONTAINING  ASCII
              HEX"  section in the sg3_utils manpage for more information. If the --raw option is
              also given then the contents of FN are treated as binary.

       -m, --maxlen=LEN
              where LEN is the (maximum) response length in bytes. It  is  placed  in  the  cdb's
              "allocation length" field. If not given then 32 is used. 32 is enough space for the
              response header only.  LEN should be a multiple of 32 (e.g.  32,  64,  and  96  are
              suitable).

       -r, --raw
              output  response  in binary (to stdout) unless the --inhex=FN option is also given.
              In that case the input file name (FN) is decoded as binary (and the output is _not_
              in binary).

       -R, --readonly
              open the DEVICE read-only (e.g. in Unix with the O_RDONLY flag).  The default is to
              open it read-write.

       -t, --report-type=RT
              where RT will be placed in the REPORT TYPE field of the GET PHYSICAL ELEMENT STATUS
              command. Currently only two values are defined: 0 for 'physical element' and 1: for
              'storage element'. The default value is 1 .

       -s, --starting=ELEM
              where ELEM is the placed in the STARTING ELEMENT field of the GET PHYSICAL  ELEMENT
              STATUS  command.  Only  physical elements with identifiers equal to or greater than
              ELEM are returned. The default value is zero which while it isn't a  valid  element
              identifier (since they must be non-zero) is given in an example in Annex L of SBC-4
              revision 17. So an ELEM of zero is assumed to be valid in this context.

       -v, --verbose
              increase the level of verbosity, (i.e. debug output). Additional output  caused  by
              this option is sent to stderr.

       -V, --version
              print the version string and then exit.

EXIT STATUS

       The  exit  status  of  sg_get_elem_status  is  0  when it is successful. Otherwise see the
       sg3_utils(8) man page.

AUTHORS

       Written by Douglas Gilbert.

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

       Copyright © 2019 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_get_lba_status(8), sg3_utils(8)