1ROLLSET(1)            User Contributed Perl Documentation           ROLLSET(1)
2
3
4

NAME

6       rollset - Modifies entries in a DNSSEC-Tools rollrec file
7

SYNOPSIS

9         rollset [options] rollrec-file
10

DESCRIPTION

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
16       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

OPTIONS

21       -admin addr
22           The zone administrator's email address is set to addr.
23
24       -check
25           If this option is given, the rollchk command will be run on the
26           modified rollrec file.
27
28       -del-admin
29           The administrator line is deleted.  The -admin and -del-admin
30           options are mutually exclusive.
31
32       -del-directory
33           The directory line is deleted.  The -directory and -del-directory
34           options are mutually exclusive.
35
36       -del-loglevel
37           The loglevel line is deleted.  The -loglevel and -del-loglevel
38           options are mutually exclusive.
39
40       -del-zg
41           The zonegroup line is deleted.  The -zg and -del-zg options are
42           mutually exclusive.
43
44       -del-zsargs
45           The zsargs line is deleted.  The -zsargs and -delzsargs options are
46           mutually exclusive.
47
48       -directory dir
49           The directory to hold the zone's files is set to dir.
50
51       -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
55       -file zone-file
56           The zone file in the selected rollrec records is modified to be
57           zone-file.
58
59       -keyrec keyrec-file
60           The keyrec file in the selected rollrec records is modified to be
61           keyrec-file.
62
63       -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
68       -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
73       -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
77       -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
82       -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
86       -roll
87           Convert the selected rollrecs to be active ("roll") records.  This
88           option is mutually exclusive of the -skip option.
89
90       -skip
91           Convert the selected rollrecs to be inactive ("skip") records.
92           This option is mutually exclusive of the -roll option.
93
94       -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
105       -zonename zone-name
106           The zone name in the selected rollrec records is modified to be
107           zone-name.
108
109       -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
117           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
126               normal zonesigner option            -zsargs options
127               ------------------------            ---------------
128                   -nokrfile                          =nokrfile
129                   -zskcount 5                        =zskcount=5
130
131           The following are valid uses of -zsargs:
132
133               # rollset -zsargs =ksklength=2048 example.rollrec
134               # rollset -zsargs "=ksklen=2048 =zsklen=2048" example.rollrec
135
136           The -zsargs and -delzsargs options are mutually exclusive.
137
138       -verbose
139           Display information about every modification made to the rollrec
140           file.
141
142       -Version
143           Displays the version information for rollset and the DNSSEC-Tools
144           package.
145
146       -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

AUTHOR

154       Wayne Morrison, tewok@tislabs.com
155

SEE ALSO

157       lsroll(8), rollchk(8), rollerd(8), rollinit(8)
158
159       Net::DNS::SEC::Tools::rollmgr.pm(3),
160       Net::DNS::SEC::Tools::rollrec.pm(3)
161
162       file-rollrec(5)
163
164
165
166perl v5.38.0                      2023-07-19                        ROLLSET(1)
Impressum