ZBC(8)

📦 version 6.2.0, in opensuse-leap 16.0

💅 ZBC(8) — bestie edition ✨

okay so this is the ZBC(8) page from the System Manager's Manual, and it's literally all about one little utility that makes your zones look gorgeous. no cap, it's giving "study group but for storage". let's get into it 🫶

🌸 NAME 🌸

gzviewer — a graphical interface that displays the zone state of your ZBC and ZAC devices. yes. graphical. we're visual now 💖

✨ SYNOPSIS ✨

gzviewer [options] device

🦋 DESCRIPTION 🦋

gzviewer is the tool you use to dynamically display the state of zones on a ZBC or ZAC device. and when we say display, we mean it — every single zone gets its own little box, drawn to represent the sector range of that zone. cute, right? 🎀

each zone box gets filled with different colors, and the color depends on two things:

  • the zone type
  • how sectors within the zone are being used

and the device argument? it has to be the pathname to the target device's block device file (like /dev/sdb, for example), or to the target device's SG node file (like /dev/sg3). super important detail: on old kernels that don't have ZBC and ZAC support, only the device SG node file will be available. so like… check your kernel first, bestie 💀

👑 OPTIONS 👑

  • -?, --help — shows the help options and dips out. classic.
  • --help-all — shows all the help options and exits. the full lore drop 📚
  • --help-gtk — shows the GTK+ options and exits. yes, GTK+ has its own options, she's got range.
  • -v, --verbose — turns on libzbc verbose mode, which is for debug. use it when things are acting sus 🔍
  • -i, --interval=msec — sets the zone refresh interval to msec milliseconds. the default? refreshing every 500 milliseconds. so it's literally always checking in on you, like a good friend 🫶
  • -w, --width=columns — displays the zones in a matrix of columns columns.
  • -h, --height=rows — displays the zones in a matrix of rows rows.
  • --display=DISPLAY — specifies the X display to DISPLAY. picking your screen like it's a main character moment ✨

💜 AUTHOR 💜

Damien Le Moal <damien.lemoal@wdc.com> — the icon who made this happen 👑

🌈 SEE ALSO 🌈

gzbc(8) — go read that one too, iykyk

⭐ AVAILABILITY ⭐

the gzviewer utility is part of the libzbc library, available from https://github.com/westerndigitalcorporation/libzbc — go star it, it deserves it 🍓

fr fr that's the whole page. nothing skipped, nothing summarised, every flag accounted for 💅

and that's a wrap!! this little page lives in the System Manager's Manual and signs off tagged ZBC(8) at the very bottom — so if you see that tag, you know exactly where you are 🧚💖 periodt.

📦 where this page comes from