aboutsummaryrefslogtreecommitdiff
path: root/doc/sg_vpd.8
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2008-02-08 03:18:20 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2008-02-08 03:18:20 +0000
commit9a6e88da0a972f148c3f2923c372f0e5deb4707f (patch)
tree4006696a9f2ec19498562158775bed2912dbd197 /doc/sg_vpd.8
parent1d5b601b2385057766df8f87e140388b08f630cd (diff)
downloadsg3_utils-9a6e88da0a972f148c3f2923c372f0e5deb4707f.tar.gz
add '--maxlen=' option to sg_vpd and sg_inq
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@147 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc/sg_vpd.8')
-rw-r--r--doc/sg_vpd.820
1 files changed, 16 insertions, 4 deletions
diff --git a/doc/sg_vpd.8 b/doc/sg_vpd.8
index bdb1fd17..11f60174 100644
--- a/doc/sg_vpd.8
+++ b/doc/sg_vpd.8
@@ -1,11 +1,12 @@
-.TH SG_VPD "8" "April 2007" "sg3_utils\-1.24" SG3_UTILS
+.TH SG_VPD "8" "February 2008" "sg3_utils\-1.26" SG3_UTILS
.SH NAME
sg_vpd \- fetches Vital Product Data (VPD) pages using a SCSI INQUIRY command
.SH SYNOPSIS
.B sg_vpd
[\fI\-\-enumerate\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-ident\fR]
-[\fI\-\-long\fR] [\fI\-\-page=PG\fR] [\fI\-\-quiet\fR] [\fI\-\-raw\fR]
-[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
+[\fI\-\-long\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-page=PG\fR]
+[\fI\-\-quiet\fR] [\fI\-\-raw\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR]
+\fIDEVICE\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
@@ -50,6 +51,17 @@ 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.
.TP
+\fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR
+where \fILEN\fR is the (maximum) response length in bytes. It is placed in the
+cdb's "allocation length" field. If not given (or \fILEN\fR 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 \fILEN\fR 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
+\fILEN\fR is 36. See the sg_inq man page for the more information.
+.TP
\fB\-p\fR, \fB\-\-page\fR=\fIPG\fR
where \fIPG\fR is the VPD page to be decoded or output. The \fIPG\fR argument
can either be an abbreviation, a number or a pair or numbers separated by a
@@ -107,7 +119,7 @@ Written by Doug Gilbert
.SH "REPORTING BUGS"
Report bugs to <dgilbert at interlog dot com>.
.SH COPYRIGHT
-Copyright \(co 2006\-2007 Douglas Gilbert
+Copyright \(co 2006\-2008 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.