BUBBLES(1)

📦
version 2.2.3 · 2 versions
, in fedora 43

💖 BUBBLES 💖

okay bestie, so this is bubbles(1) from the User Contributed Perl Documentation section of the manual, and honestly? she's adorable and she does one job and she does it cute. let's get into it 🫧

✨ NAME ✨

bubbles — DNSSEC-Tools Rollrec Simple GUI Display

like. it's a lil GUI. it shows you rollrec stuff. with bubbles. iconic behavior fr.

🌸 SYNOPSIS 🌸

bubbles [options] <rollrec-file>

that's it. that's the whole vibe. you give her options, you give her a rollrec file, she pops up a window. slay. 💅

🦋 DESCRIPTION 🦋

so bubbles gives you a simple display of the roll status of a set of zones that are listed in a rollrec file. simple!! that's the whole point!! she is not trying to be everything.

in contrast (and yes i'm about to compare her to her sibling), blinkenlights gives a detailed display of the roll status of a set of zones. bubbles gives very little control over rollerd — like, blinkenlights does all that. bubbles can halt rollerd's execution only. that's it. that's her one (1) power move. 👑

okay now. a rollrec file contains one or more rollrec records. these records are used by the DNSSEC-Tools rollover utilities (rollerd, etc.) to describe zones' rollover states. each zone's rollrec record contains such information as the zone file, the rollover phase, and logging level. rollrec files are text files. no cap. 📄

when bubbles starts, a window is created that has "bubbles" for each zone with a rollrec record in the given rollrec file. (and no, clicking on a bubble doesn't do anything. it's decorative. it's art. let her live. 🙈)

by default, all zones with a display flag set on will be shown in the bubbles window. options may be given to modify this behavior.

the zone bubbles are color-coded according to roll-over state. the default colors are:

  • green: not in roll-over
  • yellow: in ZSK roll-over
  • red: in KSK roll-over

these colors may be specified by the user via command-line options. customize away, queen 🌈

in building the bubble window, bubbles window defaults to creating a square window. this may be overridden by specifying the number of columns, using the -columns option. geometry is a construct bestie 💅

🎀 OPTIONS 🎀

bubbles supports the following options.

  • -columns columns — this option lets you specify the number of columns to be used in the Button Window. you want a rectangle? you get a rectangle. ✨
  • -kskcolor color — sets the bubble color for zones that are performing KSK roll-overs.
  • -zskcolor color — sets the bubble color for zones that are performing ZSK roll-overs.
  • -noncolor color — sets the bubble color for zones that are not in roll-over.
  • -ignore-display — ignores the rollrec display flag and displays every zone in the rollrec file. everyone's invited. 🫶
  • -interval wait-time — the interval between checks of the rollrec file. by default, wait-time is given in minutes. this can be adjusted by specifying one of the following time-unit suffixes.
    • s — seconds
    • m — minutes
    • h — hours

examples:

  • -interval 24 — 24 minutes
  • -interval 24s — 24 seconds
  • -interval 24m — 24 minutes
  • -interval 24h — 24 hours
  • -no-filter — this option turns off name filtering when bubbles presents a file-selection dialog for choosing a new rollrec file. if this option is not given, then the file-selection dialog will only list regular files with a suffix of .rrf. so like, -no-filter = "show me everything, i can handle it" 😤
  • -showksk — shows the zones that are performing KSK roll-overs.
  • -shownonrolls — shows the zones that are not in roll-over.
  • -showrolls — shows the zones that are performing either type of roll-over.
  • -showzsk — shows the zones that are performing ZSK roll-overs.
  • -help — gives a usage message and exits. she'll tell you how she works and then dip 🚪
  • -Version — displays the version information for bubbles and the DNSSEC-Tools package. yes with the capital V, bestie, that's literally how it's written, don't come for me 💀

💜 REQUIREMENTS 💜

bubbles is implemented in Perl/Tk, so both Perl and Perl/Tk must be installed on your system. no Perl/Tk, no bubbles, no vibes. install your dependencies fr fr 🧚

Copyright 2009-2014 SPARTA, Inc. All rights reserved. see the COPYING file included with the DNSSEC-Tools package for details.

👑 AUTHOR 👑

Wayne Morrison, tewok@tislabs.com

🌈 SEE ALSO 🌈

quick reminder bestie: clicking a bubble does literally nothing. i know. i know. i'm upset about it too. 😭

and that's the whole page!! this was bubbles(1) from perl v5.42.0, dated 2025-07-23 — go forth and bubble responsibly, you absolute main character 🫧✨💖

📦 where this page comes from