ZBC(8)

okay so you're looking at ZBC(8), the System Manager's Manual page for zbc_read_zone, and bestie, it's literally all about reading sectors from zones on ZBC or ZAC devices. 💖 The vibe is very block-device main character energy, and we're gonna keep every flag, path, and caveat intact. ✨

💖 NAME 💖

zbc_read_zone — read sectors of a zone of a ZBC or ZAC device. ate. 🦋

🎀 SYNOPSIS 🎀

zbc_read_zone [options] device zone_number IO_size

🦋 DESCRIPTION 🦋

okay so zbc_read_zone is the utility that reads sectors from a zone of a ZBC or ZAC device. By default, the target zone will be read starting from the first sector of the zone. 💅

For sequential zones, the default behavior is to read all sectors up to the zone write pointer position. For conventional zones, all sectors are read. periodt. not me being obsessed with zone write pointers fr fr. ✨

The device argument must be the pathname to the target device block device file (e.g., /dev/sdb), or to the target device SG node file (e.g., /dev/sg3). On old kernels lacking ZBC and ZAC support, only the device SG node file will be available. 🫶

✨ OPTIONS ✨

The following options can be specified. vibe check: slay. 💅

• -h, --help — display a usage help message and exit. 🎀
• -v — verbose mode (for debugging problems). 🔍
• -dio — use direct IO operations. 💾
• -vio num — use vectored IO with num buffers of IO_size bytes, resulting in an actual I/O size of num x IO_size bytes. 🧚
• -nio num — limit the number of I/O executed to num. 🔢
• -p num — expect all bytes that are read to have the value num. In case of a mismatch, the offset of the bytes with the incorrect value is printed. 👀
• -f file — write the data read from the zone to file. If file is "-", the data read is printed to the standard output. 🍓
• -ofst ofst — read the zone from the sector offset ofst instead of from the start of the zone. ⭐

👑 AUTHOR 👑

Damien Le Moal <damien.lemoal@wdc.com> — the author, the icon, the legend. 💜

👀 SEE ALSO 👀

dd(1), sg_dd(8) — go give them a look, iykyk. 🌈

🌐 AVAILABILITY 🌐

The zbc_read_zone utility is part of the libzbc library available from https://github.com/westerndigitalcorporation/libzbc. 🫶

That's the ZBC(8) footer from the System Manager's Manual, bestie — the source line is the manual name and there's no extra date/version line to copy. Signing off with block-device sparkle. 🎀✨