NAME¶
pdns_control - Control the PowerDNS nameserver
SYNOPSIS¶
pdns_control [options] command
DESCRIPTION¶
pdns_control is used to send commands to a running PowerDNS nameserver.
OPTIONS¶
A summary of options is included below.
- --help
-
Show summary of options.
- --chroot=...
-
Where PowerDNS is chrooted
- --config-dir=...
-
Location of configuration directory (pdns.conf)
- --config-name=...
-
Name of this virtual configuration - will rename the binary image
- --remote-address=...
-
Remote address to query
- --remote-port=...
-
Remote port to query
- --secret=...
-
Secret needed to connect to remote PowerDNS
- --socket-dir=...
- Where the controlsocket will live
COMMANDS¶
- ccounts
- Show the content of the cache
- notify <domain>
- 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.
- notify-host <domain>
<host>
- Same as above but with operator specified IP address as
destination, to be used if you know better than PowerDNS.
- cycle
- Restart the nameserver so it reloads its
configuration.
- ping
- Check if the server is alive.
- purge [<record>]
- Purge entries from the packet cache. If the record name
ends with a dollar ($) all entries that end with that name are removed. If
no record is specified the entire cache is purged.
- rediscover
- Instructs backends that new domains may have appeared in
the database, or, in the case of the Bind backend, in named.conf.
- retrieve <domain>
- Retrieve a slave domain from its master. Done nearly
immediately.
- set <variable> <value>
- Set the configuration parameter <variable> to
<value>. Currently only the query-logging can be
set.
- show <variable>
- Show a single statistic, as present in the output of the
list command.
- quit
- Tell a running pdns_server to quit.
- status
- Show usage statistics.
- uptime
- Show the uptime of the running server.
- version
- Print the version of the running pdns daemon.
FILES¶
- <socket>
- Control socket used to communicate with
pdns_server.
SEE ALSO¶
pdns_server(8)