Provided by: sg3-utils_1.46-1ubuntu0.22.04.1_amd64 
NAME
sg_vpd - fetch SCSI VPD page and/or decode its response
SYNOPSIS
sg_vpd [--all] [--enumerate] [--examine] [--force] [--help] [--hex] [--ident] [--inhex=FN]
[--long] [--maxlen=LEN] [--page=PG] [--quiet] [--raw] [--vendor=VP] [--verbose]
[--version] [DEVICE]
DESCRIPTION
This utility, when DEVICE is given, fetches a Vital Product Data (VPD) page and decodes it
or outputs it in ASCII hexadecimal or binary. VPD pages are fetched with a SCSI INQUIRY
command.
Alternatively the --inhex=FN option can be given. In this case FN is assumed to be a file
name ('-' for stdin) containing ASCII hexadecimal representing a VPD page response. If the
--raw option is also given then binary input is assumed (rather than ASCII hexadecimal).
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/BSR INCITS 502 Revision 22 which is draft SPC-5 revision 19, 22 April 2019. It can
be found at http://www.t10.org .
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.
-a, --all
decode all VPD pages. When used with DEVICE the pages to be decoded are found in
the "Supported VPD pages" VPD page. Pages that cannot be decoded are displayed in
hex; add the --long option to have ASCII displayed to the right of each line of
hex.
If this option is used with the --inhex=FN option then the file FN is assumed to
contain 1 or more VPD pages (in ASCII hex or binary). Decoding continues until the
file is exhausted (or an error occurs). Sanity checks are applied on each VPD
page's length and the ascending order of VPD page numbers (required by SPC-4) so
bad data may be detected.
If the --page=PG option is also given then no VPD page whose page number is greater
than PG (or its numeric equivalent) is decoded.
-e, --enumerate
list the names of the known VPD pages, first the standard pages (i.e. those
defined by T10), then the vendor specific pages. Each group is sorted in
abbreviation order. The DEVICE and most other options are ignored and this utility
exits after listing the VPD page names. May be used together with --page=PG where
PG is numeric. If so, it searches for the summary lines of all VPD pages whose
number matches PG. May be used with --vendor=VP to restrict output to known vendor
specific pages for vendor/product VP.
-E, --examine
scan part of all of the VPD space (from 0x0 to 0xff) and output any pages found.
This option ignores the contents of VPD page 0x0 which should contain a list of all
supported VPD pages. However some vendors either forget to list some standard pages
or perhaps purposely don't list vendor specific pages which are in the range 0xc0
to 0xff.
If the --page=PG option is not given and this option is given once then the scan is
from VPD page number 0x80 to 0xff inclusive. If the --page=PG option is given then
the scan is from 0x80 to PG inclusive. If this option is given twice then the scan
starts at VPD page 0x0.
The sdparm utility which lists mode and VPD pages also has a --examine option will
similar functionility.
-f, --force
As a sanity check, the normal action when fetching VPD pages other than page 0x0
(the "Supported VPD pages" VPD page), is to first fetch page 0x0 and only if the
requested page is one of the supported pages, to go ahead and fetch the requested
page.
When this option is given, skip checking of VPD page 0x0 before accessing the
requested VPD page. The prior check of VPD page 0x0 is known to crash certain USB
devices, so use with care.
-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.
To generate output suitable for placing in a file that can be used by a later
invocation with the --inhex=FN option, use the '-HHHH' option (e.g. 'sg_vpd -p di
-HHHH /dev/sg3 > dev_id.hex'). The reason '-HHHH' is used is to flag that unadorned
hexadecimal (without other text or address offsets) is sent to stdout.
-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'.
-I, --inhex=FN
FN is expected to be a file name (or '-' for stdin) which contains ASCII
hexadecimal or binary representing a VPD page (or a standard INQUIRY) response.
This utility will then decode that response. It is preferable to also supply the
--page=PG option, if not this utility will attempt to guess which VPD page (or
standard INQUIRY) the response is associated with. The hexadecimal should be
arranged as 1 or 2 digits representing a byte each of which is whitespace or comma
separated. Anything from and including a hash mark to the end of line is ignored.
If the --raw option is also given then FN is treated as binary.
-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/abbreviations 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 (or abbreviations) are given then the
second one is the same as VP (see the --vendor=VP option). 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. This option may also be used with the --enumerate (see its description).
If PG is not found in the 'Supported VPD pages' VPD page (0x0) then EDOM is
returned. To bypass this check use the --force option.
-q, --quiet
suppress the amount of decoding output.
-r, --raw
if not used with --inhex=FN then 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.
if used with --inhex=FN then the contents of FN is treated as binary.
-M, --vendor=VP
where VP is a vendor (e.g. "sea" for Seagate) or vendor/product acronym (e.g.
"hp3par" for the 3PAR array from HP). Many vendors have re-used the numbers at the
beginning of the vendor specific VPD page range (e.g. page 0xc0) and this option
is a way of selecting only those which are of interest. Using a VP of "xxx" will
list the available acronyms.
If this option is used with --page=PG and PG is an acronym then this option is
ignored. If PG is a number (e.g. 0xc0) then VP is used to choose the which vendor
specific page (e.g. sharing page number 0xc0) to decode.
-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").
The DEVICE is opened with a read-only flag (e.g. in Unix with the O_RDONLY flag).
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
....
Search for the name (and acronym) of all pages that share VPD page number 0xb0 .
# sg_vpd --page=0xb0 --enumerate
Matching standard VPD pages:
bl 0xb0 Block limits (SBC)
oi 0xb0 OSD information
sad 0xb0 Sequential access device capabilities (SSC)
Some examples follow using the "--all" option. Send an ASCII hexadecimal representation of
all VPD pages to a file:
# sg_vpd --all -HHHH /dev/sg3 > all_vpds.hex
At some later time that file could be decoded with:
# sg_vpd --all --inhex=all_vpds.hex
To do the equivalent as the previous example but use a file containing binary:
# sg_vpd --all --raw /dev/sg3 > all_vpds.bin
# sg_vpd --all --raw --inhex=all_vpds.bin
Notice that "--raw" must be given with the second (--inhex) invocation to alert the
utility that all_vpds.bin contains binary as it assumes ASCII hexadecimal by default. Next
we only decode T10 specified VPD pages excluding vendor specific VPD pages that start at
page number 0xc0:
# sg_vpd --all --page=0xbf --raw --inhex=all_vpds.bin
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-2021 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)