aboutsummaryrefslogtreecommitdiff
path: root/sg_luns.8
diff options
context:
space:
mode:
Diffstat (limited to 'sg_luns.8')
-rw-r--r--sg_luns.850
1 files changed, 26 insertions, 24 deletions
diff --git a/sg_luns.8 b/sg_luns.8
index 4236b8d7..230b4d52 100644
--- a/sg_luns.8
+++ b/sg_luns.8
@@ -1,46 +1,48 @@
-.TH SG_LUNS "8" "October 2006" "sg3_utils-1.22" SG3_UTILS
+.TH SG_LUNS "8" "January 2007" "sg3_utils\-1.23" SG3_UTILS
.SH NAME
-sg_luns \- send the scsi command report luns
+sg_luns \- send the SCSI REPORT LUNS command
.SH SYNOPSIS
.B sg_luns
-[\fI--decode\fR] [\fI--help\fR] [\fI--hex\fR] [\fI--raw\fR]
-[\fI--select=<n>\fR] [\fI--verbose\fR] [\fI--version\fR]
-\fI<scsi_device>\fR
+[\fI\-\-decode\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-raw\fR]
+[\fI\-\-select=SR\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR]
+\fIDEVICE\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
-Send REPORT LUNS command to a SCSI device and output the response.
-In the SPC-3 SCSI standard support for this command is mandatory.
+Send the SCSI REPORT LUNS command to the \fIDEVICE\fR and outputs the
+response. In the SPC\-3 SCSI standard support for this command is mandatory.
+.SH OPTIONS
+Arguments to long options are mandatory for short options as well.
.TP
---decode | -d
+\fB\-d\fR, \fB\-\-decode\fR
decode logical unit numbers into their hierarchical parts. Interprets
-luns as described in SAM-3 when the HiSup bit is set in a
+luns as described in SAM\-3 when the HiSup bit is set in a
standard INQUIRY's response.
.TP
---help | -h
+\fB\-h\fR, \fB\-\-help\fR
output the usage message then exit.
.TP
---hex | -H
+\fB\-H\fR, \fB\-\-hex\fR
output response to this command in ASCII hex.
.TP
---raw | -r
+\fB\-r\fR, \fB\-\-raw\fR
output response in binary (to stdout).
.TP
---select=<n> | -s <n>
-this option sets the 'select report' field in the SCSI REPORT LUNS command.
-The default value is 0. When 0 is given (or this option is not specified)
-then the given device should yield a list of luns addressable via
-this "I_T nexus" that use the following lun addressing methods: logical
+\fB\-s\fR, \fB\-\-select\fR=\fISR\fR
+this option sets the 'select report' field (\fISR\fR) in the SCSI REPORT
+LUNS command. The default value is 0. When 0 is given (or this option is
+not specified) then the \fIDEVICE\fR should yield a list of luns addressable
+via this "I_T nexus" that use the following lun addressing methods: logical
unit addressing, peripheral device addressing and flat space addressing.
-When 1 is given the given device should yield a list of only "well known"
-logical units addressable via this "I_T" nexus. When 2 is given the given
-device should yield all luns addressable via this "I_T" nexus. Currently
-SPC-3 (rev 21) doesn't specify any other values.
+When 1 is given the \fIDEVICE\fR should yield a list of only "well known"
+logical units addressable via this "I_T" nexus. When 2 is given the
+\fIDEVICE\fR should yield all luns addressable via this "I_T" nexus.
+Currently SPC\-3 (rev 23) doesn't specify any other values.
.TP
---verbose | -v
+\fB\-v\fR, \fB\-\-verbose\fR
increase the level of verbosity, (i.e. debug output).
.TP
---version | -V
+\fB\-V\fR, \fB\-\-version\fR
print the version string and then exit.
.SH EXIT STATUS
The exit status of sg_luns is 0 when it is successful. Otherwise see
@@ -50,7 +52,7 @@ Written by Douglas Gilbert.
.SH "REPORTING BUGS"
Report bugs to <dgilbert at interlog dot com>.
.SH COPYRIGHT
-Copyright \(co 2004-2006 Douglas Gilbert
+Copyright \(co 2004\-2007 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.