path: root/sg_luns.8

.TH SG_LUNS "8" "June 2006" "sg3_utils-1.21" SG3_UTILS
.SH NAME
sg_luns \- send the scsi command report luns
.SH SYNOPSIS
.B sg_luns
[\fI--decode\fR] [\fI--help\fR] [\fI--select=<n>\fR] [\fI--verbose\fR]
[\fI--version\fR] \fI<scsi_device>\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Send REPORT LUNS command to a Linux SCSI device and output the response.
In the recent SCSI draft standard SPC-3 device support for this command
is mandatory.
.TP
--decode | -d
decode logical unit numbers into their hierarchical parts. Interprets
luns as described in SAM-3 (rev 14) when the HiSup bit is set in a
standard INQUIRY's response.
.TP
--help | -h
output the usage message then exit.
.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
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. 
.TP
--verbose | -v
increase the level of verbosity, (i.e. debug output).
.TP
--version | -V
print the version string and then exit.
.SH EXIT STATUS
The exit status of sg_luns is 0 when it is successful. Otherwise see
the sg3_utils(8) man page.
.SH AUTHORS
Written by Douglas Gilbert.
.SH "REPORTING BUGS"
Report bugs to <dgilbert at interlog dot com>.
.SH COPYRIGHT
Copyright \(co 2004-2006 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.
.SH "SEE ALSO"
.B sg_inq(sg3_utils)