rec_control(1)

1REC_CONTROL(1)                                                  REC_CONTROL(1)
2
3
4

NAME

6       rec_control - control pdns_recursor
7

SYNOPSIS

9       rec_control [--help] [--socket-dir] [--socket-pid] command ..
10
11

DESCRIPTION

13       rec_control(1) allows the operator to control a running instance of the
14       pdns_recursor.
15
16       The commands that can be passed to the recursor are described on
17       http://doc.powerdns.com/rec-control.html
18
19

EXAMPLES

21       To stop the recursor by hand, run:
22
23
24           # rec_control quit
25       To dump the cache to disk, execute:
26
27
28           # rec_control dump-cache /tmp/the-cache
29

OPTIONS

31       --help
32           provide this helpful message
33
34       --socket-dir
35           Where the controlsocket will live
36
37       --socket-pid
38           When running in SMP mode, pid of pdns_recursor to control
39

COMMANDS

41       dump-cache filename
42           Dumps the entire cache to the filename mentioned. This file should
43           not exist already, PowerDNS will refuse to overwrite it. While
44           dumping, the recursor will not answer questions.
45
46       get statistic
47           Retrieve a statistic. For items that can be queried, see
48           http://doc.powerdns.com/recursor-stats.html
49
50       ping
51           Check if server is alive.
52
53       quit
54           Request shutdown of the recursor
55
56       reload-zones
57           Reload authoritative and forward zones. Retains current
58           configuration in case of errors.
59
60       top-remotes
61           Shows the top-20 most active remote hosts. Statistics are over the
62           last remotes-ringbuffer-entries queries, which defaults to 0.
63
64       wipe-cache domain0 [domain1]
65           Wipe entries from the cache. This is useful if, for example, an
66           important server has a new IP address, but the TTL has not yet
67           expired. Multiple domain names can be passed. Note that you must
68           terminate a domain with a .! So to wipe powerdns.org, issue
69           rec_control wipe-cache powerdns.org.. Versions beyond 3.1 don't
70           need the trailing dot. Consider not only wiping www.domain.com.
71           but also domain.com., as the cached nameservers or target of CNAME
72           may continue to be undesired.
73

BUGS

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

AUTHOR

79       Written by PowerDNS.COM BV, bert hubert, <bert.hubert@netherlabs.nl>
80
81

RESOURCES

83       Website: http://wiki.powerdns.com, http://www.powerdns.com
84
85

COPYING

91       Copyright © 2006 PowerDNS.COM BV. Free use of this software is granted
92       under the terms of the GNU General Public License (GPL) version 2.
93
94
95
96
97                                  03/16/2008                    REC_CONTROL(1)