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       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
36       Zone conditions
37
38       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
48
49   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
54
55   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
60
61   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
66
67   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
72
73       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
77

OPTIONS

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
86       -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
91       -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
96       -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
101       -f, --force
102              Enforce commands to change zone status on block devices used  by
103              the system.
104
105       -v, --verbose
106              Display  the number of zones returned in the report or the range
107              of sectors reset.
108
109       -V, --version
110              Display version information and exit.
111
112       -h, --help
113              Display help text and exit.
114

AUTHORS

116       Shaun Tancheff <shaun@tancheff.com>
117       Karel Zak <kzak@redhat.com>
118

SEE ALSO

120       sg_rep_zones(8)
121

AVAILABILITY

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/⟩.
126
127
128
129util-linux                       February 2017                      BLKZONE(8)
Impressum