ZBC(8)

💅 ZBC(8) — zbc_report_zones, but make it make sense 💅

✨ NAME ✨

zbc_report_zones — display zone information of a ZBC or ZAC device. periodt.

🌸 SYNOPSIS 🌸

zbc_report_zones [options] device

🦋 DESCRIPTION 🦋

okay so zbc_report_zones is the utility that displays information on the zones of a ZBC or ZAC device. literally its whole thing.

The device argument has to 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). heads up: 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. yes, all of them, bestie:

• -h, --help — display a usage help message and exit.
• -v — verbose mode (for debugging problems).
• -lba — by default, zone information uses a 512B sector unit regardless of the device logical block size. This option forces displaying zone information using the device logical block size (LBA) as the unit.
• -start sector — display information on zones starting from the zone including the specified sector. If the option -lba is used, sector is interpreted as a logical block address. Otherwise, sector is assumed to be a 512B sector value.
• -n — only get the number of zones of a report instead of displaying all zones information.
• -nz num — display information on at most num zones.
• -ro ro — specify a reporting option. ro can be one of the following values:
  • all — report all zones (default)
  • empty — report empty zones
  • imp_open — only report implicitly open zones
  • exp_open — only report explicitly open zones
  • closed — only report closed zones
  • full — only report full zones
  • rdonly — only report read-only zones
  • offline — only report offline zones
  • not_wp — only report zones that are not write pointer zones

🫶 AUTHOR 🫶

Damien Le Moal <damien.lemoal@wdc.com> wrote this one, slay.

🔥 SEE ALSO 🔥

blkzone(8), sg_rep_zones(8) — go read those too, bestie.

🌈 AVAILABILITY 🌈

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

mwah 💖 that’s the whole ZBC(8) page from the System Manager’s Manual — the footer is just ZBC(8), and there’s no date listed, so no fake date from me. byeeee 🫶