1PDNS_CONTROL(1) PowerDNS Authoritative Server PDNS_CONTROL(1)
2
3
4
6 pdns_control - Control the PowerDNS nameserver
7
9 pdns_control [OPTION]... COMMAND
10
12 pdns_control is used to send commands to a running PowerDNS nameserver.
13
15 --help Show summary of options.
16
17 --chroot=<DIR>
18 Directory where PowerDNS is chrooted.
19
20 --config-dir=<DIR>
21 Location of configuration directory (pdns.conf).
22
23 --config-name=<NAME>
24 Name of this virtual configuration - will rename the binary
25 image.
26
27 --remote-address=<ADDRESS>
28 Remote address to query.
29
30 --remote-port=<PORT>
31 Remote port to query.
32
33 --secret=<SECRET>
34 Secret needed to connect to remote PowerDNS.
35
36 --socket-dir=<DIR>
37 Where the controlsocket lives.
38
40 bind-add-zone DOMAIN FILENAME
41 When using the BIND backend, add a zone. This zone is added in-memory
42 and served immediately. Note that this does not add the zone to the
43 bind-config file. FILENAME must be an absolute path.
44
45 bind-domain-status [DOMAIN...]
46 When using the BIND backend, list status of all domains. Optionally,
47 append DOMAINs to get the status of specific zones.
48
49 bind-list-rejects
50 When using the BIND backend, get a list of all rejected domains.
51
52 bind-reload-now DOMAIN [DOMAIN...]
53 When using the BIND backend, immediately reload DOMAIN from disk.
54
55 ccounts
56 Show the content of the cache.
57
58 current-config
59 Show the currently running configuration. The output has the same for‐
60 mat as pdns_server --config. You'll notice that all the are uncom‐
61 mented. This is because PowerDNS simply has values, and the default
62 isn't known at runtime.
63
64 cycle
65 Restart the nameserver so it reloads its configuration. Only works when
66 the server is running in guardian mode.
67
68 list
69 Dump all variables and their values in a comma separated list, equiva‐
70 lent to show *.
71
72 list-zones [master,slave,native]
73 Show a list of zones, optionally filter on the type of zones to show.
74
75 notify DOMAIN
76 Adds DOMAIN to the notification list, causing PowerDNS to send out
77 notifications to the nameservers of a domain. Can be used if a slave
78 missed previous notifications or is generally hard of hearing. Use * to
79 notify for all domains. (Note that you may need to escape the * sign in
80 your shell.)
81
82 notify-host DOMAIN ADDRESS
83 Same as above but with operator specified IP ADDRESS as destination, to
84 be used if you know better than PowerDNS.
85
86 ping, rping
87 Check if the server is still alive. Will return 'PONG' when it is.
88 ping works when running inside a guardian, whereas rping works when
89 running without a guardian.
90
91 purge [RECORD]
92 Purge entries from the cache. If RECORD ends with a dollar ($) all
93 entries that end with that name are removed. If no record is specified
94 the entire cache is purged.
95
96 qtypes
97 Get a count of queries per qtype on standard out.
98
99 quit
100 Tell a running pdns_server to quit.
101
102 rediscover
103 Instructs backends that new domains may have appeared in the database,
104 or, in the case of the BIND backend, in named.conf.
105
106 reload
107 Instruct the server to reload all its zones, this will not add new
108 zones.
109
110 remotes
111 Get the top number of remote addresses (clients).
112
113 respsizes
114 Get a histogram of the response sizes.
115
116 retrieve DOMAIN
117 Retrieve slave DOMAIN from its master. Done nearly immediately.
118
119 set VARIABLE VALUE
120 Set the configuration parameter VARIABLE to VALUE. Currently only the
121 query-logging can be set.
122
123 show VARIABLE
124 Show a single statistic, as present in the output of the list command.
125
126 status
127 Show usage statistics. This only works if the server is running in
128 guardian mode.
129
130 token-login MODULE SLOT PIN
131 Log on to a PKCS#11 slot. You only need to login once per slot, even if
132 you have multiple keys on single slot. Only available if PowerDNS was
133 compiled with PKCS#11 support.
134
135 uptime
136 Show the uptime of the running server.
137
138 version
139 Print the version of the running pdns daemon.
140
142 pdns_server(1)
143
145 PowerDNS.COM BV
146
148 2001-2019, PowerDNS.COM BV
149
150
151
152
1534.2 Nov 29, 2019 PDNS_CONTROL(1)