phpman > man > sg_get_elem_status(8)

SG_GET_ELEM_STATUS(8)                         SG3_UTILS                        SG_GET_ELEM_STATUS(8)



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  re‐
       sponse 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 STA‐
              TUS command. Only two values are defined for that field: 0 for  all  element  descrip‐
              tors; 1 for those element descriptors that are outside 'spec' or have depopulation in‐
              formation 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 DE‐
              VICE is also given then DEVICE is ignored, a warning is issued and the utility contin‐
              ues, decoding the file named FN. See the "FORMAT OF FILES CONTAINING ASCII  HEX"  sec‐
              tion  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  "allo‐
              cation  length"  field.  If  not given then 32 is used. 32 is enough space for the re‐
              sponse header only.  LEN should be a multiple of 32 (e.g. 32, 64,  and  96  are  suit‐
              able).

       -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  identi‐
              fier (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 MER‐
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
       sg_get_lba_status(8), sg3_utils(8)



sg3_utils-1.45                               August 2019                       SG_GET_ELEM_STATUS(8)