1BLKZONE(8)                   System Administration                  BLKZONE(8)
2
3
4

NAME

6       blkzone - run zone command on a device
7

SYNOPSIS

9       blkzone command [options] device
10

DESCRIPTION

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
16       The device argument is the pathname of the block device.
17

COMMANDS

19   report
20       The command blkzone report is used to report device zone information.
21
22       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
26       Report output:
27
28       ┌────────┬────────────────────────────┐
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
59       Zone conditions:
60
61       ┌───┬──────────────────────────┐
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
91   capacity
92       The command blkzone capacity is used to report device capacity
93       information.
94
95       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
100   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
105   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
110   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
115   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
120       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

OPTIONS

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
132       -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
137       -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
142       -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
147       -f, --force
148           Enforce commands to change zone status on block devices used by the
149           system.
150
151       -v, --verbose
152           Display the number of zones returned in the report or the range of
153           sectors reset.
154
155       -h, --help
156           Display help text and exit.
157
158       -V, --version
159           Print version and exit.
160

AUTHORS

162       Shaun Tancheff <shaun@tancheff.com>, Karel Zak <kzak@redhat.com>
163

SEE ALSO

165       sg_rep_zones(8)
166

REPORTING BUGS

168       For bug reports, use the issue tracker at
169       https://github.com/util-linux/util-linux/issues.
170

AVAILABILITY

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/>.
175
176
177
178util-linux 2.39.2                 2023-06-14                        BLKZONE(8)
Impressum