pdns_control(1)

1PDNS_CONTROL(1)                PowerDNS Recursor               PDNS_CONTROL(1)
2
3
4

NAME

6       pdns_control -
7
8       pdns_control - Control the PowerDNS nameserver
9

SYNOPSIS

11       pdns_control [OPTION]... COMMAND
12

DESCRIPTION

14       pdns_control is used to send commands to a running PowerDNS nameserver.
15

OPTIONS

17       --help Show summary of options.
18
19       --chroot=<DIR>
20              Directory where PowerDNS is chrooted.
21
22       --config-dir=<DIR>
23              Location of configuration directory (pdns.conf).
24
25       --config-name=<NAME>
26              Name  of  this  virtual  configuration  - will rename the binary
27              image.
28
29       --remote-address=<ADDRESS>
30              Remote address to query.
31
32       --remote-port=<PORT>
33              Remote port to query.
34
35       --secret=<SECRET>
36              Secret needed to connect to remote PowerDNS.
37
38       --socket-dir=<DIR>
39              Where the controlsocket lives.
40

COMMANDS

42   bind-add-zone DOMAIN FILENAME
43       When using the bindbackend, add a zone. This zone  is  added  in-memory
44       and  served  immediately.  Note  that this does not add the zone to the
45       bind-config file. FILENAME must be an absolute path.
46
47   bind-domain-status [DOMAIN...]
48       When using the bindbackend, list status  of  all  domains.  Optionally,
49       append DOMAINs to get the status of specific zones.
50
51   bind-list-rejects
52       When using the bindbackend, get a list of all rejected domains.
53
54   bind-reload-now DOMAIN [DOMAIN...]
55       When using the bindbackend, immediately reload DOMAIN from disk.
56
57   ccounts
58       Show the content of the cache.
59
60   current-config
61       Show  the currently running configuration. The output has the same for‐
62       mat as pdns_server --config. You'll notice  that  all  the  are  uncom‐
63       mented.  This  is  because  PowerDNS simply has values, and the default
64       isn't known at runtime.
65
66   cycle
67       Restart the nameserver so it reloads its configuration. Only works when
68       the server is running in guardian mode.
69
70   list
71       Dump  all variables and their values in a comma separated list, equiva‐
72       lent to show *.
73
74   list-zones [master,slave,native]
75       Show a list of zones, optionally filter on the type of zones to show.
76
77   notify DOMAIN
78       Adds DOMAIN to the notification list,  causing  PowerDNS  to  send  out
79       notifications  to  the  nameservers of a domain. Can be used if a slave
80       missed previous notifications or is generally hard of hearing. Use * to
81       notify for all domains. (Note that you may need to escape the * sign in
82       your shell.)
83
84   notify-host DOMAIN ADDRESS
85       Same as above but with operator specified IP ADDRESS as destination, to
86       be used if you know better than PowerDNS.
87
88   ping, rping
89       Check  if  the  server  is  still alive. Will return 'PONG' when it is.
90       ping works when running inside a guardian,  whereas  rping  works  when
91       running without a guardian.
92
93   purge [RECORD]
94       Purge  entries  from  the  cache.  If RECORD ends with a dollar ($) all
95       entries that end with that name are removed. If no record is  specified
96       the entire cache is purged.
97
98   qtypes
99       Get a count of queries per qtype on standard out.
100
101   quit
102       Tell a running pdns_server to quit.
103
104   rediscover
105       Instructs  backends that new domains may have appeared in the database,
106       or, in the case of the Bind backend, in named.conf.
107
108   reload
109       Instruct the server to reload all its zones,  this  will  not  add  new
110       zones.
111
112   remotes
113       Get the top number of remote addresses (clients).
114
115   respsizes
116       Get a histogram of the response sizes.
117
118   retrieve DOMAIN
119       Retrieve slave DOMAIN from its master. Done nearly immediately.
120
121   set VARIABLE VALUE
122       Set  the  configuration parameter VARIABLE to VALUE. Currently only the
123       query-logging can be set.
124
125   show VARIABLE
126       Show a single statistic, as present in the output of the list command.
127
128   status
129       Show usage statistics. This only works if  the  server  is  running  in
130       guardian mode.
131
132   token-login MODULE SLOT PIN
133       Log on to a PKCS#11 slot. You only need to login once per slot, even if
134       you have multiple keys on single slot. Only available if  PowerDNS  was
135       compiled with PKCS#11 support.
136
137   uptime
138       Show the uptime of the running server.
139
140   version
141       Print the version of the running pdns daemon.
142

AUTHOR

147       PowerDNS.COM BV
148

COPYRIGHT

150       2001-2018, PowerDNS.COM BV
151
152
153
154
1554.1                              Mar 22, 2019                  PDNS_CONTROL(1)