gzbd-viewer - Man Page
zoned block devices zone state graphical interface
Synopsis
gzbd-viewer [options] device
Description
gzbd-viewer is used to dynamically display the state of zones of a zoned block device. Each zone is displayed as a box representing the sector range of the zone. A zone box is filled with different colors based on the zone type and on the use of sectors within the zone. The condition of zones is indicated by highlighting a zone box border with different colors.
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.
By default, gzbd-viewer will display at most 100 zones using a 10 x 10 grid. This default display size can be changed using options as explained below.
Options
- -?, --help
Show help options and exit.
- --help-all
Show all help options and exit.
- --help-gtk
Show GTK+ options and exit.
- -v, --verbose
Use libzbd verbose mode (for debug).
- -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.
Author
Damien Le Moal <damien.lemoal@wdc.com>
See Also
zbd(8), gzbd(8)
Availability
The gzbd-viewer utility is part of the libzbd library available from https://github.com/westerndigitalcorporation/libzbd.