gzbd-viewer(8)

zoned block devices zone state graphical interface

Section 8 zbd-utils bookworm source

Description

GZBD-VIEWER

NAME

gzbd-viewer - 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

Image grohtml-89123-1.png

Zone condition color codes

Image grohtml-89123-2.png

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.