1
--- a/pdns/docs/pdns_control.8
2
+++ b/pdns/docs/pdns_control.8
5
pdns_control \- Control the pDNS nameserver
7
-.B pdns_control command
8
+.B pdns_control \fI[options]\fR command
10
\fBpdns_control\fR is used to send commands to a running pDNS nameserver.
12
+A summary of options is included below.
16
+Show summary of options.
20
+Where PowerDNS is chrooted
22
+.B \-\-config\-dir\=...
24
+Location of configuration directory (pdns.conf)
26
+.B \-\-config\-name\=...
28
+Name of this virtual configuration - will rename the binary image
30
+.B \-\-remote\-address\=...
32
+Remote address to query
34
+.B \-\-remote\-port\=...
40
+Secret needed to connect to remote PowerDNS
42
+.B \-\-socket\-dir\=...
43
+Where the controlsocket will live
47
Show the content of the cache
49
+.B notify \fI<domain>\fR
50
+Adds a domain to the notification list, causing PDNS to send out notifications to the nameservers of a domain. Can be used if a slave missed previous notifications or is generally hard of hearing.
52
+.B notify-host \fI<domain>\fR \fI<host>\fR
53
+Same as above but with operator specified IP address as destination, to be used if you know better than PowerDNS.
56
Restart the nameserver so it reloads its configuration.
61
+Check if the server is alive.
63
.B purge \fI[<record>]\fR
64
Purge entries from the packet cache. If the record name ends with a
65
dollar ($) all entries that end with that name are removed. If no record is
66
specified the entire cache is purged.
69
-Tell a running \fBpdns_server\fR to to quit.
71
+Instructs backends that new domains may have appeared in the database, or, in the case of the Bind backend, in named.conf.
73
+.B retrieve \fI<domain>\fR
74
+Retrieve a slave domain from its master. Done nearly immediatly.
76
.B set \fI<variable> <value>\fR
77
Set the configuration parameter \fI<variable>\fR to \fI<value>\fR. Currently
78
only the \fIquery\-logging\fR can be set.
80
.B show \fI<variable>\fR
81
-Print the value of a specific configuration variable.
82
+Show a single statistic, as present in the output of the list command.
85
+Tell a running \fBpdns_server\fR to quit.
88
Show usage statistics.