From 660ac667940dc7bb188b4e2d0ec9c7f2dd444fc0 Mon Sep 17 00:00:00 2001 From: Douglas Gilbert Date: Fri, 27 Dec 2019 18:18:48 +0000 Subject: sg_lib: add sg_get_command_str() and sg_print_command_len(); sg_verify+sg_write_same: fix and --ff option; sg_dd+sgh_dd: add --verify support git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@837 6180dd3e-e324-4e3e-922d-17de1ae2f315 --- doc/sg_dd.8 | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) (limited to 'doc/sg_dd.8') diff --git a/doc/sg_dd.8 b/doc/sg_dd.8 index 872c43cf..d8fcd487 100644 --- a/doc/sg_dd.8 +++ b/doc/sg_dd.8 @@ -1,4 +1,4 @@ -.TH SG_DD "8" "February 2019" "sg3_utils\-1.45" SG3_UTILS +.TH SG_DD "8" "December 2019" "sg3_utils\-1.45" SG3_UTILS .SH NAME sg_dd \- copy data to and from files and devices, especially SCSI devices @@ -13,6 +13,7 @@ devices [\fIcoe=\fR{0|1|2|3}] [\fIcoe_limit=CL\fR] [\fIdio=\fR{0|1}] [\fIodir=\fR{0|1}] [\fIof2=OFILE2\fR] [\fIretries=RETR\fR] [\fIsync=\fR{0|1}] [\fItime=\fR{0|1}] [\fIverbose=VERB\fR] [\fI\-\-dry\-run\fR] [\fI\-V\fR] +[\fI\-\-verify\fR] .SH DESCRIPTION .\" Add any additional description here .PP @@ -28,6 +29,15 @@ The first group in the synopsis above are "standard" Unix operands. The second group are extra options added by this utility. Both groups are defined below. .PP +When the \fI\-\-verify\fR option is given, then the read side is the +same but the on the write side, the WRITE SCSI command is replaced by +the VERIFY SCSI command. If any VERIFY commands yields a sense key of +MISCOMPARE then the verify operation will stop. The \fI\-\-verify\fR +option can only be used when \fIOFILE\fR is either a sg device or +a block device with oflag=sgio also given. When the \fI\-\-verify\fR +option is used, this utility works in a similar fashion to the Unix +cmp(1) command. +.PP This utility is only supported on Linux whereas most other utilities in the sg3_utils package have been ported to other operating systems. A utility called "ddpt" has similar syntax and functionality to sg_dd. ddpt drops some @@ -208,6 +218,12 @@ outputs usage message and exits. when used once, this is equivalent to \fIverbose=1\fR. When used twice (e.g. "\-vv") this is equivalent to \fIverbose=2\fR, etc. .TP +\fB\-x\fR, \fB\-\-verify\fR +do a verify operation (like Unix command cmp(1)) rather than a copy. +Cannot be used with "oflag=sparse". \fIof=OFILE\fR must be given and +\fIOFILE\fR must be an sg device or a block device with "oflag=sgio" +alsoe given. +.TP \fB\-V\fR, \fB\-\-version\fR outputs version number information and exits. .SH CONVERSIONS @@ -496,6 +512,8 @@ Copyright \(co 2000\-2019 Douglas Gilbert This software is distributed under the GPL version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. .SH "SEE ALSO" +cmp(1) +.PP There is a web page discussing sg_dd at http://sg.danny.cz/sg/sg_dd.html .PP A POSIX threads version of this utility called -- cgit v1.2.3