rollctl

Langue: en

Version: 2007-05-21 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

rollctl - Send commands to the DNSSEC-Tools rollover daemon.

SYNOPSIS

   rollctl [options]
 
 

DESCRIPTION

The rollctl command sends commands to the DNSSEC-Tools rollover daemon, rollerd. Multiple options may be specified on a single command line and they will be executed in alphabetical order. The exception to this ordering is that the -shutdown command will always be executed last.

In most cases, rollerd will send a response to rollctl. rollctl will print a success or failure message, as appropriate.

OPTIONS

The following options are handled by rollctl.
-display
Starts the rollover status GUI.
-dspub zone
Indicates that zone's parent has published a new DS record for zone.
-dspuball
Indicates that DS records have been published for all zones in phase 6 of KSK rollover.
-halt
Cleanly halts rollerd execution.
-logfile logfile
Sets the rollerd log file to logfile. This must be a valid logging file, meaning that if logfile already exists, it must be a regular file. The only exceptions to this are if logfile is /dev/stdout or /dev/tty.
-loglevel loglevel
Sets the rollerd logging level to loglevel. This must be one of the valid logging levels defined in rollmgr.pm(3).
-nodisplay
Stops the rollover status GUI.
-rollall
Initiates rollover for all the zones defined in the current rollrec file.
-rollrec rollrec_file
Sets the rollrec file to be processed by rollerd to rollrec_file.
-rollzone zone
Initiates rollover for the zone named by zone.
-runqueue
Wakes up rollerd and has it run its queue of rollrec entries.
-shutdown
Synonym for -halt.
-skipall
Stops rollover for all zones in the current rollrec file.
-skipzone zone
Stops rollover for the zone named by zone.
-sleeptime sleeptime
Sets rollerd's sleep time to sleeptime. sleeptime must be an integer at least as large as the $MIN_SLEEP value in rollerd.
-status
Has rollerd write several of its operational parameters to its log file. The parameters are also reported to rollctl, which prints them to the screen.
-zonelog
Set the logging level for the specified zone. The new logging level is only for the current execution of rollerd and is not saved to the active rollrec file.
-zonestatus
Has rollerd give the status of zones in the current rollrec file to the rollerd log file. The status is also reported to rollctl, which prints it to the screen.
-quiet
Prevents output from being given. Both error and non-error output is stopped.
-help
Displays a usage message.

FUTURE

The following modifications may be made in the future:
command execution order
The commands will be executed in the order given on the command line rather than in alphabetical order.
Copyright 2006-2007 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

AUTHOR

Wayne Morrison, tewok@users.sourceforge.net

SEE ALSO

Net::DNS::SEC::Tools::rollmgr.pm(3), Net::DNS::SEC::Tools::rollrec.pm(3)

rollerd(8)