blkzone
(8)run zone command on a device
Options
7-o--offsetsectorThe starting zone specified as a sector offset. The provided offset in sector units (512 bytes) should match the start of a zone. The default value is zero.
-l--lengthsectorsThe maximum number of sectors the command should operate on. The default value is the number of sectors remaining after offset. This option cannot be used together with the option --count.
-c--countcountThe maximum number of zones the command should operate on. The default value is the number of zones starting from offset. This option cannot be used together with the option --length.
-f--forceEnforce commands to change zone status on block devices used by the system.
-v--verboseDisplay the number of zones returned in the report or the range of sectors reset.
-h--helpDisplay help text and exit.
-V--versionDisplay version and exit.
DESCRIPTION
COMMANDS
report
The command blkzone report is used to report device zone information.
By default, the command will report all zones from the start of the block device. Options may be used to modify this behavior, changing the starting zone or the size of the report, as explained below.
Report output:
| start | Zone start sector |
| len | Zone length in number of sectors |
| cap | Zone capacity in number of sectors |
| wptr | Zone write pointer position |
| reset | Reset write pointer recommended |
| non-seq | Non-sequential write resources active |
| cond | Zone condition |
| type | Zone type |
Zone conditions:
| 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) |
capacity
The command blkzone capacity is used to report device capacity information.
By default, the command will report the sum, in number of sectors, of all zone capacities on the device. Options may be used to modify this behavior, changing the starting zone or the size of the report, as explained below.
reset
The command blkzone reset is used to reset one or more zones. Unlike sg_reset_wp(8), this command operates from the block layer and can reset a range of zones.
open
The command blkzone open is used to explicitly open one or more zones. Unlike sg_zone(8), open action, this command operates from the block layer and can open a range of zones.
close
The command blkzone close is used to close one or more zones. Unlike sg_zone(8), close action, this command operates from the block layer and can close a range of zones.
finish
The command blkzone finish is used to finish (transition to full condition) one or more zones. Unlike sg_zone(8), finish action, this command operates from the block layer and can finish a range of zones.
By default, the reset, open, close and finish commands will operate from the zone at device sector 0 and operate on all zones. Options may be used to modify this behavior as explained below.
AUTHORS
Shaun Tancheff shaun@tancheff.com, Karel Zak kzak@redhat.com
REPORTING BUGS
For bug reports, use the issue tracker https://github.com/util-linux/util-linux/issues.
AVAILABILITY
The blkzone command is part of the util-linux package which can be downloaded from Linux Kernel Archive https://www.kernel.org/pub/linux/utils/util-linux/.