blkzone(8)

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       By  default,  the command will operate from the zone at device sector 0
55       and reset all zones. Options may be used to  modify  this  behavior  as
56       well as specify the operation to be performed on the zone, as explained
57       below.
58
59

OPTIONS

61       The offset and length option arguments may be followed  by  the  multi‐
62       plicative  suffixes  KiB  (=1024), MiB (=1024*1024), and so on for GiB,
63       TiB, PiB, EiB, ZiB and YiB (the "iB" is optional,  e.g.,  "K"  has  the
64       same meaning as "KiB") or the suffixes KB (=1000), MB (=1000*1000), and
65       so on for GB, TB, PB, EB, ZB and YB.  Additionally, the 0x  prefix  can
66       be used to specify offset and length in hex.
67
68       -o, --offset sector
69              The  starting  zone  specified  as a sector offset. The provided
70              offset in sector units (512 bytes) should match the start  of  a
71              zone. The default value is zero.
72
73       -l, --length sectors
74              The maximum number of sectors the command should operate on. The
75              default value is the number of sectors remaining  after  offset.
76              This option cannot be used together with the option --count.
77
78       -c, --count count
79              The  maximum  number of zones the command should operate on. The
80              default value is the number of zones starting from offset.  This
81              option cannot be used together with the option --length.
82
83       -v, --verbose
84              Display  the number of zones returned in the report or the range
85              of sectors reset..
86
87       -V, --version
88              Display version information and exit.
89
90       -h, --help
91              Display help text and exit.
92

AUTHORS

94       Shaun Tancheff <shaun@tancheff.com>
95       Karel Zak <kzak@redhat.com>
96

AVAILABILITY

101       The blkzone command is part of the util-linux package and is  available
102       from Linux Kernel Archive ⟨https://www.kernel.org/pub/linux/utils/util-
103       linux/⟩.
104
105
106
107util-linux                       February 2017                      BLKZONE(8)