ROLLREC-EDITOR(1)

📦

version 2.2.3 · 2 versions

2.2.3 · fedora 43 (latest)
2.2.3 · fedora 44

💖 rollrec-editor — the DNSSEC-Tools Rollrec GUI Editor 💖

okay bestie, gather round, because this is ROLLREC-EDITOR(1) and it is genuinely one of the most useful little tools in the DNSSEC-Tools user-contributed perl corner of the universe. it's rollrec-editor, and it's about to make your rollrec files look immaculate. 🦋

✨ SYNOPSIS ✨

rollrec-editor [options] <rollrec-file>

like, that's it. options go first, the rollrec file goes last, and then you get a whole GUI. periodt. 💅

🌸 DESCRIPTION 🌸

so. rollrec-editor gives you easy GUI-based management of rollrec files. no cap. a rollrec file holds one or more rollrec records, and those records are what the DNSSEC-Tools rollover utilities (rollerd, etc.) read to figure out each zone's rollover state. every zone's rollrec record is packing info like the zone file, the rollover phase, and the logging level. 🎀

rollrec files are just text files, so technically you could edit them in any text editor. but here's the thing — rollrec-editor is the glow-up, because it only lets you edit the records a user should actually change and it runs error checking on the data. main character behavior, honestly.

when rollrec-editor starts up, it makes a window with "buttons" for every single rollrec record in the rollrec file you handed it. (in this documentation that window is called the Button Window, iykyk.) clicking a button selects — or deselects — that zone. once you've got one or more zones selected, you can run one of several commands. those commands let you modify and delete existing rollrec records, create brand new rollrec records, merge rollrec files together, and verify that a file is valid. ✨

rollrec-editor's commands live in the menus, and most of them have a keyboard accelerator. all of them are described down in the COMMANDS section.

when you select a rollrec record to modify, a whole new window pops up holding the editable fields of that record. you can modify the fields right there in place. when you're done editing, the record gets "saved" — and heads up, that does not write the modified rollrec into its on-disk file. nope. the file has to be saved explicitly from the Button Window. don't skip that step bestie, i'm begging. 😭

as mentioned above, verification checks run when you save an edited rollrec record. one set of those checks makes sure that the files and directories associated with a zone actually exist. you can turn that check off at command start-up with the -ignore-warns command line option, or you can change it mid-run with the "Ignore Edit Warnings" menu command. 🫶

🎀 Button Window Layout 🎀

the Button Window has a button for each rollrec record in the selected file, and those buttons are arranged in a table with at least three columns. you can set the number of columns at command start-up with the -columns command line option, or change it during execution with the "Columns in Button Window" menu command.

now, when it sets the number of columns, rollrec-editor minimizes the space needed to display the selected file's rollrec buttons. which means — plot twist — the number of columns will sometimes differ from the number you asked for. it's giving best-fit, not exact-fit. 💅

for example, say a rollrec file has 12 rollrec records. here's how many rows and columns you actually get for each column selection:

        column count    rows    columns
              1          12        1
              2          6         2
              3          4         3
              4          3         4
              5          3         4
              6          2         6
              7          2         6
              8          2         6
              9          2         6
              10         2         6
              11         2         6
              12         1         12

the actual rows and columns for a requested column count will vary, all in the name of letting it achieve a "best-fit". 🦋

🙈 UNDOING MODIFICATIONS 🙈

okay so, the "undo" capability is not currently implemented. not me delivering bad news on a platter. 💀

that said, rollrec-editor does have the ability to reverse modifications it has made to a rollrec file. but here's the catch: this historical restoration only works for modifications made during a particular execution of rollrec-editor. modifications made during a previous execution may not be undone. so if you closed it and reopened it, that history is gone gone.

and after a "Save" operation, the data required for reversing modifications gets deleted. 🗑️ this is not the case for the "Save As" operation, though. so jot that down. ✨

🌈 OPTIONS 🌈

rollrec-editor supports the following options, bestie. here's the whole roster:

