BLKZONE(8)

💖 BLKZONE — the zone-command girlie of section 8 💖

okay bestie, so blkzone is a System Administration command (section 8 of the manual, the big-girl section 💅) and she's here to run zone commands on your block devices. let's get into it.

---

✨ NAME ✨

blkzone — run zone command on a device

---

🎀 SYNOPSIS 🎀

blkzone command [options] device

---

🦋 DESCRIPTION 🦋

so like, blkzone is what you use to run zone commands on a device that supports Zoned Block Commands (ZBC) or Zoned-device ATA Commands (ZAC). she's got range 💅 (literally). the zones you wanna operate on? you can pick them with the offset, count and length options. lowkey flexible.

the device argument is the pathname of the block device. that's the one you're pointing all this energy at.

---

👑 COMMANDS 👑

📋 report

the command blkzone report is used to report device zone information. it's giving receipts ✨

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)

ngl the xN ones are reserved and should not be reported, so if you see them something's being weird. not our problem fr.

🍓 capacity

the command blkzone capacity is used to report device capacity information. she's all about the numbers 💖

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. she does not do one-at-a-time energy, periodt.

🔓 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. main character default behavior honestly.

---

💅 OPTIONS 💅

okay so first, the glow-up on your numbers: 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. she contains multitudes 🧚

• -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. pick a lane bestie 😭
• -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. again, pick a lane 🙈
• -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. she's chatty and we love that ✨
• -h, --help — display help text and exit.
• -V, --version — display version and exit.

heads up bestie: --length and --count are mutually exclusive. no cap. don't try it.

---

🫶 AUTHORS 🫶

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

---

🌈 SEE ALSO 🌈

sg_rep_zones(8)

---

🐛 REPORTING BUGS 🐛

for bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

---

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

---

and that's the whole page, bestie 💖 this was util-linux 2.42.4, dated 2026-09-21, living its best life in BLKZONE(8). slay, go zone responsibly 👑🦋