summaryrefslogtreecommitdiffstats
path: root/sys-utils/blkzone.8
diff options
context:
space:
mode:
authorDamien Le Moal2017-02-24 04:47:29 +0100
committerKarel Zak2017-02-24 11:53:45 +0100
commita7f742069ec5f1a51d0c9cfc238954553e2ffe8f (patch)
tree9f3398d3fde195219335a8b96e462edc23b583ae /sys-utils/blkzone.8
parentblkzone: Report all zones if length is not specified (diff)
downloadkernel-qcow2-util-linux-a7f742069ec5f1a51d0c9cfc238954553e2ffe8f.tar.gz
kernel-qcow2-util-linux-a7f742069ec5f1a51d0c9cfc238954553e2ffe8f.tar.xz
kernel-qcow2-util-linux-a7f742069ec5f1a51d0c9cfc238954553e2ffe8f.zip
blkzone: Improve zone information print
Add "0x" to the zone start, length and write pointer print to make it always clear that the values are Hexadecimal. Also update the zone condition string and associated comments to match more closely the wording in the standard document. The man page is also updated to match the new wording. Signed-off-by: Damien Le Moal <damien.lemoal@wdc.com>
Diffstat (limited to 'sys-utils/blkzone.8')
-rw-r--r--sys-utils/blkzone.839
1 files changed, 18 insertions, 21 deletions
diff --git a/sys-utils/blkzone.8 b/sys-utils/blkzone.8
index 6394ed274..24b0cc7bd 100644
--- a/sys-utils/blkzone.8
+++ b/sys-utils/blkzone.8
@@ -9,8 +9,8 @@ blkzone \- run zone command on a device
.SH DESCRIPTION
.B blkzone
is used to run zone command on device that support the Zoned Block Commands
-(ZBC) or Zoned-device ATA Commands (ZAC). The zones are addresses by the offset
-and length options.
+(ZBC) or Zoned-device ATA Commands (ZAC). The zones to operate on can be
+specified using the offset and length options.
.PP
The
.I device
@@ -40,15 +40,15 @@ type:Zone type
.TS
tab(:);
left l l.
-Cl:closed
-cv:conventional zone
-e0:empty
-fu:full
-Oe:open explicit
-Oi:open implicit
-OL:offline
-ro:read only
-x?:reserved conditions (should not be reported)
+cl:Closed
+nw:Not write pointer
+em:Empty
+fu:Full
+oe:Explicitly opened
+oi:Implicitly opened
+ol:Offline
+ro:Read only
+x?:Reserved conditions (should not be reported)
.TE
.SS reset
@@ -56,23 +56,20 @@ The command \fBblkzone reset\fP is used to reset one or more zones. Unlike
.BR sg_reset_wp (8) ,
this command operates from the block layer and can reset a range of zones.
.PP
-By default, the command will operate on the zone at device logical
-sector 0. Options may be used to modify this behavior as well as specify the
-operation to be performed on the zone, as explained below.
+By default, the command will operate from the zone at device logical
+sector 0 and reset all zones. Options may be used to modify this behavior
+as well as specify the operation to be performed on the zone, as explained below.
.PP
-The default number of zones (options \fB\-\-length\fP) is 4096, the maximum 65536.
+The default number of zones (option \fB\-\-length\fP) is all zones.
.SH OPTIONS
The
-.I sector
-and
-.I count
-option arguments may be followed by the multiplicative suffixes KiB (=1024),
+.I offset
+option argument may be followed by the multiplicative suffixes KiB (=1024),
MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is
optional, e.g., "K" has the same meaning as "KiB") or the suffixes
KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and YB.
-Additionally, the 0x prefix can be used to specify \fIsector\fR and
-\fIcount\fR in hex.
+Additionally, the 0x prefix can be used to specify \fIoffset\fR in hex.
.TP
.BR \-o , " \-\-offset "\fIsector\fP
The starting zone specified as a sector offset. The provided offset in sector