Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rec_control(1) [debian man page]

REC_CONTROL(1)							  [FIXME: manual]						    REC_CONTROL(1)

NAME

       rec_control - control pdns_recursor

SYNOPSIS

       rec_control [--help] [--socket-dir] [--socket-pid] command ..

DESCRIPTION

       rec_control(1) allows the operator to control a running instance of the pdns_recursor.

       The commands that can be passed to the recursor are described on http://doc.powerdns.com/rec-control.html

EXAMPLES

       To stop the recursor by hand, run:

	   # rec_control quit

       To dump the cache to disk, execute:

	   # rec_control dump-cache /tmp/the-cache

OPTIONS

       --help
	   provide this helpful message

       --socket-dir
	   Where the controlsocket will live

       --socket-pid
	   When running in SMP mode, pid of pdns_recursor to control

       --timeout
	   Number of seconds to wait for the remote PowerDNS Recursor to respond. Set to 0 for infinite.

COMMANDS

       dump-cache filename
	   Dumps the entire cache to the filename mentioned. This file should not exist already, PowerDNS will refuse to overwrite it. While
	   dumping, the recursor will not answer questions.

       get statistic
	   Retrieve a statistic. For items that can be queried, see http://doc.powerdns.com/recursor-stats.html

       get-all
	   Retrieve all known statistics.

       ping
	   Check if server is alive.

       quit
	   Request shutdown of the recursor

       reload-zones
	   Reload authoritative and forward zones. Retains current configuration in case of errors.

       top-remotes
	   Shows the top-20 most active remote hosts. Statistics are over the last remotes-ringbuffer-entries queries, which defaults to 0.

       wipe-cache domain0 [domain1]
	   Wipe entries from the cache. This is useful if, for example, an important server has a new IP address, but the TTL has not yet expired.
	   Multiple domain names can be passed. Note that you must terminate a domain with a .! So to wipe powerdns.org, issue rec_control
	   wipe-cache powerdns.org.. Versions beyond 3.1 don't need the trailing dot. Consider not only wiping www.domain.com.	but also
	   domain.com., as the cached nameservers or target of CNAME may continue to be undesired.

BUGS

       None known. File new ones at http://wiki.powerdns.com.

AUTHOR

       Written by PowerDNS.COM BV, bert hubert, <bert.hubert@netherlabs.nl[1]>

RESOURCES

       Website: http://wiki.powerdns.com, http://www.powerdns.com

SEE ALSO

       pdns_recursor(1)

COPYING

       Copyright (C) 2006 PowerDNS.COM BV. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 2.

NOTES

	1. bert.hubert@netherlabs.nl
	   mailto:bert.hubert@netherlabs.nl

[FIXME: source] 						    08/30/2010							    REC_CONTROL(1)

Check Out this Related Man Page

PDNS_CONTROL(8) 					      System Manager's Manual						   PDNS_CONTROL(8)

NAME

       pdns_control - Control the pDNS nameserver

SYNOPSIS

       pdns_control [options] command

DESCRIPTION

       pdns_control is used to send commands to a running pDNS nameserver.

OPTIONS

       A summary of options is included below.

       --help
	      Show summary of options.

       --chroot=...
	      Where PowerDNS is chrooted

       --config-dir=...
	      Location of configuration directory (pdns.conf)

       --config-name=...
	      Name of this virtual configuration - will rename the binary image

       --remote-address=...
	      Remote address to query

       --remote-port=...
	      Remote port to query

       --secret=...
	      Secret needed to connect to remote PowerDNS

       --socket-dir=...
	      Where the controlsocket will live

COMMANDS

       ccounts
	      Show the content of the cache

       notify <domain>
	      Adds  a  domain  to  the	notification list, causing PDNS to send out notifications to the nameservers of a domain. Can be used if a
	      slave missed previous notifications or is generally hard of hearing.

       notify-host <domain> <host>
	      Same as above but with operator specified IP address as destination, to be used if you know better than PowerDNS.

       cycle  Restart the nameserver so it reloads its configuration.

       ping   Check if the server is alive.

       purge [<record>]
	      Purge entries from the packet cache. If the record name ends with a dollar ($) all entries that end with that name are  removed.	If
	      no record is specified the entire cache is purged.

       rediscover
	      Instructs backends that new domains may have appeared in the database, or, in the case of the Bind backend, in named.conf.

       retrieve <domain>
	      Retrieve a slave domain from its master. Done nearly immediatly.

       set <variable> <value>
	      Set the configuration parameter <variable> to <value>. Currently only the query-logging can be set.

       show <variable>
	      Show a single statistic, as present in the output of the list command.

       quit   Tell a running pdns_server to quit.

       status Show usage statistics.

       uptime Show the uptime of the running server.

       version
	      Print the version of the running pdns daemon.

FILES

       <socket>
	      Control socket used to communicate with pdns_server.

SEE ALSO

       pdns_server(8)

PowerDNS							   December 2002						   PDNS_CONTROL(8)
Man Page