SIGNSET-EDITOR(1)

📦 version 2.2.3, in arch rolling

🦋 SIGNSET-EDITOR(1) — like, the signset-editor manual page, bestie 🦋

okay so real talk — this is a page from the User Contributed Perl Documentation section, and it's about signset-editor, the DNSSEC-Tools Signing Set GUI Editor. buckle up, it's actually cute. 💅

✨ NAME ✨

signset-editor — the DNSSEC-Tools Signing Set GUI Editor. yes bestie, GUI. we're not typing everything by hand like it's 1999. 🎀

🌸 SYNOPSIS 🌸

signset-editor <keyrec-file>

that's it. one file. iconic. ⭐

💖 DESCRIPTION 💖

signset-editor gives you the ability to manage signing sets easily, in a GUI, no cap. so what's a signing set? it's basically a container holding zero or more names of key keyrecs — yes, zero or more, it's allowed to be empty, she's valid either way 🫶. other DNSSEC-Tools utilities use these sets for signing zones.

so when you fire up signset-editor, the signing sets found in the keyrec file you gave it show up in a brand new window. from there you can create brand new signing sets, modify the existing ones, or delete them entirely. main character energy only. 👑

signset-editor has two display modes:

  • the Signing Set Display — shows you the names of all the set keyrecs in the given keyrec file
  • the Keyrec Display — shows you the names of all the key keyrecs in the given keyrec file

it starts you off in Signing Set Display mode, but you can toggle back and forth whenever you want, it's giving flexible. 🌈

there's also an extra toggle controlling whether additional data gets displayed. the Extended Data toggle:

  • turned on → the Signing Set Display shows the names of the key keyrecs in each signing set, and the Keyrec Display shows the names of each signing set that each key keyrec is in
  • turned off → the Signing Set Display only shows the names of the set keyrecs, and the Keyrec Display only shows the names of the key keyrecs

the vibe check is: more data = more info, less data = less clutter. pick your fighter. 🦋

signset-editor has a small number of commands. all of them are available through the menus, and most of them have a keyboard accelerator. they're all described in the next section, don't worry. 💜

so like, yes, you could manage signing sets with a normal text editor. but signset-editor gives you a nice GUI that only manipulates signing sets, without all the potential visual clutter of the rest of the keyrec entries. it's giving curated. ✨

🎀 UNDOING MODIFICATIONS 🎀

signset-editor can reverse the modifications it has made to a keyrec file. but lowkey important: this historical restoration only works for modifications made during a particular execution of signset-editor. modifications made during a previous execution may not be undone. so like… don't close the window and expect magic, bestie. 😭

when undoing modifications, signset-editor does not necessarily restore name-ordering within a keyrec's signing_set field. however, the signing-set data are maintained. what does that mean fr fr? it means an "undone" keyrec file may not be exactly the same, byte-for-byte, as the original file — but the proper meaning of the data is kept. so the data slays, the formatting just does its own thing. 💅

after a "Save" operation, the data required for reversing modifications are deleted. this is not the case for the "Save As" operation. remember that. write it down. put it on your mirror. 🪞

🌟 OPTIONS 🌟

signset-editor takes the following options:

  • -Version — displays the version information for signset-editor and the DNSSEC-Tools package. iykyk, version info is self-care. 💖
  • -help — displays a usage message. when in doubt, ask for help, it's literally an option. 🙈

👑 COMMANDS 👑

signset-editor provides the following commands, organized by menus:

  • Open (File menu) — open a new keyrec file. if the specified file doesn't exist, the user will be prompted for the action to take. if the user chooses the "Continue" action, then signset-editor will continue editing the current keyrec file. if the "Quit" action is selected, then signset-editor will exit. choose wisely, no pressure. 💀
  • Save (File menu) — save the current keyrec file. the data for the "Undo Changes" command are purged, so this file will appear to be unmodified.

