diff options
Diffstat (limited to 'doc/sg_rep_pip.8')
-rw-r--r-- | doc/sg_rep_pip.8 | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/doc/sg_rep_pip.8 b/doc/sg_rep_pip.8 new file mode 100644 index 00000000..c614fd3f --- /dev/null +++ b/doc/sg_rep_pip.8 @@ -0,0 +1,58 @@ +.TH SG_REP_PIP "8" "January 2022" "sg3_utils\-1.48" SG3_UTILS +.SH NAME +sg_rep_pip \- send SCSI REPORT PROVISIONING INITIALIZATION PATTERN command +.SH SYNOPSIS +.B sg_rep_pip +[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-raw\fR] +[\fI\-\-readonly\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] +\fIDEVICE\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Sends a SCSI REPORT PROVISIONING INITIALIZATION PATTERN command to +\fIDEVICE\fR and outputs the data returned. This command is found in the +SBC\-4 draft standard, revision 21 (sbc4r21.pdf). +.SH OPTIONS +Arguments to long options are mandatory for short options as well. +.TP +\fB\-h\fR, \fB\-\-help\fR +output the usage message then exit. +.TP +\fB\-H\fR, \fB\-\-hex\fR +output the response in hexadecimal to stdout. When used once the whole +response is output in ASCII hexadecimal, prefixed by an address (starting at +0) on each line. When used twice the whole response is output in hexadecimal +with no leading address (on each line). The default action is the same as +giving the \fI\-\-hex\fR option once. +.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 8192 is used. The maximum allowed value of \fILEN\fR is 1048576. +.TP +\fB\-r\fR, \fB\-\-raw\fR +output the SCSI response (i.e. the data\-out buffer) in binary (to stdout). +.TP +\fB\-R\fR, \fB\-\-readonly\fR +open the \fIDEVICE\fR read\-only (e.g. in Unix with the O_RDONLY flag). +The default is to open it read\-write. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +increase the level of verbosity, (i.e. debug output). +.TP +\fB\-V\fR, \fB\-\-version\fR +print the version string and then exit. +.SH EXIT STATUS +The exit status of sg_rep_pip is 0 when it is successful. Otherwise see +the sg3_utils(8) man page. +.SH AUTHORS +Written by Douglas Gilbert. +.SH "REPORTING BUGS" +Report bugs to <dgilbert at interlog dot com>. +.SH COPYRIGHT +Copyright \(co 2020\-2022 Douglas Gilbert +.br +This software is distributed under a BSD\-2\-Clause license. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.B sg3_utils(sg3_utils) |