GZBD-VIEWER(8)

💖 NAME 💖

okay so bestie, meet gzbd-viewer — the zoned block devices zone state graphical interface. that's the whole vibe. she's a GUI, she watches zones, she's iconic. this page lives in section 8 of the System Manager's Manual, iykyk 🎀

✨ SYNOPSIS ✨

gzbd-viewer [options] device

🦋 DESCRIPTION 🦋

okay so gzbd-viewer is literally here to dynamically display the state of zones of a zoned block device. the way she does it? every single zone gets its own lil box 🎁, and that box represents the sector range of the zone. simple, elegant, ate.

each zone box gets filled with different colors depending on the zone type and on the use of sectors within the zone. and the condition of zones? that's shown by highlighting a zone box border with different colors. border game strong 💅

🌈 Zone type and usage color codes 🌈

• Magenta — Conventional zones
• Red — Written sectors of a sequential zone
• Green — Unwritten and usable sectors of a sequential zone
• Rosy brown — Unusable sectors of a sequential zone

🎨 Zone condition color codes 🎨

• Light blue — Explicitly opened zones
• Dark blue — Implicitly opened zones
• Dark orange — Closed zones
• Grey — Offline zones

the device argument must be the pathname of the target zoned block device. no shortcuts, no vibes-based guessing, just give her the path fr fr.

by default, gzbd-viewer will display at most 100 zones using a 10 x 10 grid. that default display size can be changed using options as explained below 👇 (the options are down there, keep scrolling bestie, they're so good)

👑 OPTIONS 👑

• -?, --help — Show help options and exit. (courtesy help, she's polite 🫶)
• --help-all — Show all help options and exit.
• --help-gtk — Show GTK+ options and exit.
• -v, --verbose — Use libzbd verbose mode (for debug). debugging time 🔥
• -i, --interval msec — Set refresh interval to msec milliseconds (default: 500).
• -w, --width columns — Display zones in a matrix of columns columns.
• -h, --height rows — Display zones in a matrix of rows rows.
• -b, --block size — Use size as the unit for displaying a zone position, length and write pointer position instead of the default byte value.
• --display=DISPLAY — Specify the X display to use.

🚨 heads up bestie: -h here is height, not help. don't come for me, that's just what the page says. use -? or --help if you need the help. 💀

🌸 AUTHOR 🌸

Damien Le Moal <damien.lemoal@wdc.com> — king behavior, honestly 👑

🔍 SEE ALSO 🔍

zbd(8), gzbd(8) — go read those too, they're the siblings, the whole friend group 🫶

🎀 AVAILABILITY 🎀

the gzbd-viewer utility is part of the libzbd library, available from https://github.com/westerndigitalcorporation/libzbd. go star it, go read it, go be obsessed ✨

and that's the whole page, bestie!! this was GZBD-VIEWER(8) from the System Manager's Manual — section 8 energy all the way through. mwah 💅💖