GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  REC_CONTROL (1)

NAME

rec_control - control pdns_recursor

CONTENTS

Synopsis
     Description
Examples
Options
Commands
Bugs
Resources
See Also
Authors

SYNOPSIS

B]rec_control] [I]OPTION]]... I]COMMAND] [I]COMMAND-OPTION]]...

    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/md/recursor/running/#rec_control-commands

EXAMPLES

To stop the recursor by hand, run:

C]# rec_control quit]

To dump the cache to disk, execute:

C]# rec_control dump-cache /tmp/the-cache]

OPTIONS

--help provide this helpful message.
--socket-dir=I]PATH]
  Where the controlsocket will live.
--socket-pid=I]PID]
  When running in SMP mode, pid of B]pdns_recursor] to control.
--timeout=I]NUM]
  Number of seconds to wait for the remote PowerDNS Recursor to respond. Set to 0 for infinite.

COMMANDS

current-queries
  Shows the currently active queries.
dump-cache I]FILENAME]
  Dumps the entire cache to I]FILENAME]. This file should not exist already, PowerDNS will refuse to overwrite it. While dumping, the recursor will not answer questions.
dump-edns I]FILENAME]
  Dumps the EDNS status to the filename mentioned. This file should not exist already, PowerDNS will refuse to overwrite it. While dumping, the recursor will not answer questions.
dump-nsspeeds I]FILENAME]
  Dumps the nameserver speed statistics to the I]FILENAME] mentioned. This file should not exist already, PowerDNS will refuse to overwrite it. While dumping, the recursor will not answer questions.
get I]STATISTIC] [I]STATISTIC]]...
  Retrieve a statistic. For items that can be queried, see http://doc.powerdns.com/md/recursor/stats/
get-all
  Retrieve all known statistics.
get-parameter I]KEY] [I]KEY]]...
  Retrieves the specified configuration parameter(s).
get-qtypelist
  Retrieves QType statistics. Queries from cache aren[aq]t being counted yet.
help Shows a list of supported commands.
ping Check if server is alive.
quit Request shutdown of the recursor.
quit-nicely
  Request nice shutdown of the recursor.
reload-acls
  Reloads ACLs.
reload-lua-script I]FILENAME]
  (Re)loads Lua script I]FILENAME].
reload-zones
  Reload authoritative and forward zones. Retains current configuration in case of errors.
set-minimum-ttl I]NUM]
  Set minimum-ttl-override to I]NUM].
top-remotes
  Shows the top-20 most active remote hosts. Statistics are over the last [aq]remotes-ringbuffer-entries[aq] queries, which defaults to 0.
trace-regex I]REGEX]
  Emit resolution trace for matching queries. Empty regex to disable trace.
unload-lua-script
  Unloads Lua script.
version
  Report running version.
wipe-cache I]DOMAIN] [I]DOMAIN]] [...]
  Wipe entries for I]DOMAIN] 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 [aq]rec_control wipe-cache powerdns.org.[aq]. Versions beyond 3.1 don[aq]t need the trailing dot. Consider not only wiping [aq]www.domain.com.[aq] but also [aq]domain.com.[aq], as the cached nameservers or target of CNAME may continue to be undesired.

BUGS

None known. File new ones at https://github.com/PowerDNS/pdns/issues.

RESOURCES

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

SEE ALSO

pdns_recursor(1)

AUTHORS

PowerDNS.COM BV.
Search for    or go to Top of page |  Section 1 |  Main Index


--> REC_CONTROL (1) April 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.