Provided by: sg3-utils_1.36-1ubuntu1_amd64 bug

NAME

       sg_vpd - fetch Vital Product Data (VPD) pages via a SCSI INQUIRY command

SYNOPSIS

       sg_vpd  [--enumerate]  [--help]  [--hex]  [--ident]  [--long]  [--maxlen=LEN]  [--page=PG]
       [--quiet] [--raw] [--verbose] [--version] DEVICE

DESCRIPTION

       This utility fetches a Vital Product Data page and decodes  it  or  outputs  it  in  ASCII
       hexadecimal or binary. VPD pages are fetched with a SCSI INQUIRY command.

       Probably  the  most  important  page  is  the Device Identification VPD page (page number:
       0x83). Since SPC-3, support for this page has been flagged as mandatory. This page can  be
       fetched by using the --ident option.

       The reference document used for interpreting VPD pages (and the INQUIRY standard response)
       is T10/1713-D Revision 36e (SPC-4, 24 August 2012) found at http://www.t10.org .  Obsolete
       and  reserved  items  in  the  standard  INQUIRY  response  output are displayed in square
       brackets.

       When no options are given, other than a DEVICE, then the "Supported VPD pages"  (0x0)  VPD
       page is fetched and decoded.

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.

       -e, --enumerate
              list the names of the known VPD pages, first the standard pages,  then  the  vendor
              specific  pages.  Each  group is sorted in abbreviation order. The DEVICE and other
              options are ignored and this utility exits after listing the VPD page names.

       -h, --help
              outputs the usage message summarizing command line  options  then  exits.   Ignores
              DEVICE if given.

       -H, --hex
              outputs  the  requested  VPD page in ASCII hexadecimal. Can be used multiple times,
              see section on the ATA information vpd page.

       -i, --ident
              decode the device identification (0x83) VPD page. When used once  this  option  has
              the  same  effect  as '--page=di'. When use twice then the short form of the device
              identification VPD page's logical unit designator is decoded. In  the  latter  case
              this option has the same effect as '--quiet --page=di_lu'.

       -l, --long
              when  decoding  some  VPD  pages,  give  a  little more output. For example the ATA
              Information VPD page only shows the signature (in hex) and  the  IDENTIFY  (PACKET)
              DEVICE (in hex) when this option is given.

       -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 (or LEN is zero) then 252  is  used  (apart
              from  the  ATA  Information  VPD  page  which defaults to 572) and, if the response
              indicates this value is insufficient, another INQUIRY command is sent with a larger
              value  in  the cdb's "allocation length" field.  If this option is given and LEN is
              greater than 0 then only one INQUIRY command is sent.  Since  many  simple  devices
              implement  the INQUIRY command badly (and do not support VPD pages) then the safest
              value to use for LEN is 36. See the sg_inq man page for the more information.

       -p, --page=PG
              where PG is the VPD page to be decoded or output. The PG argument can either be  an
              abbreviation,  a  number  or  a  pair or numbers separated by a comma. The VPD page
              abbreviations can be seen by using the --enumerate option. If a number is given  it
              is  assumed  to  be decimal unless it has a hexadecimal indicator which is either a
              leading '0x' or a trailing 'h'. If one number is given then it is assumed to  be  a
              VPD  page number. If two numbers are given the second number indicates which vendor
              specific VPD page to decode when several pages share the same VPD page  number.  If
              this  option  is not given (nor '-i', '-l' nor '-V') then the "Supported VPD pages"
              (0x0) VPD page is fetched and decoded. If PG is '-1' or 'sinq'  then  the  standard
              INQUIRY response is output.

       -q, --quiet
              suppress the amount of decoding output.

       -r, --raw
              output  requested  VPD  page  in  binary.  The  output should be piped to a file or
              another utility when this option is used. The binary is sent to stdout, and  errors
              are sent to stderr.

       -v, --verbose
              increases the level or verbosity.

       -V, --version
              print out version string then exit.

