1BLKZONE(8) System Administration BLKZONE(8)
2
6 blkzone - run zone command on a device
7
9 blkzone command [options] device
10
12 blkzone is used to run zone command on device that support the Zoned
13 Block Commands (ZBC) or Zoned-device ATA Commands (ZAC). The zones to
14 operate on can be specified using the offset, count and length options.
15 The device argument is the pathname of the block device.
17
19 report
20 The command blkzone report is used to report device zone information.
21 By default, the command will report all zones from the start of the
23 block device. Options may be used to modify this behavior, changing the
24 starting zone or the size of the report, as explained below.
25 Report output
27 start Zone start sector
29 len Zone length in number of sectors
30 wptr Zone write pointer position
31 reset Reset write pointer recommended
32 non-seq Non-sequential write resources active
33 cond Zone condition
34 type Zone type
35 Zone conditions
37 cl Closed
39 nw Not write pointer
40 em Empty
41 fu Full
42 oe Explicitly opened
43 oi Implicitly opened
44 ol Offline
45 ro Read only
46 x? Reserved conditions (should not be reported)
47 reset
50 The command blkzone reset is used to reset one or more zones. Unlike
51 sg_reset_wp(8), this command operates from the block layer and can
52 reset a range of zones.
53 open
56 The command blkzone open is used to explicitly open one or more zones.
57 Unlike sg_zone(8), open action, this command operates from the block
58 layer and can open a range of zones.
59 close
62 The command blkzone close is used to close one or more zones. Unlike
63 sg_zone(8), close action, this command operates from the block layer
64 and can close a range of zones.
65 finish
68 The command blkzone finish is used to finish (transition to full condi‐
69 tion) one or more zones. Unlike sg_zone(8), finish action, this command
70 operates from the block layer and can finish a range of zones.
71 By default, the reset, open, close and finish commands will operate
74 from the zone at device sector 0 and operate on all zones. Options may
75 be used to modify this behavior as explained below.
76
79 The offset and length option arguments may be followed by the multi‐
80 plicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB,
81 TiB, PiB, EiB, ZiB and YiB (the "iB" is optional, e.g., "K" has the
82 same meaning as "KiB") or the suffixes KB (=1000), MB (=1000*1000), and
83 so on for GB, TB, PB, EB, ZB and YB. Additionally, the 0x prefix can
84 be used to specify offset and length in hex.
85 -o, --offset sector
87 The starting zone specified as a sector offset. The provided
88 offset in sector units (512 bytes) should match the start of a
89 zone. The default value is zero.
90 -l, --length sectors
92 The maximum number of sectors the command should operate on. The
93 default value is the number of sectors remaining after offset.
94 This option cannot be used together with the option --count.
95 -c, --count count
97 The maximum number of zones the command should operate on. The
98 default value is the number of zones starting from offset. This
99 option cannot be used together with the option --length.
100 -f, --force
102 Enforce commands to change zone status on block devices used by
103 the system.
104 -v, --verbose
106 Display the number of zones returned in the report or the range
107 of sectors reset.
108 -V, --version
110 Display version information and exit.
111 -h, --help
113 Display help text and exit.
114
116 Shaun Tancheff <shaun@tancheff.com>
117 Karel Zak <kzak@redhat.com>
118
120 sg_rep_zones(8)
121
123 The blkzone command is part of the util-linux package and is available
124 from Linux Kernel Archive ⟨https://www.kernel.org/pub/linux/utils/util-
125 linux/⟩.
126util-linux February 2017 BLKZONE(8)