-columns columns — lets you specify how many columns get used in the Button Window. 📊
-ignore-warns — makes rollrec-editor ignore edit warnings when it's performing validation checks on the contents of rollrec records. 🙈
-no-filter — turns off name filtering when rollrec-editor pops up a file-selection dialog for choosing a new rollrec file. if you don't give this option, then that file-selection dialog will only list regular files with a suffix of .rrf. 🗂️
-Version — displays the version information for rollrec-editor and the DNSSEC-Tools package. 👑

to be continued, bestie… 🧚

💖 COMMANDS 💖

okay bestie, here's the whole menu tour. rollrec-editor gives you the following commands, all organized into menus: File, Edit, Commands, Rollrecs, and Options. slay, let's go menu by menu ✨

The File Menu is where you do stuff to the actual rollrec files, plus the whole "make it stop" situation.

Open

Open up a new rollrec file. 💖 If the file you named doesn't exist, you'll get prompted for what to do about it. Pick the "Continue" action and rollrec-editor just keeps editing the rollrec file you already had open. Pick "Quit" and rollrec-editor exits. that's it, that's the whole vibe.

Save

Save the current rollrec file. 🫶 The data for the "Undo Changes" command gets purged, so this file will look unmodified afterward.

Nothing will happen if no changes have been made. literally nothing. not a single thing.

Save As

Save the current rollrec file under a name that you pick. 🎀

Quit

Exit rollrec-editor. bye bestie 👋

The Edit Menu is your general-purpose editing operations zone.

Undo Changes

Reverse the modifications made to the rollrec records. This is only for the in-memory version of the rollrec file, jsyk.

Not currently implemented. 😭 yeah. it's giving placeholder. it's giving someday.

The Commands Menu is where you actually mess with rollrec records.

New Rollrec

Create a brand new rollrec record. ✨ You get a whole new window to edit the user-modifiable rollrec fields in, and a button for the new rollrec record gets inserted into the Button Window.

Once you're done editing, the "Save" button adds the new rollrec record to the in-memory rollrec file. 🫶 The file must be saved in order to have the new rollrec added to the file. like, the in-memory thing is not the file, bestie, remember that.

Potentially erroneous conditions get reported to you at save time. If the ignore-warnings flag has been turned on, then those warnings will not be reported. Errors (e.g., invalid log conditions) will always be reported. no cap. 🔥

Delete Selected Rollrecs

Delete the rollrec records you selected. The buttons for each selected record get removed from the Button Window. 💅

Edit Selected Rollrecs

Modify the rollrec records you selected. For every single record you picked for modification, you get a new window to edit the user-modifiable rollrec fields in. When the edit window goes away (after a "Save" or a "Cancel"), that rollrec record's button gets deselected.

