bubbles(1)

1BUBBLES(1)            User Contributed Perl Documentation           BUBBLES(1)
2
3
4

NAME

6       bubbles - DNSSEC-Tools Rollrec Simple GUI Display
7

SYNOPSIS

9         bubbles [options] <rollrec-file>
10

DESCRIPTION

12       bubbles gives a simple display of the roll status of a set of zones
13       listed in a rollrec file.  In contrast, blinkenlights gives a detailed
14       display of the roll status of a set of zones.  bubbles gives very
15       little control over rollerd, the way blinkenlights does.  bubbles can
16       halt rollerd's execution only.
17
18       A rollrec file contains one or more rollrec records.  These records are
19       used by the DNSSEC-Tools rollover utilities (rollerd, etc.) to describe
20       zones' rollover states.  Each zone's rollrec record contains such
21       information as the zone file, the rollover phase, and logging level.
22       rollrec files are text files.
23
24       When bubbles starts, a window is created that has "bubbles" for each
25       zone with a rollrec record in the given rollrec file.  (Clicking on a
26       bubble doesn't do anything.)  By default, all zones with a display flag
27       set on will be shown in the bubbles window.  Options may be given to
28       modify this behavior.
29
30       The zone bubbles are color-coded according to roll-over state.  The
31       default colors are:
32
33       * green: not in roll-over
34
35       * yellow: in ZSK roll-over
36
37       * red: in KSK roll-over
38
39       These colors may be specified by the user via command-line options.
40
41       In building the bubble window, bubbles window defaults to creating a
42       square window.  This may be overridden by specifying the number of
43       columns, using the -columns option.
44

OPTIONS

46       bubbles supports the following options.
47
48       -columns columns
49           This option allows the user to specify the number of columns to be
50           used in the Button Window.
51
52       -kskcolor color
53           Set the bubble color for zones that are performing KSK roll-overs.
54
55       -zskcolor color
56           Set the bubble color for zones that are performing ZSK roll-overs.
57
58       -noncolor color
59           Set the bubble color for zones that are not in roll-over.
60
61       -ignore-display
62           Ignore the rollrec display flag and display every zone in the
63           rollrec file.
64
65       -interval wait-time
66           Interval between checks of the rollrec file.  By default, wait-time
67           is given in minutes.  This can be adjusted by specifying one of the
68           following time-unit suffixes.
69
70           * s - seconds
71
72           * m - minutes
73
74           * h - hours
75
76           Examples:
77
78           * -interval 24 - 24 minutes
79
80           * -interval 24s - 24 seconds
81
82           * -interval 24m - 24 minutes
83
84           * -interval 24h - 24 hours
85
86       -no-filter
87           This option turns off name filtering when bubbles presents a file-
88           selection dialog for choosing a new rollrec file.  If this option
89           is not given, then the file-selection dialog will only list regular
90           files with a suffix of .rrf.
91
92       -showksk
93           Show the zones that are performing KSK roll-overs.
94
95       -shownonrolls
96           Show the zones that are not in roll-over.
97
98       -showrolls
99           Show the zones that are performing either type of roll-over.
100
101       -showzsk
102           Show the zones that are performing ZSK roll-overs.
103
104       -help
105           Give a usage message and exit.
106
107       -Version
108           Displays the version information for bubbles and the DNSSEC-Tools
109           package.
110

REQUIREMENTS

112       bubbles is implemented in Perl/Tk, so both Perl and Perl/Tk must be
113       installed on your system.
114

KNOWN ISSUES

116       The following are known issues.  These will be resolved in the fullness
117       of time.
118
119       ·   Segmentation violation on exit.  This problem occurs on Mac OS X
120           10.4.9-10.4.11 with Perl 5.8.6; however, it does not occur on Mac
121           OS X 10.5.8 with Perl 5.8.8.
122

COPYRIGHT

124       Copyright 2009-2011 SPARTA, Inc.  All rights reserved.  See the COPYING
125       file included with the DNSSEC-Tools package for details.
126

AUTHOR

128       Wayne Morrison, tewok@users.sourceforge.net
129