add '--16' option (same as '--long') to sg_readcap, doco

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

1 files changed, 45 insertions, 31 deletions

diff --git a/README.win32 b/README.win32
index 7a9e801f..24d903d9 100644
--- a/README.win32
+++ b/README.win32
@@ -91,38 +91,52 @@ operating system:
 The sg_pt_win32.c file uses the Windows SCSI Pass Through (SPT) mechanism.
 It does not currently use the ASPI32 interface which requires a dll from
 Adaptec. The sg_scan utility is a special version for Windows and it attempts
-to show the various allowable device names, grouping various names for the
-same device on one line. Here is an example of sg_scan's output:
+to show the various available storage device names, one per line. Here is an
+example of sg_scan's output:
 
 # sg_scan
-SCSI0:0,0,0       C:    PD0      IC25N040ATCS05-0        CS4O  *
-SCSI1:0,0,0       D:    CDROM0   HITACHI DVD-ROM GD-S200 0034
-SCSI2:0,0,0       I: +  PD5      QUANTUM LPS525S         3110
-SCSI2:0,6,0             TAPE0    SONY    SDT-7000        0192
-                  E:             Generic USB SD Reader   1.00  pdt=0
-                        PD1      Generic USB SD Reader   1.00
-
-So the following device names all refer to the same (ATA) disk:
-"SCSI0:0,0,0", "C:" and "PD0". Recent version of windows will only allow the
-"SCSI0:0,0,0" to be used if there isn't another device name available.
-The right hand section of each line is the SCSI INQUIRY command response
-strings (which are constructed by Windows is some cases rather than the
-device). The "*" at the end of the first line flags that the INQUIRY
-response is not quite properly structured (according to SCSI-2) which is
-usually indicative of an ATA disk.
-
-If no class driver name (e.g. "PD0", "CDROM0" or "TAPE0") is available
-then the SCSI "peripheral device type" (pdt) is placed at the end of the
-line. Common pdt values are 0 for disks, 1 for tapes and 5 for cd/dvd
-drives. The "+" after the "I:" indicates that other volume names
-(letters) map to that device. This occurs when a disk has two or more
-partitions that windows recognizes. The longer "PhysicalDrive" name,
-shown in Windows documentation, may be used but "PD" is obviously
-quicker to type.
-
-Finally sg_scan does not manage to put all device names for USB and
-IEEE 1394 devices on one line. The last two lines of output are actually
-the same device.
+PD0     [C]     FUJITSU   MHY2160BH         0000
+PD1     [DF]    WD        2500BEV External  1.05  WD-WXE90
+CDROM0  [E]     MATSHITA DVD/CDRW UJDA775  CB03
+
+Here is an example with added bus type:
+
+# sg_scan -b
+PD0     [C]     <Ata  >  FUJITSU   MHY2160BH         0000
+PD1     [DF]    <Usb  >  WD        2500BEV External  1.05  WD-WXE90
+CDROM0  [E]     <Atapi>  MATSHITA DVD/CDRW UJDA775  CB03
+
+Here is an example with added SCSI adapter scan:
+
+# sg_scan -b -s
+PD0     [C]     <Ata  >  ST380011A  8.01
+PD1             <Scsi >  SEAGATE   ST373455SS        2189
+PD2             <Scsi >  ATA       ST3160812AS       D
+PD3             <Scsi >  SEAGATE   ST336754SS        0003
+CDROM0  [F]     <Atapi>  HL-DT-ST DVDRAM GSA-4163B  A103
+TAPE0           <Scsi >  SONY      SDT-7000          0192
+
+SCSI0:0,0,0   claimed=1 pdt=0h dubious  ST380011  A                 8.01
+SCSI1:0,0,0   claimed=1 pdt=5h          HL-DT-ST  DVDRAM GSA-4163B  A103
+SCSI2:0,6,0   claimed=1 pdt=1h          SONY      SDT-7000          0192
+SCSI5:0,17,0  claimed=1 pdt=0h          SEAGATE   ST373455SS        2189
+SCSI5:0,19,0  claimed=1 pdt=0h          ATA       ST3160812AS       D
+SCSI5:0,21,0  claimed=1 pdt=0h          SEAGATE   ST336754SS        0003
+SCSI5:0,112,0 claimed=0 pdt=10h         LSI       PSEUDO DEVICE     2.34
+
+The storage devices scanned are PhysicalDrive<n> (shorted form PD<n> used),
+CDROM<n> (which includes DVD and BD drives) and TAPE<n>. There is also an
+optional SCSI adapter scan with device names of the form SCSI<n>:<b>:<t>:<l> .
+These only come into play for devices that are not claimed by one of the
+storage class drivers. The "LSI PSEUDO DEVICE" device above is an example
+of an unclaimed device. The SCSI adapter scan does not show USB and IEEE
+1394 connected devices.
+
+Volume names (e.g. "C:") that match a storage device (or perhaps a
+partition within that device) are shown in brackets. Notice there can be
+zero, one or more volume names for each storage device. Up to four volume
+names are listed in brackets, if there are more a "+" is added after the
+fourth.
 
 Several utilities have conditional compilation sections based on
 the SG3_UTILS_MINGW define. For those who want to try native C compilers
@@ -149,4 +163,4 @@ mode" with the setmode() Windows command.
 
 
 Doug Gilbert
-11th March 2009
+10th April 2009