1PDNS_CONTROL(1)          PowerDNS Authoritative Server         PDNS_CONTROL(1)
2
3
4

NAME

6       pdns_control - Control the PowerDNS nameserver
7

SYNOPSIS

9       pdns_control [OPTION]... COMMAND
10

DESCRIPTION

12       pdns_control is used to send commands to a running PowerDNS nameserver.
13

OPTIONS

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

COMMANDS

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

SEE ALSO

142       pdns_server(1)
143

AUTHOR

145       PowerDNS.COM BV
146
148       2001-2019, PowerDNS.COM BV
149
150
151
152
1534.2                              Nov 29, 2019                  PDNS_CONTROL(1)
Impressum