From e168d3764b642fd96aac1c65f83a64af994ee111 Mon Sep 17 00:00:00 2001 From: Douglas Gilbert Date: Wed, 16 Jan 2019 22:12:55 +0000 Subject: more sg_tst_bidi.c work git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@807 6180dd3e-e324-4e3e-922d-17de1ae2f315 --- doc/sg_format.8 | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) (limited to 'doc/sg_format.8') diff --git a/doc/sg_format.8 b/doc/sg_format.8 index 82a62c2b..c1b4f9d9 100644 --- a/doc/sg_format.8 +++ b/doc/sg_format.8 @@ -1,4 +1,4 @@ -.TH SG_FORMAT "8" "December 2018" "sg3_utils\-1.45" SG3_UTILS +.TH SG_FORMAT "8" "January 2019" "sg3_utils\-1.45" SG3_UTILS .SH NAME sg_format \- format, resize a SCSI disk or format a tape .SH SYNOPSIS @@ -145,7 +145,7 @@ UNIT cdb. The field was introduced in SBC\-4 revision 10. The default value is 0 which implies the former action which is typically to overwrite all blocks on the \fIDEVICE\fR. That can take a long time (e.g. with hard disks over 10 TB in size that can be days). With \fIFFMT\fR set that time may be -reduced to minutes. So it is worth trying if it is available. +reduced to minutes or less. So it is worth trying if it is available. .br \fIFFMT\fR has values 1 and 2 for fast format with 3 being reserved currently. These two values include this description: "The device server @@ -156,7 +156,7 @@ data has been written to, after the fast format. When \fIFFMT\fR is 1 the read operation should return "unspecified logical block data" and complete without error. When \fIFFMT\fR is 2 the read operation may yield check condition status with a sense key set to hardware error, medium error or -command aborted. See SBC\-4 revision 15 section 4.35 for more details. +command aborted. See draft SBC\-4 revision 16 section 4.34 for more details. .TP \fB\-f\fR, \fB\-\-fmtpinfo\fR=\fIFPI\fR sets the FMTPINFO field in the FORMAT UNIT cdb to a value between 0 and 3. @@ -333,6 +333,10 @@ given then the "IMMED" bit is not set. If \fI\-\-wait\fR is given then the FORMAT UNIT or FORMAT MEDIUM command waits until the format operation completes before returning its response. This can be many hours on large disks. See the \fI\-\-timeout=SECS\fR option. +.br +Alternatively this option may be useful when used together with +\fI\-\-ffmt=FFMT\fR (and \fIFFMT\fR greater than 0) since the fast format +may only be a matter of seconds. .SH LISTS The SBC\-3 draft (revision 20) defines PLIST, CLIST, DLIST and GLIST in section 4.10 on "Medium defects". Briefly, the PLIST is the "primary" @@ -376,8 +380,8 @@ introduced in the SBC\-2 standard. SBC\-3 defines 4 protection types (types 0 to 3) with protection type 0 meaning no PI is maintained. While a device may support one or more protection types, it can only be formatted with 1 of the 4. To change a device's protection type, it must be re\-formatted. -For more information see the Protection Information in section 4.22 of -draft SBC\-4 revision 15. +For more information see the Protection Information in section 4.21 of +draft SBC\-4 revision 16. .PP A device that supports PI information (i.e. supports one or more protection types 1, 2 and 3) sets the "PROTECT" bit in its standard INQUIRY response. It @@ -634,6 +638,9 @@ backed up. Now /dev/sdd should have 512 byte logical block size. And to switch it back: .PP # sg_format \-\-format \-\-ffmt=1 \-\-size=4096 /dev/sdd +.PP +Since fast formats can be very quick (a matter of seconds) using the +\-\-wait option may be appropriate .SH EXIT STATUS The exit status of sg_format is 0 when it is successful. Otherwise see the sg3_utils(8) man page. Unless the \fI\-\-wait\fR option is given, the @@ -644,7 +651,7 @@ Written by Grant Grundler, James Bottomley and Douglas Gilbert. .SH "REPORTING BUGS" Report bugs to . .SH COPYRIGHT -Copyright \(co 2005\-2018 Grant Grundler, James Bottomley and Douglas Gilbert +Copyright \(co 2005\-2019 Grant Grundler, James Bottomley and 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. -- cgit v1.2.3