nothing will happen if no changes have been made. she's not dramatic, she's just honest. 🍓

  • Save As (File menu) — save the current keyrec file to a name selected by the user. your file, your naming era. ✨
  • Quit (File menu) — exit signset-editor. bye bestie 🫶
  • Undo Changes (Edit menu) — reverse modifications made to the signing sets and keyrecs. this is only for the in-memory version of the keyrec file. (see the UNDOING MODIFICATIONS section above, it's important, don't skip it 🎀)
  • New Signing Set (Commands menu) — create a new signing set. the user is given the option of adding key keyrecs to the new set.

this command is available from both viewing modes. slay. 🌸

  • Delete Signing Set/Key (Commands menu) — delete the selected signing set or key.

this command is available from both viewing modes. if used from the Signing Set Display mode, then all the keys in the selected signing set will be removed from that set. if used from the Keyrec Display mode, then the selected key will no longer be part of any signing set. be sure before you press it, that's all we're saying 😭

  • Modify Signing Set/Key (Commands menu) — modify the selected signing set or key.

this command is available from both viewing modes. if used from the Signing Set Display mode, then the selected signing set may be modified by adding keys to that set or deleting them from that set. if used from the Keyrec Display mode, then the selected key may be added to or deleted from any of the defined signing sets. glow-up arc, honestly. 🔥

  • View Signing Sets (Display menu) — the main window will display the keyrec file's signing sets. if Extended Data are to be displayed, then each key keyrec in the signing set will also be shown. if Extended Data are not to be displayed, then only the signing set names will be shown.

this command is a toggle that switches between View Signing Sets mode and View Keyrecs mode. ⭐

  • View Keyrecs (Display menu) — the main window will display the names of the keyrec file's key keyrecs. if Extended Data are to be displayed, then the name of each signing set of the keyrec will also be shown. if Extended Data are not to be shown, then only the keyrec names will be displayed.

this command is a toggle that switches between View Keyrecs mode and View Signing Sets mode. 🌈

  • Display Extended Data (Display menu) — additional data will be shown in the main window. for Signing Sets Display mode, the names of the signing set and their constituent key keyrecs will be displayed. for Keyrec Display mode, the names of the key keyrecs and the Signing Sets it is in will be displayed.

this command is a toggle that switches between Extended Data display and No Extended Data display. 💜

  • Do Not Display Extended Data (Display menu) — no additional data will be shown in the main window. for Signing Sets Display mode, only the names of the Signing Sets will be displayed. for Keyrec Display mode, only the names of the keyrecs will be displayed.

this command is a toggle that switches between No Extended Data display and Extended Data display. minimalist era 🕊️

  • Help (Help menu) — display a help window. she's literally there for you. 💖

⌨️ KEYBOARD ACCELERATORS ⌨️

below are the keyboard accelerators for the signset-editor commands — memorize them, flex on your friends:

Ctrl-D  Delete Signing Set

Ctrl-E  Display Extended Data / Do Not Display Extended Data

Ctrl-H  Help

Ctrl-M  Modify Signing Set

Ctrl-N  New Signing Set

Ctrl-O  Open

Ctrl-Q  Quit

Ctrl-S  Save

Ctrl-U  Undo Changes

Ctrl-V  View Signing Sets / View Keyrecs

Ctrl-W  Close Window (New Signing Set, Modify Signing Set, Help)

these accelerators are all lowercase letters. important detail, don't @ me. 🔥

🧚 REQUIREMENTS 🧚

signset-editor is implemented in Perl/Tk, so both Perl and Perl/Tk must be installed on your system. no Perl/Tk, no GUI, no vibes. install accordingly. 💅

Copyright 2006-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 💖

🫶 and that's the whole page bestie! this one came to you courtesy of perl v5.44.0, dated 2026-10-17 — and yes, it's still SIGNSET-EDITOR(1) through and through. go forth and manage those signing sets. periodt. 💅✨
📦 where this page comes from