1GZBD-VIEWER(8)              System Manager's Manual             GZBD-VIEWER(8)
2
3
4

NAME

6       gzbd-viewer - zoned block devices zone state graphical interface
7
8

SYNOPSIS

10       gzbd-viewer [options] device
11
12

DESCRIPTION

14       gzbd-viewer  is  used  to  dynamically  display the state of zones of a
15       zoned block device.  Each zone is displayed as a box  representing  the
16       sector  range  of the zone.  A zone box is filled with different colors
17       based on the zone type and on the use of sectors within the  zone.  The
18       condition  of zones is indicated by highlighting a zone box border with
19       different colors.
20
21       Zone type and usage color codes
22
23       Magenta      Conventional zones
24       Red          Written sectors of a sequential zone
25       Green        Unwritten and usable sectors of a sequential zone
26       Rosy brown   Unusable sectors of a sequential zone
27
28       Zone condition color codes
29
30       Light blue    Explicitly opened zones
31       Dark blue     Implicitly opened zones
32       Dark orange   Closed zones
33       Grey          Offline zones
34
35
36       The device argument must be the pathname of the target zoned block  de‐
37       vice.
38
39
40       By  default, gzbd-viewer will display at most 100 zones using a 10 x 10
41       grid. This default display size can be changed  using  options  as  ex‐
42       plained below.
43
44

OPTIONS

46       -?, --help
47              Show help options and exit.
48
49       --help-all
50              Show all help options and exit.
51
52       --help-gtk
53              Show GTK+ options and exit.
54
55       -v, --verbose
56              Use libzbd verbose mode (for debug).
57
58       -i, --interval msec
59              Set refresh interval to msec milliseconds (default: 500).
60
61       -w, --width columns
62              Display zones in a matrix of columns columns.
63
64       -h, --height rows
65              Display zones in a matrix of rows rows.
66
67       -b, --block size
68              Use  size as the unit for displaying a zone position, length and
69              write pointer position instead of the default byte value.
70
71       --display=DISPLAY
72              Specify the X display to use.
73
74

AUTHOR

76       Damien Le Moal <damien.lemoal@wdc.com>
77
78

SEE ALSO

80       zbd(8), gzbd(8)
81
82

AVAILABILITY

84       The gzbd-viewer utility is part of the libzbd  library  available  from
85       ⟨https://github.com/westerndigitalcorporation/libzbd⟩.
86
87
88
89                                                                GZBD-VIEWER(8)