1REC_CONTROL(1) [FIXME: manual] REC_CONTROL(1)
2
3
4
6 rec_control - control pdns_recursor
7
9 rec_control [--help] [--socket-dir] [--socket-pid] command ..
10
12 rec_control(1) allows the operator to control a running instance of the
13 pdns_recursor.
14
15 The commands that can be passed to the recursor are described on
16 http://doc.powerdns.com/rec-control.html
17
19 To stop the recursor by hand, run:
20
21 # rec_control quit
22
23 To dump the cache to disk, execute:
24
25 # rec_control dump-cache /tmp/the-cache
26
28 --help
29 provide this helpful message
30
31 --socket-dir
32 Where the controlsocket will live
33
34 --socket-pid
35 When running in SMP mode, pid of pdns_recursor to control
36
37 --timeout
38 Number of seconds to wait for the remote PowerDNS Recursor to
39 respond. Set to 0 for infinite.
40
42 dump-cache filename
43 Dumps the entire cache to the filename mentioned. This file should
44 not exist already, PowerDNS will refuse to overwrite it. While
45 dumping, the recursor will not answer questions.
46
47 get statistic
48 Retrieve a statistic. For items that can be queried, see
49 http://doc.powerdns.com/recursor-stats.html
50
51 get-all
52 Retrieve all known statistics.
53
54 ping
55 Check if server is alive.
56
57 quit
58 Request shutdown of the recursor
59
60 reload-zones
61 Reload authoritative and forward zones. Retains current
62 configuration in case of errors.
63
64 top-remotes
65 Shows the top-20 most active remote hosts. Statistics are over the
66 last remotes-ringbuffer-entries queries, which defaults to 0.
67
68 wipe-cache domain0 [domain1]
69 Wipe entries from the cache. This is useful if, for example, an
70 important server has a new IP address, but the TTL has not yet
71 expired. Multiple domain names can be passed. Note that you must
72 terminate a domain with a .! So to wipe powerdns.org, issue
73 rec_control wipe-cache powerdns.org.. Versions beyond 3.1 don’t
74 need the trailing dot. Consider not only wiping www.domain.com.
75 but also domain.com., as the cached nameservers or target of CNAME
76 may continue to be undesired.
77
79 None known. File new ones at http://wiki.powerdns.com.
80
82 Written by PowerDNS.COM BV, bert hubert, <bert.hubert@netherlabs.nl[1]>
83
85 Website: http://wiki.powerdns.com, http://www.powerdns.com
86
88 pdns_recursor(1)
89
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
95 1. bert.hubert@netherlabs.nl
96 mailto:bert.hubert@netherlabs.nl
97
98
99
100[FIXME: source] 08/30/2010 REC_CONTROL(1)