BLKZONE

Section: System Administration (8)
Updated: February 2017
Page Index
 

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

startZone start sector
lenZone length in number of sectors
wptrZone write pointer position
resetReset write pointer recommended
non-seqNon-sequential write resources active
condZone condition
typeZone type

Zone conditions

clClosed
nwNot write pointer
emEmpty
fuFull
oeExplicitly opened
oiImplicitly opened
olOffline
roRead 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.

 

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.
-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


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
report
reset
open
close
finish
OPTIONS
AUTHORS
SEE ALSO
AVAILABILITY