Lines Matching +full:- +full:- +full:verify

1 .TH SG_VERIFY "8" "December 2019" "sg3_utils\-1.45" SG3_UTILS
3 sg_verify \- invoke SCSI VERIFY command(s) on a block device
6 [\fI\-\-0\fR] [\fI\-\-16\fR] [\fI\-\-bpc=BPC\fR] [\fI\-\-count=COUNT\fR]
7 [\fI\-\-dpo\fR] [\fI\-\-ff\fR] [\fI\-\-ebytchk=BCH\fR] [\fI\-\-group=GN\fR]
8 [\fI\-\-help\fR] [\fI\-\-in=IF\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-ndo=NDO\fR]
9 [\fI\-\-quiet\fR] [\fI\-\-readonly\fR] [\fI\-\-verbose\fR]
10 [\fI\-\-version\fR] [\fI\-\-vrprotect=VRP\fR] \fIDEVICE\fR
14 Sends one or more SCSI VERIFY (10 or 16) commands to \fIDEVICE\fR. These SCSI
15 commands are defined in the SBC\-2 and SBC\-3 standards at https://www.t10.org
16 and SBC\-4 drafts.
18 When \fI\-\-ndo=NDO\fR is not given then the verify starts at the logical
19 block address given by the \fI\-\-lba=LBA\fR option and continues for
20 \fI\-\-count=COUNT\fR blocks. No more than \fI\-\-bpc=BPC\fR blocks are
21 verified by each VERIFY command so if necessary multiple VERIFY commands are
24 block contents). No news is good news (i.e. if there are no verify errors
27 When \fI\-\-ndo=NDO\fR is given then the \fI\-\-bpc=BPC\fR option is
28 ignored. A single VERIFY command is issued and a comparison starts at the
29 logical block address given by the \fI\-\-lba=LBA\fR option and continues for
30 \fI\-\-count=COUNT\fR blocks. The VERIFY command has an associated data\-out
31 buffer that is \fINDO\fR bytes long. The contents of the data\-out buffer are
32 obtained from the \fIFN\fR file (if \fI\-\-in=FN\fR is given) or from stdin.
33 A comparison takes place between data\-out buffer and the logical blocks
38 sense buffer unless the \fI\-\-quiet\fR option is given.
40 In SBC\-3 revision 34 the BYTCHK field in all SCSI VERIFY commands was
48 \fB\-0\fR, \fB\-\-0\fR
49 a buffer \fINDO\fR bytes long full of zeros is sent as the data\-out
50 part of a VERIFY command. So stdin is not read and if \fI\-\-in=IF\fR
54 \fB\-S\fR, \fB\-\-16\fR
55 uses a VERIFY(16) command (default VERIFY(10)). Even without this option,
56 using an \fI\-\-lba=LBA\fR which is too large, will cause the utility
57 to issue a VERIFY(16) command.
59 \fB\-b\fR, \fB\-\-bpc\fR=\fIBPC\fR
60 this option is ignored if \fI\-\-ndo=NDO\fR is given. Otherwise \fIBPC\fR
62 VERIFY command. The default value is 128 blocks which equates to 64 KB for a
64 multiple SCSI VERIFY commands are sent to the \fIDEVICE\fR. For the default
65 VERIFY(10) \fIBPC\fR cannot exceed 0xffff (65,535) while for VERIFY(16)
70 \fB\-c\fR, \fB\-\-count\fR=\fICOUNT\fR
71 where \fICOUNT\fR specifies the number of blocks to verify. The default value
73 and \fINDO\fR is not given, 0 or less than multiple SCSI VERIFY commands are
75 verification length field of the SCSI VERIFY command issued. The
80 \fB\-d\fR, \fB\-\-dpo\fR
85 \fB\-E\fR, \fB\-\-ebytchk\fR=\fIBCH\fR
87 \fI\-\-ndo=NDO\fR option. Values of 1, 2 or 3 are accepted for \fIBCH\fR
89 \fI\-\-ndo=NDO\fR must also be given. If \fIBCH\fR is 3 then \fINDO\fR
94 \fB\-f\fR, \fB\-\-ff\fR
95 a buffer \fINDO\fR bytes long full of 0xff bytes is sent as the data\-out
96 part of a VERIFY command. So stdin is not read and if \fI\-\-in=IF\fR
100 \fB\-g\fR, \fB\-\-group\fR=\fIGN\fR
102 VERIFY(16) command. It can be from 0 to 63 inclusive. The default value for
103 \fIGN\fR is 0. Note that this option is ignored for the SCSI VERIFY(10)
106 \fB\-h\fR, \fB\-\-help\fR
109 \fB\-i\fR, \fB\-\-in\fR=\fIIF\fR
111 and placed in the data\-out buffer. This is only done when the
112 \fI\-\-ndo=NDO\fR option is given. If this option is not given then stdin
113 is read. If \fIIF\fR is "\-" then stdin is also used.
115 \fB\-l\fR, \fB\-\-lba\fR=\fILBA\fR
117 start the verify operation. \fILBA\fR is assumed to be decimal unless prefixed
121 \fB\-n\fR, \fB\-\-ndo\fR=\fINDO\fR
123 \fI\-\-in=FN\fR is given) or from stdin. Those bytes are placed in the
124 data\-out buffer associated with the SCSI VERIFY command and \fINDO\fR
127 \fI\-\-ebytchk=BCH\fR option is not given then the BYTCHK field in the cdb
130 \fB\-q\fR, \fB\-\-quiet\fR
135 \fB\-r\fR, \fB\-\-readonly\fR
136 opens the DEVICE read\-only rather than read\-write which is the
137 default. The Linux sg driver needs read\-write access for the SCSI
138 VERIFY command but other access methods may require read\-only access.
140 \fB\-v\fR, \fB\-\-verbose\fR
143 \fB\-V\fR, \fB\-\-version\fR
146 \fB\-P\fR, \fB\-\-vrprotect\fR=\fIVRP\fR
147 where \fIVRP\fR is the value in the vrprotect field in the VERIFY command
151 BYTCHK is the name of a field (two bits wide) in the VERIFY(10) and
152 VERIFY(16) commands. When set to 1 or 3 (sbc3r34 reserves the value 2) it
153 indicates that associated with the SCSI VERIFY command, a data\-out buffer
154 will be sent for the device (disk) to check. Using the \fI\-\-ndo=NDO\fR
156 placed in the data\-out buffer. Those bytes are obtained from stdin or
157 \fIIF\fR (from the \fI\-\-in=FN\fR option). The \fI\-\-ebytchk=BCH\fR
172 data\-out (and data\-in) buffer. For Linux at one time the limit was
175 Earlier versions of this utility had a \fI\-\-bytchk=NDO\fR option which
177 The shorter form of that option was \fI\-B NDO\fR. For backward
179 is the \fI\-\-ndo=NDO\fR whose shorter form of \fI\-n NDO\fR.
180 \fI\-\-ndo=NDO\fR sets the BYTCHK field to 1 unless that is overridden by
181 the \fI\-\-ebytchk=BCH\fR.
188 block is considered defective are controlled in part by the Verify Error
189 Recovery mode page. A note in the SBC\-3 draft (rev 29 section 6.4.9 on the
190 Verify Error Recovery mode page) advises that to minimize the number of
191 checks (and hence have the most "sensitive" verify check) do the following
193 the DCR bit to 1, the verify retry count to 0 and the verify recovery time
198 The SCSI VERIFY(6) command defined in the SSC\-2 standard and later (i.e.
213 Copyright \(co 2004\-2019 Douglas Gilbert
215 This software is distributed under a BSD\-2\-Clause license. There is NO