more spc4r18 sync, start sbc3r18 sync (sg_format and sg_readcap); change interface of sg_ll_format_unit() removing rto_req argument

git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@221 6180dd3e-e324-4e3e-922d-17de1ae2f315

1 files changed, 10 insertions, 8 deletions

diff --git a/doc/sg_readcap.8 b/doc/sg_readcap.8
index e5eabcae..67fa1db3 100644
--- a/doc/sg_readcap.8
+++ b/doc/sg_readcap.8
@@ -1,4 +1,4 @@
-.TH SG_READCAP "8" "January 2007" "sg3_utils\-1.23" SG3_UTILS
+.TH SG_READCAP "8" "February 2009" "sg3_utils\-1.27" SG3_UTILS
 .SH NAME
 sg_readcap \- sends a SCSI READ CAPACITY command
 .SH SYNOPSIS
@@ -22,6 +22,14 @@ blocks is thus one plus the block address of the last block (as blocks
 are counted origin zero (i.e. starting at block zero)). This is the source
 of many "off by one" errors.
 .PP
+The READ CAPACITY(16) response shows additional information not found in the
+READ CAPACITY(10) response. This includes protection and thin provisioning
+information, plus the number of logical blocks per physical block. So even
+though the media size may not exceed what READ CAPACITY(10) can show, it may
+still be useful to examine the response to READ CAPACITY(16). Sadly there
+are horrible SCSI command set implementations in the wild that crash when
+the READ CAPACITY(16) command is sent to them.
+.PP
 Device capacity is the product of the number of blocks by the block size.
 This utility outputs this figure in bytes, MiB (1048576 bytes per MiB)
 and GB (1000000000 bytes per GB).
@@ -84,12 +92,6 @@ number of blocks in the response is reported as
 0xffffffff (i.e. (2**32 \- 1) ) and the \fI\-\-hex\fR option has not been
 given, then READ CAPACITY (16) is called and its response is output.
 .PP
-The read capacity(16) response shows additional information not found
-in the read capacity(10) response. This includes protection information
-and the number of logical blocks per physical block. So even though
-the media size may not exceed what READ CAPACITY(10) can show, it may
-still be useful to examine the response to READ CAPACITY(16).
-.PP
 In the 2.4 series of Linux kernels the \fIDEVICE\fR must be a SCSI
 generic (sg) device. In the 2.6 series block devices (e.g. SCSI disks
 and DVD drives) can also be specified. For example "sg_readcap /dev/sda"
@@ -149,7 +151,7 @@ outputs version string then exits.
 .SH AUTHORS
 Written by Douglas Gilbert
 .SH COPYRIGHT
-Copyright \(co 1999\-2007 Douglas Gilbert
+Copyright \(co 1999\-2009 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.