sg_vpd: add --examine option; gcc-9: suppress warnings; more testing work

git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@821 6180dd3e-e324-4e3e-922d-17de1ae2f315

2 files changed, 30 insertions, 10 deletions

diff --git a/doc/sg_modes.8 b/doc/sg_modes.8
index ed2d2e33..d5cadc51 100644
--- a/doc/sg_modes.8
+++ b/doc/sg_modes.8
@@ -1,4 +1,4 @@
-.TH SG_MODES "8" "September 2018" "sg3_utils\-1.43" SG3_UTILS
+.TH SG_MODES "8" "April 2019" "sg3_utils\-1.45" SG3_UTILS
 .SH NAME
 sg_modes \- reads mode pages with SCSI MODE SENSE command
 .SH SYNOPSIS
@@ -82,6 +82,9 @@ descriptors are present in the response or not, they are not output.
 examine each mode page in the range 0 through to 62 (inclusive).
 If some response is given then print out the mode page name or
 number (in hex) if the name is not known.
+.br
+The sdparm utility which lists mode and VPD pages also has a \fB\-\-examine\fR
+option will similar functionility.
 .TP
 \fB\-f\fR, \fB\-\-flexible\fR
 Some devices, bridges and/or drivers attempt crude translations between
@@ -298,7 +301,7 @@ Written by Douglas Gilbert
 .SH "REPORTING BUGS"
 Report bugs to <dgilbert at interlog dot com>.
 .SH COPYRIGHT
-Copyright \(co 2000\-2018 Douglas Gilbert
+Copyright \(co 2000\-201p Douglas Gilbert
 .br
 This software is distributed under the GPL version 2. There is NO
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
diff --git a/doc/sg_vpd.8 b/doc/sg_vpd.8
index 1bbdc7c2..08c371d9 100644
--- a/doc/sg_vpd.8
+++ b/doc/sg_vpd.8
@@ -1,12 +1,13 @@
-.TH SG_VPD "8" "March 2018" "sg3_utils\-1.43" SG3_UTILS
+.TH SG_VPD "8" "April 2019" "sg3_utils\-1.45" SG3_UTILS
 .SH NAME
 sg_vpd \- fetch SCSI VPD page and/or decode its response
 .SH SYNOPSIS
 .B sg_vpd
-[\fI\-\-all\fR] [\fI\-\-enumerate\fR] [\fI\-\-force\fR] [\fI\-\-help\fR]
-[\fI\-\-hex\fR] [\fI\-\-ident\fR] [\fI\-\-inhex=FN\fR] [\fI\-\-long\fR]
-[\fI\-\-maxlen=LEN\fR] [\fI\-\-page=PG\fR] [\fI\-\-quiet\fR] [\fI\-\-raw\fR]
-[\fI\-\-vendor=VP\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] [\fIDEVICE\fR]
+[\fI\-\-all\fR] [\fI\-\-enumerate\fR] [\fI\-\-examine\fR] [\fI\-\-force\fR]
+[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-ident\fR] [\fI\-\-inhex=FN\fR]
+[\fI\-\-long\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-page=PG\fR] [\fI\-\-quiet\fR]
+[\fI\-\-raw\fR] [\fI\-\-vendor=VP\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR]
+[\fIDEVICE\fR]
 .SH DESCRIPTION
 .\" Add any additional description here
 .PP
@@ -25,8 +26,8 @@ has been flagged as mandatory. This page can be fetched by
 using the \fI\-\-ident\fR option.
 .PP
 The reference document used for interpreting VPD pages (and the INQUIRY
-standard response) is T10/BSR INCITS 502 Revision 19 which is draft SPC\-5
-revision 19, 14 February 2018). It can be found at http://www.t10.org .
+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 .
 .PP
 When no options are given, other than a \fIDEVICE\fR, then the "Supported
 VPD pages" (0x0) VPD page is fetched and decoded.
@@ -60,6 +61,22 @@ summary lines of all VPD pages whose number matches \fIPG\fR. May be used
 with \fI\-\-vendor=VP\fR to restrict output to known vendor specific pages
 for vendor/product \fIVP\fR.
 .TP
+\fB\-E\fR, \fB\-\-examine\fR
+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.
+.br
+If the \fI\-\-page=PG\fR option is not given and this option is given once
+then the scan is from VPD page number 0x80 to 0xff inclusive. If the
+\fI\-\-page=PG\fR option is given then the scan is from 0x80 to
+\fIPG\fR inclusive. If this option is given twice then the scan starts at
+VPD page 0x0.
+.br
+The sdparm utility which lists mode and VPD pages also has a \fB\-\-examine\fR
+option will similar functionility.
+.TP
 \fB\-f\fR, \fB\-\-force\fR
 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
@@ -304,7 +321,7 @@ Written by Douglas Gilbert
 .SH "REPORTING BUGS"
 Report bugs to <dgilbert at interlog dot com>.
 .SH COPYRIGHT
-Copyright \(co 2006\-2018 Douglas Gilbert
+Copyright \(co 2006\-2019 Douglas Gilbert
 .br
 This software is distributed under a FreeBSD license. There is NO
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.