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 variables 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
123       Retrieve slave DOMAIN from its master. Done nearly immediately.
124
125   set VARIABLE VALUE
126       Set the configuration parameter VARIABLE to VALUE. Currently  only  the
127       query-logging can be set.
128
129   show VARIABLE
130       Show a single statistic, as present in the output of the list command.
131
132   status
133       Show  usage  statistics.  This  only  works if the server is running in
134       guardian mode.
135
136   token-login MODULE SLOT PIN
137       Log on to a PKCS#11 slot. You only need to login once per slot, even if
138       you  have  multiple keys on single slot. Only available if PowerDNS was
139       compiled with PKCS#11 support.
140
141   uptime
142       Show the uptime of the running server.
143
144   version
145       Print the version of the running pdns daemon.
146

AUTHOR

151       PowerDNS.COM BV
152

COPYRIGHT

154       2001-2019, PowerDNS.COM BV
155
156
157
158
159                                 Apr 06, 2020                  PDNS_CONTROL(1)