gzbd-viewer - Man Page

zoned block devices zone state graphical interface


gzbd-viewer [options] device


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

MagentaConventional zones
RedWritten sectors of a sequential zone
GreenUnwritten and usable sectors of a sequential zone
Rosy brownUnusable sectors of a sequential zone

Zone condition color codes

Light blueExplicitly opened zones
Dark blueImplicitly opened zones
Dark orangeClosed zones
GreyOffline 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.


-?,  --help

Show help options and exit.


Show all help options and exit.


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.


Specify the X display to use.


Damien Le Moal <damien.lemoal@wdc.com>

See Also

zbd(8), gzbd(8)


The gzbd-viewer utility is part of the libzbd library available from https://github.com/westerndigitalcorporation/libzbd.