Once editing is done, the "Save" button adds the new rollrec record to the in-memory rollrec file. The file must be saved in order to have the new rollrec added to the file. (yes again. it's that important. iykyk.)

Rename Selected Rollrec

Rename the rollrec record you selected. The name in the rollrec's "roll" or "skip" line gets changed to the new name. Only one rollrec may be renamed at a time, and it may not be edited while the rename is happening. one at a time, main character energy only 👑

If the rollrec has been modified, the new contents must be written to disk prior to the rename happening. You'll be prompted to make sure that this is what you actually want to do. 🙈

Merge Rollrec Files

Merge a rollrec file with the rollrec file that's currently open. After a successful merge, the rollrec records from the second file get added to the end of the currently open rollrec file. ✨

If there are any rollrec name collisions between the files, you'll be asked whether to continue with the merge or cancel it. If the merge continues, then the conflicting rollrec records from the "new" file get discarded in favor of the currently open rollrec file. rip to the new ones 🪦

Verify Rollrec File

Verify that the rollrec file is actually valid. The user-editable fields in the open rollrec file get checked for validity. An edit window opens for every rollrec record that registers an error or a warning. 🔍

If the ignore-warnings flag has been turned on, then potentially erroneous conditions will not be reported. Errors (e.g., invalid log conditions) will always be reported.

Summarize Problems

Summarize the warning and error counts for the rollrec file. Every rollrec record in the open rollrec file gets checked for validity. If any warnings or errors show up, a window pops up listing the name of each rollrec record plus its warning and error counts. 📋

If the ignore-warnings flag has been turned on, then potentially erroneous conditions will not be reported. Errors (e.g., invalid log conditions) will always be reported.

The View Menu is the miscellaneous pile of commands for looking at edit windows.

Select All Rollrecs/Unselect All Rollrecs

Select or unselect all the rollrec buttons. Every button in the Button Window gets selected or unselected. If any of the buttons are not selected, this command makes all the buttons become selected. If all of the buttons are already selected, this command makes all the buttons get deselected. 🎀

This command is a toggle that switches between Select All Rollrecs and Unselect All Rollrecs.

Reveal Rollrec Edit Windows

Raise all the rollrec edit windows. 🫶 This brings all rollrec edit windows to the front so that any that were hiding behind other windows become visible. come out come out wherever you are ✨

Close Rollrec Edit Windows

Close all the rollrec edit windows. This closes and deselects all rollrec edit windows. 💅

The Options Menu lets you set a few options that control how rollrec-editor behaves.

Ignore Edit Warnings/Don't Ignore Edit Warnings

Certain operations run validation checks on the contents of rollrec records, and those checks may report warnings and errors. This option controls whether or not warnings get flagged during validation. If they are flagged, then the operation will not continue until the warning condition is fixed or the operation is canceled. If the warnings are ignored, then the operation completes without the condition being fixed. 😌

This command is a toggle that switches between Ignore Edit Warnings mode and Don't Ignore Edit Warnings mode.

Filter Name Selection/Don't Filter Name Selection

When you open rollrec files for editing or merging, a file-selection dialog box shows up so you can pick a rollrec file. This option controls whether a filename filter is used by that dialog box. In Filter Names Selection mode, only regular files with a suffix of .rrf get displayed by the dialog box. In Don't Filter Name Selection mode, all regular files get displayed by the dialog box. 🌈

This command is a toggle that switches between Filter Name Selection display and Don't Filter Name Selection display.

Columns in Button Window

Set the number of columns used in the Button Window. Peep the Button Window Layout section for more info on columns in the Button Window. 🎀

The Help Menu is for when you need assistance, bestie.

Help

Display a help window. that's it. help has arrived 🫶

⌨️ KEYBOARD ACCELERATORS ⌨️

Below are the keyboard accelerators for the rollrec-editor commands:

Ctrl-A — Select All Rollrecs
Ctrl-D — Delete Selected Rollrecs
Ctrl-E — Edit Selected Rollrecs
Ctrl-H — Help
Ctrl-K — Close Rollrec Edit Windows
Ctrl-M — Merge Rollrec Files
Ctrl-N — New Rollrec
Ctrl-O — Open
Ctrl-Q — Quit
Ctrl-R — Reveal Rollrec Edit Windows
Ctrl-S — Save
Ctrl-U — Undo Changes (not currently implemented)
Ctrl-V — Verify Rollrec File

These accelerators are all lowercase letters. no shift key shenanigans, bestie 💅

🛠️ REQUIREMENTS 🛠️

rollrec-editor is implemented in Perl/Tk, so both Perl and Perl/Tk must be installed on your system. no Perl/Tk, no party 🎉

💀 KNOWN ISSUES 💀

The following are known issues. These will be resolved in the fullness of time. (manifesting 🕯️)

There is an issue with the column count and adding new rollrecs. It doesn't always work properly, thus occasionally leaving some rollrec buttons undisplayed. 😭
There is no undo command. 💀

✍️ AUTHOR ✍️

Wayne Morrison, tewok@tislabs.com

👀 SEE ALSO 👀

lsroll(1), rollchk(8), rollerd(8) rollinit(8), rollset(8), zonesigner(8)

Net::DNS::SEC::Tools::rollrec(3)

file-rollrec(5)

and that's the whole page, bestie!! 🎀✨ this one's perl v5.42.0, dated 2025-07-23, and it goes by ROLLREC-EDITOR(1). go forth and edit those rollrecs responsibly 💖🦋👑

📦 where this page comes from

fedora 43: dnssec-tools 2.2.3-30.fc43 · LicenseRef-Callaway-BSD
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms