# blkzone

## 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
                cap        Zone capacity 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
                xN    Reserved conditions (should not be reported)
    
       **capacity**
           The command **blkzone capacity** is used to report device capacity
           information.
    
           By default, the command will report the sum, in number of sectors,
           of all zone capacities on the device. Options may be used to
           modify this behavior, changing the starting zone or the size of
           the report, as explained below.
    
       **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.
    
       **open**
           The command **blkzone open** is used to explicitly open one or more
           zones. Unlike **sg_zone**(8), open action, this command operates from
           the block layer and can open a range of zones.
    
       **close**
           The command **blkzone close** is used to close one or more zones.
           Unlike **sg_zone**(8), close action, this command operates from the
           block layer and can close a range of zones.
    
       **finish**
           The command **blkzone finish** is used to finish (transition to full
           condition) one or more zones. Unlike **sg_zone**(8), finish action,
           this command operates from the block layer and can finish a range
           of zones.
    
           By default, the **reset** , **open** , **close** and **finish** commands will
           operate from the zone at device sector 0 and operate on all zones.
           Options may be used to modify this behavior 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**.
    
           **-f** , **--force**
               Enforce commands to change zone status on block devices used
               by the system.
    
           **-v** , **--verbose**
               Display the number of zones returned in the report or the
               range of sectors reset.
    
           **-h** , **--help**
               Display help text and exit.
    
           **-V** , **--version**
               Display version and exit.
    


## AVAILABILITY



           The **blkzone** command is part of the util-linux package which can be
           downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                     _BLKZONE_(8)
    


* * *