pdns_control(1)

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-extended-status [DOMAIN...]
46       Output an extended status of all domains, containing much more informa‐
47       tion  than  the  simple  domain status, like the number of records cur‐
48       rently loaded, whether pdns is master or slave for the domain, the list
49       of  masters,  various timers, etc Optionally, append DOMAINs to get the
50       status of specific zones.
51
52   bind-domain-status [DOMAIN...]
53       When using the BIND backend, list status of  all  domains.  Optionally,
54       append DOMAINs to get the status of specific zones.
55
56   bind-list-rejects
57       When using the BIND backend, get a list of all rejected domains.
58
59   bind-reload-now DOMAIN [DOMAIN...]
60       When using the BIND backend, immediately reload DOMAIN from disk.
61
62   ccounts
63       Show the content of the cache.
64
65   current-config [diff]
66       Show  the currently running configuration. The output has the same for‐
67       mat as pdns_server --config. With the diff option only modified options
68       are included in the output.
69
70   cycle
71       Restart the nameserver so it reloads its configuration. Only works when
72       the server is running in guardian mode.
73
74   list
75       Dump all statistics and their values in a comma separated list, equiva‐
76       lent to show *.
77
78   list-zones [master,slave,native]
79       Show a list of zones, optionally filter on the type of zones to show.
80
81   notify DOMAIN
82       Adds  DOMAIN  to  the  notification  list, causing PowerDNS to send out
83       notifications to the nameservers of a domain. Can be used  if  a  slave
84       missed previous notifications or is generally hard of hearing. Use * to
85       notify for all domains. (Note that you may need to escape the * sign in
86       your shell.)
87
88   notify-host DOMAIN ADDRESS
89       Same as above but with operator specified IP ADDRESS as destination, to
90       be used if you know better than PowerDNS.
91
92   ping, rping
93       Check if the server is still alive. Will  return  'PONG'  when  it  is.
94       ping  works  when  running  inside a guardian, whereas rping works when
95       running without a guardian.
96
97   purge [RECORD]
98       Purge entries from the cache. If RECORD ends  with  a  dollar  ($)  all
99       entries  that end with that name are removed. If no record is specified
100       the entire cache is purged.
101
102   qtypes
103       Get a count of queries per qtype on standard out.
104
105   quit
106       Tell a running pdns_server to quit.
107
108   rediscover
109       Instructs backends that new domains may have appeared in the  database,
110       or, in the case of the BIND backend, in named.conf.
111
112   reload
113       Instruct  the  server  to  reload  all its zones, this will not add new
114       zones.
115
116   remotes
117       Get the top number of remote addresses (clients).
118
119   respsizes
120       Get a histogram of the response sizes.
121
122   retrieve DOMAIN [IP]
123       Retrieve slave DOMAIN from its master. Done nearly immediately.  If  IP
124       is specified, then retrieval is forced from the specified IP.  Port may
125       be specified in AFI specific manner.
126
127   set VARIABLE VALUE
128       Set the configuration parameter VARIABLE to VALUE. Currently  only  the
129       query-logging can be set.
130
131   show STATISTIC
132       Show a single statistic, as present in the output of the list command.
133
134   show STATISTIC-PREFIX*
135       Show  all statistics which names start with the supplied STATISTIC-PRE‐
136       FIX, as a comma-separated list. Only one (ending) wildcard is allowed.
137
138   status
139       Show usage statistics. This only works if  the  server  is  running  in
140       guardian mode.
141
142   token-login MODULE SLOT PIN
143       Log on to a PKCS#11 slot. You only need to login once per slot, even if
144       you have multiple keys on single slot. Only available if  PowerDNS  was
145       compiled with PKCS#11 support.
146
147   uptime
148       Show the uptime of the running server.
149
150   version
151       Print the version of the running pdns daemon.
152

AUTHOR

157       PowerDNS.COM BV
158

COPYRIGHT

160       2001-2019, PowerDNS.COM BV
161
162
163
164
165                                 Feb 06, 2021                  PDNS_CONTROL(1)