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 ┌────────┬────────────────────────────┐
29 │ │ │
30 │start │ Zone start sector │
31 ├────────┼────────────────────────────┤
32 │ │ │
33 │len │ Zone length in number of │
34 │ │ sectors │
35 ├────────┼────────────────────────────┤
36 │ │ │
37 │cap │ Zone capacity in number of │
38 │ │ sectors │
39 ├────────┼────────────────────────────┤
40 │ │ │
41 │wptr │ Zone write pointer │
42 │ │ position │
43 ├────────┼────────────────────────────┤
44 │ │ │
45 │reset │ Reset write pointer │
46 │ │ recommended │
47 ├────────┼────────────────────────────┤
48 │ │ │
49 │non-seq │ Non-sequential write │
50 │ │ resources active │
51 ├────────┼────────────────────────────┤
52 │ │ │
53 │cond │ Zone condition │
54 ├────────┼────────────────────────────┤
55 │ │ │
56 │type │ Zone type │
57 └────────┴────────────────────────────┘
58 Zone conditions:
60 ┌───┬──────────────────────────┐
62 │ │ │
63 │cl │ Closed │
64 ├───┼──────────────────────────┤
65 │ │ │
66 │nw │ Not write pointer │
67 ├───┼──────────────────────────┤
68 │ │ │
69 │em │ Empty │
70 ├───┼──────────────────────────┤
71 │ │ │
72 │fu │ Full │
73 ├───┼──────────────────────────┤
74 │ │ │
75 │oe │ Explicitly opened │
76 ├───┼──────────────────────────┤
77 │ │ │
78 │oi │ Implicitly opened │
79 ├───┼──────────────────────────┤
80 │ │ │
81 │ol │ Offline │
82 ├───┼──────────────────────────┤
83 │ │ │
84 │ro │ Read only │
85 ├───┼──────────────────────────┤
86 │ │ │
87 │x? │ Reserved conditions │
88 │ │ (should not be reported) │
89 └───┴──────────────────────────┘
90 capacity
92 The command blkzone capacity is used to report device capacity
93 information.
94 By default, the command will report the sum, in number of sectors, of
96 all zone capacities on the device. Options may be used to modify this
97 behavior, changing the starting zone or the size of the report, as
98 explained below.
99 reset
101 The command blkzone reset is used to reset one or more zones. Unlike
102 sg_reset_wp(8), this command operates from the block layer and can
103 reset a range of zones.
104 open
106 The command blkzone open is used to explicitly open one or more zones.
107 Unlike sg_zone(8), open action, this command operates from the block
108 layer and can open a range of zones.
109 close
111 The command blkzone close is used to close one or more zones. Unlike
112 sg_zone(8), close action, this command operates from the block layer
113 and can close a range of zones.
114 finish
116 The command blkzone finish is used to finish (transition to full
117 condition) one or more zones. Unlike sg_zone(8), finish action, this
118 command operates from the block layer and can finish a range of zones.
119 By default, the reset, open, close and finish commands will operate
121 from the zone at device sector 0 and operate on all zones. Options may
122 be used to modify this behavior as explained below.
123
125 The offset and length option arguments may be followed by the
126 multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for
127 GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is optional, e.g., "K" has
128 the same meaning as "KiB") or the suffixes KB (=1000), MB (=1000*1000),
129 and so on for GB, TB, PB, EB, ZB and YB. Additionally, the 0x prefix
130 can be used to specify offset and length in hex.
131 -o, --offset sector
133 The starting zone specified as a sector offset. The provided offset
134 in sector units (512 bytes) should match the start of a zone. The
135 default value is zero.
136 -l, --length sectors
138 The maximum number of sectors the command should operate on. The
139 default value is the number of sectors remaining after offset. This
140 option cannot be used together with the option --count.
141 -c, --count count
143 The maximum number of zones the command should operate on. The
144 default value is the number of zones starting from offset. This
145 option cannot be used together with the option --length.
146 -f, --force
148 Enforce commands to change zone status on block devices used by the
149 system.
150 -v, --verbose
152 Display the number of zones returned in the report or the range of
153 sectors reset.
154 -h, --help
156 Display help text and exit.
157 -V, --version
159 Print version and exit.
160
162 Shaun Tancheff <shaun@tancheff.com>, Karel Zak <kzak@redhat.com>
163
165 sg_rep_zones(8)
166
168 For bug reports, use the issue tracker at
169 https://github.com/util-linux/util-linux/issues.
170
172 The blkzone command is part of the util-linux package which can be
173 downloaded from Linux Kernel Archive
174 <https://www.kernel.org/pub/linux/utils/util-linux/>.
175util-linux 2.39.2 2023-06-14 BLKZONE(8)