diff options
Diffstat (limited to 'doc/sg_scan.8.win32')
-rw-r--r-- | doc/sg_scan.8.win32 | 170 |
1 files changed, 170 insertions, 0 deletions
diff --git a/doc/sg_scan.8.win32 b/doc/sg_scan.8.win32 new file mode 100644 index 00000000..32b99b26 --- /dev/null +++ b/doc/sg_scan.8.win32 @@ -0,0 +1,170 @@ +.TH SG_SCAN "8" "November 2018" "sg3_utils\-1.45" SG3_UTILS +.SH NAME +sg_scan \- scan storage devices and map to volume names +.SH SYNOPSIS +.B sg_scan +[\fI\-\-bus\fR] [\fI\-\-help\fR] [\fI\-\-letter=VL\fR] [\fI\-\-scsi\fR] +[\fI\-\-verbose\fR] [\fI\-\-version\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +This utility scans for physical drives (a.k.a. "hard drives"), cd/dvd drives +and tape drives and maps them to the corresponding volumes. There may be +many, one or no corresponding volumes. There is one line output per device +with identification strings to the right. Its purpose is to list the +storage device names that can be used by other utilities in this package. +.PP +In later versions of Windows this utility may need to be "run as +Administrator" for disks and other devices to be seen. If not those devices +will simply not appear as calls to query them fail with access permission +problems. +.PP +There is an optional SCSI adapter scan which may find additional storage +devices other than the ones listed above. An example is a SCSI Enclosure +Services (SES) device typically found in disk arrays. +.PP +Storage and related devices can have several device names in Windows. +Probably the most common in the volume name (e.g. "D:"). There is also +a "class" device name, and this utility scans for three of +them: "PhysicalDrive<n>", "CDROM<n>" and "TAPE<n>". <n> is an integer +starting at 0 allocated in ascending order as devices are discovered (and +sometimes rediscovered). +.PP +Some storage devices have a SCSI lower level device name which starts +with a SCSI (pseudo) adapter name of the form "SCSI<n>:". To this is added +sub\-addressing in the form of a "bus" number, a "target" identifier and +a LUN (Logical Unit Number). The "bus" number is also known as a "PathId". +These components are combined by the utility to make a device name of the +form: "SCSI<n>:<bus>,<target>,<lun>". This utility allows the +trailing ",<lun>" to be omitted in which case a LUN of zero is assumed. This +lower level device name cannot often be used directly since Windows blocks +attempts to use it if a class driver has "claimed" the device. There are +SCSI device types (e.g. Automation/Drive interface type) for which there is +no class driver. At least two transports ("bus types" in Windows jargin): +USB and IEEE 1394 do not have a "scsi" device names of this form. +.PP +In keeping with DOS file system conventions, the various device names +can be given in upper, lower or mixed case. Since "PhysicalDrive<n>" is +tedious to write, a shortened form of "PD<n>" is permitted by all +utilities in this package. +.PP +A single device (e.g. a disk) can have many device names! For +example: "PDO" can also be "C:", "D:" and "SCSI0:0,1,0". The two volume names +reflect that the disk has two partitions on it. Disk partitions that are +not recognised by Windows are not usually given a volume name. However +Vista does show a volume name for a disk which has no partitions recognised +by it and when selected invites the user to format it (which is rather +unfriendly to other OSes). +.PP +The scanning logic and output of this command changed significantly in +sg3_utils version 1.27 . The SCSI adapter based scanned is now an +optional extra. +.PP +For more information see the NOTES section below. +.SH OPTIONS +Arguments to long options are mandatory for short options as well. +.TP +\fB\-b\fR, \fB\-\-bus\fR +show the bus type (or transport) by which the device is attached to the +operating systems. Two or more transports may be involved. For example, +a SATA disk may be in the external enclosure connected to the computer via +USB in which case the bus type is USB. +.TP +\fB\-h\fR, \fB\-\-help\fR +outputs the usage message summarizing command line options +then exits. +.TP +\fB\-l\fR, \fB\-\-letter\fR=\fIVL\fR +normally a device that has multiple volume names has up to four listed. If +there are more than that a "+" is added after the fourth. When this option +is given the \fIVL\fR argument is assumed to be a volume name (i.e. 'C' +to 'Z') and if found in the scan, only that volume name appears in the +output. If there are novolume names in the output then \fIVL\fR was not +found. +.TP +\fB\-s\fR, \fB\-\-scsi\fR +do a SCSI adapter based scan after the normal storage device based scan. +There is a blank line between the normal scan and the SCSI adapter based +scan. If this option is given twice then only the SCSI adapter based scan +is done. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +increases the level or verbosity. Can be used multiple times to display +more of the internal data, both in normal and error processing. +.TP +\fB\-V\fR, \fB\-\-version\fR +print out version string +.SH NOTES +This utility does not support Windows 95, 98 and ME (and earlier Windows +operating systems). The target Windows operating systems are currently +Windows 2000, 2003, XP and Vista (and their variants). +.PP +When the \fI\-\-scsi\fR option is given the SCSI adapter tuple is followed +by a list of two or three fields. First is "claimed=0|1" indicating whether +a class driver has claimed the device. The next field is "pdt=<num>" +where <num> is the "peripheral device type" as defined in the SCSI INQUIRY +command (see SPC\-4 at https://www.t10.org). The <num> has a trailing "h" to +indicate that it is hexadecimal. Sometimes a third field with the +word "dubious" appears. This flags that what is supposed to be a SCSI +INQUIRY command response has a badly formed "additional length" field. +Thus the corresponding device is unlikely to be a native SCSI device. +.PP +The DOS device names given the the CreateFile() call all start with +a "\\\\.\\" string. That can be given but if not will be supplied +automatically. +.PP +Scanning devices that are hot unplugged and replugged often can be +problematic, especially with the class device names. Each time a device is +removed and re\-added it gets a larger class device name (e.g. "PD3" +becomes "PD4" leaving "PD3" unused). This utility stops scanning class +devices after it find 8 consecutive "holes". +.SH EXAMPLES +The following examples are from a laptop with an internal drive (SATA), a +CD/DVD drive and a USB attached SATA disk. The latter disk has two volumes +recognised by Windows. +.PP + # sg_scan +.br +PD0 [C] FUJITSU MHY2160BH 0000 +.br +PD1 [DF] WD 2500BEV External 1.05 WD\-WXE90 +.br +CDROM0 [E] MATSHITA DVD/CDRW UJDA775 CB03 +.PP +Now request bus types as well. BTW That is a SATA disk holding volume C: +and there is a "Sata" bus type. +.PP + # sg_scan \-b +.br +PD0 [C] <Ata > FUJITSU MHY2160BH 0000 +.br +PD1 [DF] <Usb > WD 2500BEV External 1.05 WD\-WXE90 +.br +CDROM0 [E] <Atapi> MATSHITA DVD/CDRW UJDA775 CB03 +.PP +Now request a SCSI adapter scan as well. +.PP + # sg_scan \-b \-s +.br +PD0 [C] <Ata > FUJITSU MHY2160BH 0000 +.br +PD1 [DF] <Usb > WD 2500BEV External 1.05 WD\-WXE90 +.br +CDROM0 [E] <Atapi> MATSHITA DVD/CDRW UJDA775 CB03 +.br + +.br +SCSI0:0,0,0 claimed=1 pdt=0h FUJITSU MHY2160BH 0000 +.br +SCSI1:0,0,0 claimed=1 pdt=5h MATSHITA DVD/CDRW UJDA775 CB03 +.PP +.SH EXIT STATUS +The exit status of sg_scan is 0 when it is successful. Otherwise see +the sg3_utils(8) man page. +.SH AUTHORS +Written by D. Gilbert +.SH COPYRIGHT +Copyright \(co 2006\-2018 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. |