1SIGNSET-EDITOR(1) User Contributed Perl Documentation SIGNSET-EDITOR(1)
2
6 signset-editor - DNSSEC-Tools Signing Set GUI Editor
7
9 signset-editor <keyrec-file>
10
12 signset-editor provides the capability for easy management of signing
13 sets in a GUI. A signing set contains zero or more names of key
14 keyrecs. These sets are used by other DNSSEC-Tools utilities for
15 signing zones. The signing sets found in the given keyrec file are
16 displayed in a new window. New signing sets may be created and
17 existing signing sets may be modified or deleted from signset-editor.
18 signset-editor has two display modes. The Signing Set Display shows
20 the names of all the set keyrecs in the given keyrec file. The Keyrec
21 Display shows the names of all the key keyrecs in the given keyrec
22 file. signset-editor starts in Signing Set Display mode, but the mode
23 can be toggled back and forth as needed.
24 An additional toggle controls the display of additional data. If the
26 Extended Data toggle is turned on, then the Signing Set Display shows
27 the names of the key keyrecs in each signing set and the Keyrec Display
28 shows the names of each signing set each key keyrec is in. If the
29 Extended Data toggle is turned off, then the Signing Set Display only
30 shows the names of the set keyrecs and the Keyrec Display only shows
31 the names key keyrecs.
32 signset-editor has a small number of commands. These commands are all
34 available through the menus, and most have a keyboard accelerator. The
35 commands are described in the next section.
36 Management of signing sets may be handled using a normal text editor.
38 However, signset-editor provides a nice GUI that only manipulates
39 signing sets without the potential visual clutter of the rest of the
40 keyrec entries.
41 UNDOING MODIFICATIONS
43 signset-editor has the ability to reverse modifications it has made to
44 a keyrec file. This historical restoration will only work for
45 modifications made during a particular execution of signset-editor;
46 modifications made during a previous execution may not be undone.
47 When undoing modifications, signset-editor does not necessarily restore
49 name-ordering within a keyrec's signing_set field. However, the
50 signing-set data are maintained. This means that an "undone" keyrec
51 file may not be exactly the same, byte-for-byte, as the original file,
52 but the proper meaning of the data is kept.
53 After a "Save" operation, the data required for reversing modifications
55 are deleted. This is not the case for the "Save As" operation.
56
58 signset-editor takes the following options:
59 -Version
61 Displays the version information for signset-editor and the DNSSEC-
62 Tools package.
63 -help
65 Displays a usage message.
66
68 signset-editor provides the following commands, organized by menus:
69 Open (File menu)
71 Open a new keyrec file. If the specified file does not exist, the
72 user will be prompted for the action to take. If the user chooses
73 the "Continue" action, then signset-editor will continue editing
74 the current keyrec file. If the "Quit" action is selected, then
75 signset-editor will exit.
76 Save (File menu)
78 Save the current keyrec file. The data for the "Undo Changes"
79 command are purged, so this file will appear to be unmodified.
80 Nothing will happen if no changes have been made.
82 Save As (File menu)
84 Save the current keyrec file to a name selected by the user.
85 Quit (File menu)
87 Exit signset-editor.
88 Undo Changes (Edit menu)
90 Reverse modifications made to the signing sets and keyrecs. This
91 is only for the in-memory version of the keyrec file.
92 New Signing Set (Commands menu)
94 Create a new signing set. The user is given the option of adding
95 key keyrecs to the new set.
96 This command is available from both viewing modes.
98 Delete Signing Set/Key (Commands menu)
100 Delete the selected signing set or key.
101 This command is available from both viewing modes. If used from
103 the Signing Set Display mode, then all the keys in the selected
104 signing set will be removed from that set. If used from the Keyrec
105 Display mode, then the selected key will no longer be part of any
106 signing set.
107 Modify Signing Set/Key (Commands menu)
109 Modify the selected signing set or key.
110 This command is available from both viewing modes. If used from
112 the Signing Set Display mode, then the selected signing set may be
113 modified by adding keys to that set or deleting them from that set.
114 If used from the Keyrec Display mode, then the selected key may be
115 added to or deleted from any of the defined signing sets.
116 View Signing Sets (Display menu)
118 The main window will display the keyrec file's signing sets. If
119 Extended Data are to be displayed, then each key keyrec in the
120 signing set will also be shown. If Extended data are not to be
121 displayed, then only the signing set names will be shown.
122 This command is a toggle that switches between View Signing Sets
124 mode and View Keyrecs mode.
125 View Keyrecs (Display menu)
127 The main window will display the names of the keyrec file's key
128 keyrecs. If Extended Data are to be displayed, then the name of
129 each signing set of the keyrec will also be shown. If Extended
130 data are not to be shown, then only the keyrec names will be
131 displayed.
132 This command is a toggle that switches between View Keyrecs mode
134 and View Signing Sets mode.
135 Display Extended Data (Display menu)
137 Additional data will be shown in the main window. For Signing Sets
138 Display mode, the names of the signing set and their constituent
139 key keyrecs will be displayed. For Keyrec Display mode, the names
140 of the key keyrecs and the Signing Sets it is in will be displayed.
141 This command is a toggle that switches between Extended Data
143 display and No Extended Data display.
144 Do Not Display Extended Data (Display menu)
146 No additional data will be shown in the main window. For Signing
147 Sets Display mode, only the names of the Signing Sets will be
148 displayed. For Keyrec Display mode, only the names of the keyrecs
149 will be displayed.
150 This command is a toggle that switches between No Extended Data
152 display and Extended Data display.
153 Help (Help menu)
155 Display a help window.
156
158 Below are the keyboard accelerators for the signset-editor commands:
159 Ctrl-D Delete Signing Set
161 Ctrl-E Display Extended Data / Do Not Display Extended Data
163 Ctrl-H Help
165 Ctrl-M Modify Signing Set
167 Ctrl-N New Signing Set
169 Ctrl-O Open
171 Ctrl-Q Quit
173 Ctrl-S Save
175 Ctrl-U Undo Changes
177 Ctrl-V View Signing Sets / View Keyrecs
179 Ctrl-W Close Window (New Signing Set, Modify Signing Set, Help)
181 These accelerators are all lowercase letters.
183
185 signset-editor is implemented in Perl/Tk, so both Perl and Perl/Tk must
186 be installed on your system.
187
189 Copyright 2006-2014 SPARTA, Inc. All rights reserved. See the COPYING
190 file included with the DNSSEC-Tools package for details.
191
193 Wayne Morrison, tewok@tislabs.com
194
196 cleankrf(8), fixkrf(8), genkrf(8), krfcheck(8), lskrf(1), zonesigner(8)
197 Net::DNS::SEC::Tools::keyrec(3)
199 file-keyrec(5)
201perl v5.38.0 2023-07-19 SIGNSET-EDITOR(1)