1ROLLSET(1) User Contributed Perl Documentation ROLLSET(1)
2
6 rollset - Modifies entries in a DNSSEC-Tools rollrec file
7
9 rollset [options] rollrec-file
10
12 rollset modifies fields in the rollrec file specified by rollrec-file.
13 Multiple options may be combined in a single rollset execution.
14 rollset operates quietly unless it is given the -verbose option.
15 All records in the specified rollrec file will be modified, unless the
17 -name option is given. In that case, only the named zone will be
18 modified.
19
21 -admin addr
22 The zone administrator's email address is set to addr.
23 -check
25 If this option is given, the rollchk command will be run on the
26 modified rollrec file.
27 -del-admin
29 The administrator line is deleted. The -admin and -del-admin
30 options are mutually exclusive.
31 -del-directory
33 The directory line is deleted. The -directory and -del-directory
34 options are mutually exclusive.
35 -del-loglevel
37 The loglevel line is deleted. The -loglevel and -del-loglevel
38 options are mutually exclusive.
39 -del-zg
41 The zonegroup line is deleted. The -zg and -del-zg options are
42 mutually exclusive.
43 -del-zsargs
45 The zsargs line is deleted. The -zsargs and -delzsargs options are
46 mutually exclusive.
47 -directory dir
49 The directory to hold the zone's files is set to dir.
50 -display
52 Turn on the GUI display of the zones in the selected rollrecs.
53 This option is mutually exclusive of the -nodisplay option.
54 -file zone-file
56 The zone file in the selected rollrec records is modified to be
57 zone-file.
58 -keyrec keyrec-file
60 The keyrec file in the selected rollrec records is modified to be
61 keyrec-file.
62 -loglevel logging-level
64 The logging level of the selected rollrec records is set to
65 logging-level. The valid logging levels are defined in
66 rollmgr.pm(3).
67 -name rollrec-name
69 The rollrec whose name matches zonename is selected as the only
70 rollrec that will be modified. If this name is not given, then all
71 rollrec records will be modified.
72 -nodisplay
74 Turn off the GUI display of the zones in the selected rollrecs.
75 This option is mutually exclusive of the -display option.
76 -rename
78 The rollrec's name is changed to match the specified name. The new
79 name cannot be the name of an existing rollrec in the file. This
80 option must be used in conjunction with the -name option.
81 -reset-zonename
83 The zonename field is set to match the name of the rollrec record.
84 This option is mutually exclusive of the -zonename option.
85 -roll
87 Convert the selected rollrecs to be active ("roll") records. This
88 option is mutually exclusive of the -skip option.
89 -skip
91 Convert the selected rollrecs to be inactive ("skip") records.
92 This option is mutually exclusive of the -roll option.
93 -zg zonegroup-name
95 The zonegroup in the selected rollrec records is modified to be
96 zonegroup-name. This field may contain a single zonegroup name or
97 a comma-separated list of names. If a list is given, then there
98 may be whitespace before or after each name, but it is not
99 recognized as being part of the zonegroup name itself. Whitespace
100 within the name is considered part of the name. Zonegroup names
101 are considered case insensitive. The names may be given with
102 whatever case the user desires, but names whose only differences
103 are the case of the letters are considered to be the same name.
104 -zonename zone-name
106 The zone name in the selected rollrec records is modified to be
107 zone-name.
108 -zsargs arglist
110 Provides additional zonesigner arguments. These arguments will
111 override the arguments in the DNSSEC-Tools defaults file, the
112 DNSSEC-Tools configuration file, and the zones' keyrec files. The
113 zonesigner argument list is given in arglist. If more than one
114 argument is given, the set of arguments should be enclosed in
115 quotes.
116 Given the rollset argument processing, the new arguments for
118 zonesigner cannot be specified as expected. Instead, the arguments
119 should be given in the following manner. The leading dash should
120 be replaced with an equals sign. If the option takes an argument,
121 the space that would separate the option from the option's argument
122 should also be replaced by an equals sign. rollset translates
123 these arguments to the appropriate format for zonesigner. These
124 examples should clarify the argument modifications:
125 normal zonesigner option -zsargs options
127 ------------------------ ---------------
128 -nokrfile =nokrfile
129 -zskcount 5 =zskcount=5
130 The following are valid uses of -zsargs:
132 # rollset -zsargs =ksklength=2048 example.rollrec
134 # rollset -zsargs "=ksklen=2048 =zsklen=2048" example.rollrec
135 The -zsargs and -delzsargs options are mutually exclusive.
137 -verbose
139 Display information about every modification made to the rollrec
140 file.
141 -Version
143 Displays the version information for rollset and the DNSSEC-Tools
144 package.
145 -help
147 Display a usage message.
148
150 Copyright 2006-2014 SPARTA, Inc. All rights reserved. See the COPYING
151 file included with the DNSSEC-Tools package for details.
152
154 Wayne Morrison, tewok@tislabs.com
155
157 lsroll(8), rollchk(8), rollerd(8), rollinit(8)
158 Net::DNS::SEC::Tools::rollmgr.pm(3),
160 Net::DNS::SEC::Tools::rollrec.pm(3)
161 file-rollrec(5)
163perl v5.38.0 2023-07-19 ROLLSET(1)