mainly doco tweaks; Rebuild Assist diagnostic page noted
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@465 6180dd3e-e324-4e3e-922d-17de1ae2f315
diff --git a/doc/sg_write_same.8 b/doc/sg_write_same.8
index 22eb168..adaa3b2 100644
--- a/doc/sg_write_same.8
+++ b/doc/sg_write_same.8
@@ -1,4 +1,4 @@
-.TH SG_WRITE_SAME "8" "November 2011" "sg3_utils\-1.33" SG3_UTILS
+.TH SG_WRITE_SAME "8" "November 2012" "sg3_utils\-1.35" SG3_UTILS
.SH NAME
sg_write_same \- send the SCSI WRITE SAME command
.SH SYNOPSIS
@@ -189,6 +189,12 @@
Various numeric arguments (e.g. \fILBA\fR) may include multiplicative
suffixes or be given in hexadecimal. See the "NUMERIC ARGUMENTS" section
in the sg3_utils(8) man page.
+.PP
+In Linux at this time the sg driver does not support cdb sizes greater than
+16 bytes. Hence a device node like /dev/sg1 which is associated with the
+sg driver will fail with this utility if the \fI\-\-32\fR option is
+given (or implied by other options). The bsg driver with device nodes like
+/dev/bsg/6:0:0:1 does support cdb sizes greater than 16 bytes.
.SH EXIT STATUS
The exit status of sg_write_same is 0 when it is successful. Otherwise see
the sg3_utils(8) man page.
@@ -280,7 +286,7 @@
.SH "REPORTING BUGS"
Report bugs to <dgilbert at interlog dot com>.
.SH COPYRIGHT
-Copyright \(co 2009\-2011 Douglas Gilbert
+Copyright \(co 2009\-2012 Douglas Gilbert
.br
This software is distributed under a FreeBSD license. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
diff --git a/doc/sg_xcopy.8 b/doc/sg_xcopy.8
index 40b55ed..541e6cd 100644
--- a/doc/sg_xcopy.8
+++ b/doc/sg_xcopy.8
@@ -1,4 +1,4 @@
-.TH SG_XCOPY "8" "September 2012" "sg3_utils\-1.34" SG3_UTILS
+.TH SG_XCOPY "8" "November 2012" "sg3_utils\-1.35" SG3_UTILS
.SH NAME
sg_xcopy \- copies data to and from files and devices. Specialised for
devices that support the SCSI EXTENDED COPY command.
@@ -232,6 +232,13 @@
.PP
Currently only block-to-block transfers are implemented; \fIIFILE\fR
and \fIOFILE\fR must refer to a SCSI block device.
+PP
+No account is taken of partitions so, for example, /dev/sbc2, /dev/sdc,
+/dev/sg2, and /dev/bsg/3:0:0:1 would all refer to the same thing: the
+whole logical unit (i.e. the whole disk) starting at LBA 0. So any
+partition indication (e.g. /dev/sdc2) is ignored. The user should set
+\fISKIP\fR, \fISEEK\fR and \fICOUNT\fR with information obtained
+from a command like 'fdisk -l -u /dev/sdc' to account for partitions.
.SH EXAMPLES
Copy 2M of data from the start of one device to another:
.PP
