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
       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.

                                                                                                  GZBD-VIEWER(8)