aboutsummaryrefslogtreecommitdiff
path: root/doc/sg_luns.8
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2014-05-09 13:51:44 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2014-05-09 13:51:44 +0000
commit7c5eb1f951e4349bef24fe9056fdc6c190217d95 (patch)
tree439d5ed60b9b7bb123c5c9a1fec6a21417476414 /doc/sg_luns.8
parent7a8a2dc95dec418172e43bdf46c89914f7020219 (diff)
downloadsg3_utils-7c5eb1f951e4349bef24fe9056fdc6c190217d95.tar.gz
sg_ses, sg_persist, sg_logs, sg_readcap, sg_read_buffer, sg_luns: add --readonly option; SG_PERSIST_O_RDONLY ev
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@573 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc/sg_luns.8')
-rw-r--r--doc/sg_luns.823
1 files changed, 18 insertions, 5 deletions
diff --git a/doc/sg_luns.8 b/doc/sg_luns.8
index 43ce5f3f..529b38a0 100644
--- a/doc/sg_luns.8
+++ b/doc/sg_luns.8
@@ -1,10 +1,10 @@
-.TH SG_LUNS "8" "March" "sg3_utils\-1.38" SG3_UTILS
+.TH SG_LUNS "8" "May" "sg3_utils\-1.39" SG3_UTILS
.SH NAME
sg_luns \- send SCSI REPORT LUNS command or decode given LUN
.SH SYNOPSIS
.B sg_luns
[\fI\-\-decode\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-linux\fR]
-[\fI\-\-maxlen=LEN\fR] [\fI\-\-quiet\fR] [\fI\-\-raw\fR]
+[\fI\-\-maxlen=LEN\fR] [\fI\-\-quiet\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR]
[\fI\-\-select=SR\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.PP
.B sg_luns
@@ -65,18 +65,31 @@ before the LUN listing.
\fB\-r\fR, \fB\-\-raw\fR
output the SCSI response (i.e. the data-out buffer) in binary (to stdout).
.TP
+\fB\-R\fR, \fB\-\-readonly\fR
+open the \fIDEVICE\fR read\-only (e.g. in Unix with the O_RDONLY flag).
+The default is to open it read\-write.
+.TP
\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. For detailed information see the
+LUNS command. The default value is 0. Hexadecimal values may be given with
+a leading "0x" or a trailing "h". For detailed information see the
REPORT LUNS command in SPC (most recent is SPC\-4 revision 36s in section
6.33). To simplify, for the I_T nexus associated with the \fIDEVICE\fR, the
meanings of the \fISR\fR values defined to date for SPC\-4 are:
.br
- \fB0\fR : all LUNs excluding well known logical units
+ \fB0\fR : most LUs excluding well known logical units
.br
\fB1\fR : well known logical units
.br
- \fB2\fR : all LUNs
+ \fB2\fR : all LUs accessible to this I_T nexus
+.br
+ \fB0x10\fR : only accessible administrative LUs
+.br
+ \fB0x11\fR : administrative LUs and associated LUs (see SPC\-4)
+.br
+ \fB0x12\fR : if the addressed LU is administrative, then reports its
+.br
+ subsidiary LUs
.br
Values between 0xf8 and 0xff (inclusive) are vendor specific (SPC\-4 rev
36e), other values greater than 2 are reserved. This utility will accept