ATA INFORMATION VPD PAGE

       This  VPD  page  (0x89  or  'ai')  is  defined by the SCSI to ATA Translation standard. It
       contains information about the SAT layer, the  "signature"  of  the  ATA  device  and  the
       response  to  the  ATA  IDENTIFY (PACKET) DEVICE command. The latter part has 512 bytes of
       identity, capability and settings data which the hdparm utility is capable of decoding (so
       this utility doesn't decode it).

       To  unclutter  the  output  for  this page, the signature and the IDENTIFY (PACKET) DEVICE
       response are not output unless the --long option (or --hex or --raw) are given.  When  the
       --long  option  is  given  the IDENTIFY (PACKET) DEVICE response is output as 256 (16 bit)
       words as is the fashion for ATA devices. To see that response as a string of bytes use the
       '-HH'  option. To format the output suitable for hdparm to decode use either the '-HHH' or
       '-rr' option. For example if 'dev/sdb' is a  SATA  disk  behind  a  SAT  layer  then  this
       command:  'sg_vpd  -p  ai  -HHH /dev/sdb | hdparm --Istdin' should decode the ATA IDENTIFY
       (PACKET) DEVICE response.

NOTES

       Since some VPD pages (e.g. the Extended INQUIRY page) depend on settings in  the  standard
       INQUIRY  response,  then the standard INQUIRY response is output as a pseudo VPD page when
       PG is set to '-1' or 'sinq'. Also the decoding of some fields (e.g. the  Extended  INQUIRY
       page's SPT field) is expanded when the '--long' option is given using the standard INQUIRY
       response information (e.g. the PDT and the PROTECT fields).

       In the 2.4 series of Linux kernels the DEVICE must be a SCSI generic (sg) device.  In  the
       2.6  series  block  devices (e.g. disks and ATAPI DVDs) can also be specified. For example
       "sg_inq /dev/sda" will work in the 2.6 series kernels. From lk  2.6.6  other  SCSI  "char"
       device names may be used as well (e.g. "/dev/st0m").

EXIT STATUS

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

EXAMPLES

       The examples in this page use Linux device names.  For  suitable  device  names  in  other
       supported Operating Systems see the sg3_utils(8) man page.

       To  see  the  VPD  pages  that  a  device  supports, use with no options. The command line
       invocation is shown first followed by a typical response:

          # sg_vpd /dev/sdb
       Supported VPD pages VPD page:
         Supported VPD pages [sv]
         Unit serial number [sn]
         Device identification [di]
         Extended inquiry data [ei]
         Block limits (SBC) [bl]

       To see the VPD page numbers associated with each supported  page  then  add  the  '--long'
       option to the above command line. To view a VPD page either its number or abbreviation can
       be given to the '--page=' option. The page name  abbreviations  are  shown  within  square
       brackets above. In the next example the Extended inquiry data VPD page is listed:

          # sg_vpd --page=ei /dev/sdb
       extended INQUIRY data VPD page:
         ACTIVATE_MICROCODE=0 SPT=0 GRD_CHK=0 APP_CHK=0 REF_CHK=0
         UASK_SUP=0 GROUP_SUP=0 PRIOR_SUP=0 HEADSUP=1 ORDSUP=1 SIMPSUP=1
         WU_SUP=0 CRD_SUP=0 NV_SUP=0 V_SUP=0
         P_I_I_SUP=0 LUICLR=0 R_SUP=0 CBCS=0
         Multi I_T nexus microcode download=0
         Extended self-test completion minutes=0
         POA_SUP=0 HRA_SUP=0 VSA_SUP=0

       To  check  if  any protection types are supported by a disk use the '--long' option on the
       Extended inquiry data VPD page:

          # sg_vpd --page=ei --long /dev/sdb
          extended INQUIRY data VPD page:
            ACTIVATE_MICROCODE=0
            SPT=1 [protection types 1 and 2 supported]
            GRD_CHK=1
            ....

       Further examples can be found on the http://sg.danny.cz/sg/sg3_utils.html web page.

AUTHOR

       Written by Douglas Gilbert

REPORTING BUGS

       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT

       Copyright © 2006-2012 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(sg3_utils), sg3_utils(sg3_utils), sdparm(sdparm), hdparm(hdparm)