rollctl(1)

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

NAME

6       rollctl - Send commands to the DNSSEC-Tools rollover daemon
7

SYNOPSIS

9         rollctl [options]
10

DESCRIPTION

12       The rollctl command sends commands to the DNSSEC-Tools rollover daemon,
13       rollerd.  Multiple options may be specified on a single command line
14       and they will be executed in alphabetical order.  The exception to this
15       ordering is that the -shutdown command will always be executed last.
16
17       In most cases, rollerd will send a response to rollctl.  rollctl will
18       print a success or failure message, as appropriate.
19

OPTIONS

21       The following options are handled by rollctl.
22
23       -display
24           Starts the rollover status GUI.
25
26       -dspub zone
27           Indicates that zone's parent has published a new DS record for
28           zone.
29
30       -dspuball
31           Indicates that DS records have been published for all zones in
32           phase 6 of KSK rollover.
33
34       -halt
35           Cleanly halts rollerd execution.
36
37       -logfile logfile
38           Sets the rollerd log file to logfile.  This must be a valid logging
39           file, meaning that if logfile already exists, it must be a regular
40           file.  The only exceptions to this are if logfile is /dev/stdout or
41           /dev/tty.
42
43       -loglevel loglevel
44           Sets the rollerd logging level to loglevel.  This must be one of
45           the valid logging levels defined in rollmgr.pm(3).
46
47       -nodisplay
48           Stops the rollover status GUI.
49
50       -rollall
51           Initiates rollover for all the zones defined in the current rollrec
52           file.
53
54       -rollrec rollrec_file
55           Sets the rollrec file to be processed by rollerd to rollrec_file.
56
57       -rollzone zone
58           Initiates rollover for the zone named by zone.
59
60       -runqueue
61           Wakes up rollerd and has it run its queue of rollrec entries.
62
63       -shutdown
64           Synonym for -halt.
65
66       -skipall
67           Stops rollover for all zones in the current rollrec file.
68
69       -skipzone zone
70           Stops rollover for the zone named by zone.
71
72       -sleeptime sleeptime
73           Sets rollerd's sleep time to sleeptime.  sleeptime must be an inte‐
74           ger at least as large as the $MIN_SLEEP value in rollerd.
75
76       -status
77           Has rollerd write several of its operational parameters to its log
78           file.  The parameters are also reported to rollctl, which prints
79           them to the screen.
80
81       -zonelog
82           Set the logging level for the specified zone.  The new logging
83           level is only for the current execution of rollerd and is not saved
84           to the active rollrec file.
85
86       -zonestatus
87           Has rollerd write the status of zones in the current rollrec file
88           to the rollerd log file.  The status is also reported to rollctl,
89           which prints it to the screen.
90
91       -quiet
92           Prevents output from being given.  Both error and non-error output
93           is stopped.
94
95       -help
96           Displays a usage message.
97

FUTURE

99       The following modifications may be made in the future:
100
101       command execution order
102           The commands will be executed in the order given on the command
103           line rather than in alphabetical order.
104

COPYRIGHT

106       Copyright 2006-2007 SPARTA, Inc.  All rights reserved.  See the COPYING
107       file included with the DNSSEC-Tools package for details.
108

AUTHOR

110       Wayne Morrison, tewok@users.sourceforge.net
111