ZBC(8)

📦 version 6.2.0, in nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 NAME 💖

Okay bestie, this is the zbc_write_zone page from the ZBC(8) manual in the System Manager's Manual — and it’s literally here to write sectors to a zone of a ZBC or ZAC device. ✨

✨ SYNOPSIS ✨

zbc_write_zone [options] device zone_number IO_size

💅 DESCRIPTION 💅

zbc_write_zone is used to write sectors to a zone of a ZBC or ZAC device. By default, the target zone will be written starting from the first sector of the zone for conventional zones and from the zone write pointer position for sequential zones. The default behavior is to write up to the last sector of the target zone. periodt.

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

🎀 OPTIONS 🎀

The following options can be specified, bestie:

  • -h, --help — Display a usage help message and exit. Slay, no notes. 💅
  • -v — Verbose mode (for debugging problems). yep, it’s the “tell me everything” mode. 👀
  • -dio — Use direct IO operations. ⚡
  • -vio num — Use vectored I/Os 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 — Set the byte values to write to num. If this option is not used, zeroes are written to the target zone. 🫧
  • -f file — Write the content of file to the target zone. 📄
  • -loop — If a file is specified with the option -f, repeatedly write the content of the file to the zone until the zone is full. 🔁
  • -ofst ofst — Write the target zone starting from the sector offset ofst instead of from the start of the zone. This option should be used only with conventional zones. 🚨
Bestie, that -ofst caveat is not decorative: only conventional zones. Don’t try to make it fetch happen on sequential zones. 🙈

🫶 AUTHOR 🫶

Damien Le Moal <damien.lemoal@wdc.com> — icon behavior. 👑

🔥 SEE ALSO 🔥

  • sg_dd(8) — go check it out, bestie. 💖

🌈 AVAILABILITY 🌈

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

source/version/date sign-off: the original footer is just ZBC(8), so that’s the whole manual-page stamp — byeee, bestie! 🫶💜

📦 where this page comes from