aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2021-12-31 19:02:04 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2021-12-31 19:02:04 +0000
commita4e181c479918a5697a1826960265706049dd929 (patch)
treec2b81963f724c052d7e8bb6b5813f975fccbf289 /doc
parenta80fb97517110b355fe16a190328699d6bd9ca17 (diff)
downloadsg3_utils-a4e181c479918a5697a1826960265706049dd929.tar.gz
sg_logs: further tweak -lll to cope with missing [0,0xff] 'supported ... subpages' page
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@928 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc')
-rw-r--r--doc/sg_logs.822
-rw-r--r--doc/sg_zone.84
2 files changed, 14 insertions, 12 deletions
diff --git a/doc/sg_logs.8 b/doc/sg_logs.8
index 8bafa3ac..a81b78e8 100644
--- a/doc/sg_logs.8
+++ b/doc/sg_logs.8
@@ -57,7 +57,7 @@ maintained for backward compatibility.
.PP
When no options are given, just a \fIDEVICE\fR, that is equivalent to calling
this utility with the \fI\-\-list\fR option. In that case the names of the
-supported log pages (and not any subpages) are listed out.
+supported log pages (but not subpages) are listed out.
.SH OPTIONS
Arguments to long options are mandatory for short options as well.
The options are arranged in alphabetical order based on the long
@@ -173,10 +173,12 @@ done by reading the "supported log pages" log page. When used once only
log pages, but not subpages, are listed. When used twice the "supported
log pages and subpages" log page is output. Some vendors do not list some
log pages (e.g. those without any subpages) in the "supported log pages
-and subpages" log page. To get a full overview, this option can be used
+and subpages" log page. To get a full inventory, this option can be used
three times (e.g. '\-lll') and the output of the two log pages is merged.
-In the absence of other options, the page/subpage names, but not their
-contents, are shown when this option is given.
+Even if the "supported log pages and subpages" log page is not supported
+using this option three times will yield a list from the "supported log
+pages" log page. In the absence of other options, the page/subpage names,
+but not their contents, are shown when this option is given.
.br
The '\-lll' form may be useful with the \fI\-\-All\fR option to show the
contents of all pages referred to in either the "supported log page" or
@@ -289,8 +291,8 @@ this instructs the device to store the current log page parameters (as
indicated by the DS and TSD parameter codes) in some non\-volatile location.
Hence the log parameters will be preserved across power cycles. This option
is typically not needed, especially if the GLTSD flag is clear in the
-control mode page as this instructs the device to periodically save all
-saveable log parameters to non\-volatile locations.
+control mode page which causes the \fIDEVICE\fR to periodically save all
+saveable log parameters to non\-volatile storage.
.TP
\fB\-t\fR, \fB\-\-temperature\fR
outputs the temperature. First looks in the temperature log page and if
@@ -394,11 +396,11 @@ Options with arguments or with two or more letters can have an extra '\-'
prepended. For example: both '\-pcb' and '\-\-pcb' are acceptable.
.TP
\fB\-a\fR
-outputs all the log pages supported by the device.
+outputs all the log pages supported by the \fIDEVICE\fR.
Equivalent to \fI\-\-all\fR in the main description.
.TP
\fB\-A\fR
-outputs all the log pages and subpages supported by the device.
+outputs all the log pages and subpages supported by the \fIDEVICE\fR.
Equivalent to '\-\-all \-\-all' in the main description.
.TP
\fB\-c\fR=\fIPC\fR
@@ -422,12 +424,12 @@ same action as '\-h' in this section and equivalent to \fI\-\-hex\fR in
the main description.
.TP
\fB\-l\fR
-lists the names of all logs sense pages supported by this device.
+lists the names of all logs sense pages supported by this \fIDEVICE\fR.
Equivalent to \fI\-\-list\fR in the main description.
.TP
\fB\-L\fR
lists the names of all logs sense pages and subpages supported by this
-device. Equivalent to '\-\-list \-\-list' in the main description.
+\fIDEVICE\fR. Equivalent to '\-\-list \-\-list' in the main description.
.TP
\fB\-m\fR=\fILEN\fR
request only \fILEN\fR bytes of response data. Default is 0 which is
diff --git a/doc/sg_zone.8 b/doc/sg_zone.8
index cf35c16c..53cf7cfe 100644
--- a/doc/sg_zone.8
+++ b/doc/sg_zone.8
@@ -1,4 +1,4 @@
-.TH SG_ZONE "8" "November 2021" "sg3_utils\-1.48" SG3_UTILS
+.TH SG_ZONE "8" "December 2021" "sg3_utils\-1.48" SG3_UTILS
.SH NAME
sg_zone \- send a SCSI ZONE modifying command
.SH SYNOPSIS
@@ -12,7 +12,7 @@ sg_zone \- send a SCSI ZONE modifying command
.PP
Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE, REMOVE ELEMENT AND MODIFY
ZONES or SEQUENTIALIZE ZONE command to the \fIDEVICE\fR. All but the last
-two are found in the ZBC standard (INCITS 536-\2016). The REMOVE ELEMENT AND
+two are found in the ZBC standard (INCITS 536\-2016). The REMOVE ELEMENT AND
MODIFY ZONES command was added in zbc2r07 while the SEQUENTIALIZE ZONE command
was added in zbc2r01b.
.PP