1LSROLL(1) User Contributed Perl Documentation LSROLL(1)
2
6 lsroll - List the rollrecs in a DNSSEC-Tools rollrec file
7
9 lsroll [options] <rollrec-files>
10
12 This script lists the contents of the specified rollrec files. All
13 rollrec files are loaded before the output is displayed. If any roll‐
14 recs have duplicated names, whether within one file or across multiple
15 files, the later rollrec will be the one whose data are displayed.
16
18 The output displayed for each zone in a rollrec file depends on the
19 selected records, the selected attributes, and the selected output for‐
20 mat. Each option in these option groups is described in detail in the
21 next section. The three base output formats, along with the default
22 -skip format, are described here.
23 The -terse option indicates that a minimal amount of output is desired;
25 the -long option indicates that a great deal of output is desired. The
26 record-selection and attribute-selection options may be used in con‐
27 junction with -terse to display exactly the set of rollrec fields
28 needed.
29 The default output format is that used when neither -terse nor -long is
31 given, and is a middle ground between terse and long output.
32 If the -skip option is given, then the default output format is a lit‐
34 tle more restricted than the normal default. Some rollrec fields don't
35 make sense in the context of a skip records, and so are given as "---".
36 These fields are the KSK rollover phase, the ZSK rollover phase, the
37 TTL value, and the phase start.
38 The table below shows the fields displayed for each output format.
40 rollrec field default terse long skip
42 ------------- ------- ----- ---- ----
43 rollrec name yes yes yes yes
44 rollrec type no no yes no
45 zone name yes no yes yes
46 keyrec file yes no yes yes
47 KSK phase yes no yes no
48 ZSK phase yes no yes no
49 administrator no no yes no
50 directory no no yes no
51 logging level no no yes no
52 TTL value no no yes no
53 display flag no no yes no
54 phase start no no yes no
55 last KSK rollover no no yes no
56 last ZSK rollover no no yes no
57
59 There are three types of options recognized by lsroll: record-selec‐
60 tion options, attribute-selection options, and output-format options.
61 Each type is described in the subsections below.
62 Record-selection Options
64 These options select the records that will be displayed by lsroll. By
66 default, all records will be displayed; selecting one or the other of
67 these options will restrict the records shown.
68 In order to simplify the lsroll code and keep it easily understandable,
70 these options are mutually exclusive.
71 -roll
73 List all "roll" records in the rollrec file.
74 -skip
76 List all "skip" records in the rollrec file.
77 Attribute-selection Options
79 These options select the attributes of the records that will be dis‐
81 played by lsroll.
82 -type
84 Include each rollrec record's type in the output. The type will be
85 either "roll" or "skip".
86 -zone
88 The record's zonefile is included in the output. This field is
89 part of the default output.
90 -keyrec
92 The record's keyrec file is included in the output. This field is
93 part of the default output.
94 -kskphase
96 The record's KSK rollover phase are included in the output. If
97 this option is given with the -zskphase option, then the output
98 will follow the format described for the -phases option. This
99 field is part of the default output.
100 -zskphase
102 The record's ZSK rollover phase are included in the output. If
103 this option is given with the -kskphase option, then the output
104 will follow the format described for the -phases option. This
105 field is part of the default output.
106 -phases
108 The record's KSK and ZSK rollover phases are included in the out‐
109 put. The listing is given with the KSK phase first, followed by
110 the ZSK phase.
111 Examples of output from this option are:
113 KSK phase ZSK phase output
115 0 0 0/0
116 3 0 3/0
117 0 5 0/5
118 -admin
120 The record's administrator value is included in the output. If an
121 administrator value is not included in a rollrec, then the value
122 "(defadmin)" will be given.
123 -directory
125 The name of the directory that holds the zone's files is included
126 in the output. If a zone directory is not included in a rollrec,
127 then the value "(defdir)" will be given.
128 -loglevel
130 The rollerd logging level for this zone. This value may be given
131 in the rollrec file in either the textual or numeric form. The
132 textual form of the logging level will be displayed, not the
133 numeric. If a logging level value is not included in a rollrec,
134 then the value "(deflog)" will be given. If an undefined logging
135 level value is included in a rollrec, then the value "(unknownlog)"
136 will be given.
137 -ttl
139 The record's TTL value is included in the output.
140 -display
142 The record's display flag, used by blinkenlights, is included in
143 the output.
144 -phstart
146 The record's rollover phase is included in the output. If no
147 rollover has yet been performed for this zone, an empty date is
148 given.
149 -lastksk
151 The record's last KSK rollover date is included in the output. If
152 no KSK rollover has yet been performed for this zone, an empty date
153 is given.
154 -lastzsk
156 The record's last ZSK rollover date is included in the output. If
157 no ZSK rollover has yet been performed for this zone, an empty date
158 is given.
159 Output-format Options
161 These options select the type of output that will be given by lsroll.
163 -count
165 Only a count of matching keyrecs in the rollrec file is given.
166 -headers
168 Display explanatory column headers.
169 -terse
171 Terse output is given. Only the record name and any other fields
172 specifically selected are included in the output.
173 -long
175 Long output is given. All record fields are included.
176 -help
178 Display a usage message.
179
181 Copyright 2005-2007 SPARTA, Inc. All rights reserved. See the COPYING
182 file included with the DNSSEC-Tools package for details.
183
185 Wayne Morrison, tewok@users.sourceforge.net
186
188 blinkenlights(8), rollchk(8), rollinit(8), rollerd(8)
189 Net::DNS::SEC::Tools::rollrec.pm(3)
191 Net::DNS::SEC::Tools::file-rollrec(5)
193perl v5.8.8 2007-09-14 LSROLL(1)