BLKZONE(8)                                                System Administration                                               BLKZONE(8)

NAME
       blkzone - run zone command on a device

SYNOPSIS
       blkzone command [options] device

DESCRIPTION
       blkzone is used to run zone command on device that support the Zoned Block Commands (ZBC) or Zoned-device ATA Commands (ZAC). The
       zones to operate on can be specified using the offset, count and length options.

       The device argument is the pathname of the block device.

COMMANDS
   report
       The command blkzone report is used to report device zone information.

       By default, the command will report all zones from the start of the block device. Options may be used to  modify  this  behavior,
       changing the starting zone or the size of the report, as explained below.

       Report output

       start     Zone start sector
       len       Zone length in number of sectors
       wptr      Zone write pointer position
       reset     Reset write pointer recommended
       non-seq   Non-sequential write resources active
       cond      Zone condition
       type      Zone type

       Zone conditions

       cl   Closed
       nw   Not write pointer
       em   Empty
       fu   Full
       oe   Explicitly opened
       oi   Implicitly opened
       ol   Offline
       ro   Read only
       x?   Reserved conditions (should not be reported)

   reset
       The  command  blkzone reset is used to reset one or more zones. Unlike sg_reset_wp(8), this command operates from the block layer
       and can reset a range of zones.

       By default, the command will operate from the zone at device sector 0 and reset all zones. Options may be used to modify this be‐
       havior as well as specify the operation to be performed on the zone, as explained below.

OPTIONS
       The  offset  and  length option arguments may be followed by the multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on
       for GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is optional, e.g., "K" has the same meaning as "KiB") or the suffixes  KB  (=1000),
       MB  (=1000*1000),  and so on for GB, TB, PB, EB, ZB and YB.  Additionally, the 0x prefix can be used to specify offset and length
       in hex.

       -o, --offset sector
              The starting zone specified as a sector offset. The provided offset in sector units (512 bytes) should match the start  of
              a zone. The default value is zero.

       -l, --length sectors
              The  maximum  number  of sectors the command should operate on. The default value is the number of sectors remaining after
              offset. This option cannot be used together with the option --count.

       -c, --count count
              The maximum number of zones the command should operate on. The default value is the number of zones starting from  offset.
              This option cannot be used together with the option --length.

       -v, --verbose
              Display the number of zones returned in the report or the range of sectors reset..

       -V, --version
              Display version information and exit.

       -h, --help
              Display help text and exit.

AUTHORS
       Shaun Tancheff <shaun@tancheff.com>
       Karel Zak <kzak@redhat.com>

SEE ALSO
       sg_rep_zones(8)

AVAILABILITY
       The  blkzone  command  is  part  of the util-linux package and is available from Linux Kernel Archive ⟨https://www.kernel.org/pub
       /linux/utils/util-linux/⟩.

util-linux                                                    February 2017                                                   BLKZONE(8)

Usage:
 blkzone <command> [options] <device>

Run zone command on the given block device.

Commands:
 report       Report zone information about the given device
 reset        Reset a range of zones.

Options:
 -o, --offset <sector>  start sector of zone to act (in 512-byte sectors)
 -l, --length <sectors> maximum sectors to act (in 512-byte sectors)
 -c, --count <number>   maximum number of zones
 -v, --verbose          display more details

 -h, --help             display this help
 -V, --version          display version

For more details see blkzone(8).