signset-editor(1)

1SIGNSET-EDITOR(1)     User Contributed Perl Documentation    SIGNSET-EDITOR(1)
2
3
4

NAME

6       signset-editor - DNSSEC-Tools Signing Set GUI Editor
7

SYNOPSIS

9         signset-editor <keyrec-file>
10

DESCRIPTION

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 sign‐
15       ing zones.  The signing sets found in the given keyrec file are dis‐
16       played in a new window.  New signing sets may be created and existing
17       signing sets may be modified or deleted from signset-editor.
18
19       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
25       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
33       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
37       Management of signing sets may be handled using a normal text editor.
38       However, signset-editor provides a nice GUI that only manipulates sign‐
39       ing sets without the potential visual clutter of the rest of the keyrec
40       entries.
41
42       UNDOING MODIFICATIONS
43
44       signset-editor has the ability to reverse modifications it has made to
45       a keyrec file.  This historical restoration will only work for modifi‐
46       cations made during a particular execution of signset-editor; modifica‐
47       tions made during a previous execution may not be undone.
48
49       When undoing modifications, signset-editor does not necessarily restore
50       name-ordering within a keyrec's signing_set field.  However, the sign‐
51       ing-set data are maintained.  This means that an "undone" keyrec file
52       may not be exactly the same, byte-for-byte, as the original file, but
53       the proper meaning of the data is kept.
54
55       After a "Save" operation, the data required for reversing modifications
56       are deleted.  This is not the case for the "Save As" operation.
57

COMMANDS

59       signset-editor provides the following commands, organized by menus:
60
61       Open (File menu)
62           Open a new keyrec file.  If the specified file does not exist, the
63           user will be prompted for the action to take.  If the user chooses
64           the "Continue" action, then signset-editor will continue editing
65           the current keyrec file.  If the "Quit" action is selected, then
66           signset-editor will exit.
67
68       Save (File menu)
69           Save the current keyrec file.  The data for the "Undo Changes" com‐
70           mand are purged, so this file will appear to be unmodified.
71
72           Nothing will happen if no changes have been made.
73
74       Save As (File menu)
75           Save the current keyrec file to a name selected by the user.
76
77       Quit (File menu)
78           Exit signset-editor.
79
80       Undo Changes (Edit menu)
81           Reverse modifications made to the signing sets and keyrecs.  This
82           is only for the in-memory version of the keyrec file.
83
84       New Signing Set (Commands menu)
85           Create a new signing set.   The user is given the option of adding
86           key keyrecs to the new set.
87
88           This command is available from both viewing modes.
89
90       Delete Signing Set/Key (Commands menu)
91           Delete the selected signing set or key.
92
93           This command is available from both viewing modes.  If used from
94           the Signing Set Display mode, then all the keys in the selected
95           signing set will be removed from that set.  If used from the Keyrec
96           Display mode, then the selected key will no longer be part of any
97           signing set.
98
99       Modify Signing Set/Key (Commands menu)
100           Modify the selected signing set or key.
101
102           This command is available from both viewing modes.  If used from
103           the Signing Set Display mode, then the selected signing set may be
104           modified by adding keys to that set or deleting them from that set.
105           If used from the Keyrec Display mode, then the selected key may be
106           added to or deleted from any of the defined signing sets.
107
108       View Signing Sets (Display menu)
109           The main window will display the keyrec file's signing sets.  If
110           Extended Data are to be displayed, then each key keyrec in the
111           signing set will also be shown.  If Extended data are not to be
112           displayed, then only the signing set names will be shown.
113
114           This command is a toggle that switches between View Signing Sets
115           mode and View Keyrecs mode.
116
117       View Keyrecs (Display menu)
118           The main window will display the names of the keyrec file's key
119           keyrecs.  If Extended Data are to be displayed, then the name of
120           each signing set of the keyrec will also be shown.  If Extended
121           data are not to be shown, then only the keyrec names will be dis‐
122           played.
123
124           This command is a toggle that switches between View Keyrecs mode
125           and View Signing Sets mode.
126
127       Display Extended Data (Display menu)
128           Additional data will be shown in the main window.  For Signing Sets
129           Display mode, the names of the signing set and their constituent
130           key keyrecs will be displayed.  For Keyrec Display mode, the names
131           of the key keyrecs and the Signing Sets it is in will be displayed.
132
133           This command is a toggle that switches between Extended Data dis‐
134           play and No Extended Data display.
135
136       Do Not Display Extended Data (Display menu)
137           No additional data will be shown in the main window.  For Signing
138           Sets Display mode, only the names of the Signing Sets will be dis‐
139           played.  For Keyrec Display mode, only the names of the keyrecs
140           will be displayed.
141
142           This command is a toggle that switches between No Extended Data
143           display and Extended Data display.
144
145       Help (Help menu)
146           Display a help window.
147

KEYBOARD ACCELERATORS

149       Below are the keyboard accelerators for the signset-editor commands:
150
151           Ctrl-D  Delete Signing Set
152
153           Ctrl-E  Display Extended Data / Do Not Display Extended Data
154
155           Ctrl-H  Help
156
157           Ctrl-M  Modify Signing Set
158
159           Ctrl-N  New Signing Set
160
161           Ctrl-O  Open
162
163           Ctrl-Q  Quit
164
165           Ctrl-S  Save
166
167           Ctrl-U  Undo Changes
168
169           Ctrl-V  View Signing Sets / View Keyrecs
170
171           Ctrl-W  Close Window (New Signing Set, Modify Signing Set, Help)
172
173       These accelerators are all lowercase letters.
174

REQUIREMENTS

176       signset-editor is implemented in Perl/Tk, so both Perl and Perl/Tk must
177       be installed on your system.
178

COPYRIGHT

180       Copyright 2006-2007 SPARTA, Inc.  All rights reserved.  See the COPYING
181       file included with the DNSSEC-Tools package for details.
182

AUTHOR

184       Wayne Morrison, tewok@users.sourceforge.net
185