aboutsummaryrefslogtreecommitdiff
path: root/doc/sg_format.8
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2018-09-11 23:13:21 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2018-09-11 23:13:21 +0000
commit23b8f9c3a44e6be249911b97c4cf02da601be519 (patch)
treed475856169c8a08001e1f8813408ed71bdc14197 /doc/sg_format.8
parent38a3773e8ef84bd18fcf266df4e697e431c73882 (diff)
downloadsg3_utils-23b8f9c3a44e6be249911b97c4cf02da601be519.tar.gz
sg_vpd: decode some WDC/Hitachi vendor VPD pages; sg_modes: accept acronym for page/subpage codes; attempted 1.43 release
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@789 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc/sg_format.8')
-rw-r--r--doc/sg_format.817
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/sg_format.8 b/doc/sg_format.8
index f25a2283..d1d3fdef 100644
--- a/doc/sg_format.8
+++ b/doc/sg_format.8
@@ -1,4 +1,4 @@
-.TH SG_FORMAT "8" "August 2018" "sg3_utils\-1.43" SG3_UTILS
+.TH SG_FORMAT "8" "September 2018" "sg3_utils\-1.43" SG3_UTILS
.SH NAME
sg_format \- format, resize a SCSI disk or format a tape
.SH SYNOPSIS
@@ -406,6 +406,15 @@ default value of \fIPFU\fR (in \fI\-\-pfu=PFU\fR) is 0. So if neither
\fI\-\-fmtpinfo=FPI\fR nor \fI\-\-pfu=PFU\fR are given then protection
type 0 (i.e. no protection information) is chosen.
.SH NOTES
+After a format that changes the logical block size or the number of logical
+blocks on a disk, the operating system may need to be told to re\-initialize
+its setting for that disk. In Linux that can be done with:
+.br
+ echo 1 > /sys/block/sd{letter(s)}/device/rescan
+.br
+where "letter(s)" will be between 'a' and 'zzz'. The lsscsi utility in Linux
+can be used to check the various namings of a disk.
+.PP
The SBC\-2 standard states that the REQUEST SENSE command should be used
for obtaining progress indication when the format command is underway.
However, tests on a selection of disks shows that TEST UNIT READY
@@ -614,11 +623,11 @@ quickly switch between 512 and 4096 byte logical block size. Assume disk
starts with 4096 byte logical block size and all important data has been
backed up.
.PP
- # sg_format \-\-format \-\-ffmt=1 \-\-size=512 \-\-count=\-1 /dev/sdd
+ # sg_format \-\-format \-\-ffmt=1 \-\-size=512 /dev/sdd
.PP
Now /dev/sdd should have 512 byte logical block size. And to switch it back:
.PP
- # sg_format \-\-format \-\-ffmt=1 \-\-size=4096 \-\-count=\-1 /dev/sdd
+ # sg_format \-\-format \-\-ffmt=1 \-\-size=4096 /dev/sdd
.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
@@ -637,4 +646,4 @@ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.B sg_turs(8), sg_requests(8), sg_inq(8), sg_modes(8), sg_vpd(8),
.B sg_reassign(8), sg_readcap(8), sg3_utils(8),
.B sg_sanitize(8) [all in sg3_utils],
-.B mt(mt\-st), sdparm(8), scsiformat (old), hdparm(8)
+.B lsscsi(8), mt(mt\-st), sdparm(8), scsiformat (old), hdparm(8)