NAME

       pdns_control -

       pdns_control - Control the PowerDNS nameserver

SYNOPSIS

       pdns_control [OPTION]... COMMAND

DESCRIPTION

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

OPTIONS

       --help Show summary of options.

       --chroot=<DIR>
              Directory where PowerDNS is chrooted.

       --config-dir=<DIR>
              Location of configuration directory (pdns.conf).

       --config-name=<NAME>
              Name of this virtual configuration - will rename the binary image.

       --remote-address=<ADDRESS>
              Remote address to query.

       --remote-port=<PORT>
              Remote port to query.

       --secret=<SECRET>
              Secret needed to connect to remote PowerDNS.

       --socket-dir=<DIR>
              Where the controlsocket lives.

COMMANDS

   bind-add-zone DOMAIN FILENAME
       When  using  the  bindbackend, add a zone. This zone is added in-memory and served immediately. Note that
       this does not add the zone to the bind-config file. FILENAME must be an absolute path.

   bind-domain-status [DOMAIN...]
       When using the bindbackend, list status of all domains. Optionally, append DOMAINs to get the  status  of
       specific zones.

   bind-list-rejects
       When using the bindbackend, get a list of all rejected domains.

   bind-reload-now DOMAIN [DOMAIN...]
       When using the bindbackend, immediately reload DOMAIN from disk.

   ccounts
       Show the content of the cache.

   current-config
       Show  the currently running configuration. The output has the same format as pdns_server --config. You'll
       notice that all the are uncommented. This is because PowerDNS simply has values, and  the  default  isn't
       known at runtime.

   cycle
       Restart the nameserver so it reloads its configuration. Only works when the server is running in guardian
       mode.

   list
       Dump all variables and their values in a comma separated list, equivalent to show *.

   list-zones [master,slave,native]
       Show a list of zones, optionally filter on the type of zones to show.

   notify DOMAIN
       Adds  DOMAIN to the notification list, causing PowerDNS 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.  Use  *  to
       notify for all domains. (Note that you may need to escape the * sign in your shell.)

   notify-host DOMAIN ADDRESS
       Same  as  above but with operator specified IP ADDRESS as destination, to be used if you know better than
       PowerDNS.

   ping, rping
       Check if the server is still alive. Will return 'PONG' when it is.  ping  works  when  running  inside  a
       guardian, whereas rping works when running without a guardian.

   purge [RECORD]
       Purge  entries  from  the cache. If RECORD ends with a dollar ($) all entries that end with that name are
       removed. If no record is specified the entire cache is purged.

   qtypes
       Get a count of queries per qtype on standard out.

   quit
       Tell a running pdns_server to quit.

   rediscover
       Instructs backends that new domains may have appeared in the database,  or,  in  the  case  of  the  Bind
       backend, in named.conf.

   reload
       Instruct the server to reload all its zones, this will not add new zones.

   remotes
       Get the top number of remote addresses (clients).

   respsizes
       Get a histogram of the response sizes.

   retrieve DOMAIN
       Retrieve 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.

   status
       Show usage statistics. This only works if the server is running in guardian mode.

   token-login MODULE SLOT PIN
       Log  on to a PKCS#11 slot. You only need to login once per slot, even if you have multiple keys on single
       slot. Only available if PowerDNS was compiled with PKCS#11 support.

   uptime
       Show the uptime of the running server.

   version
       Print the version of the running pdns daemon.

SEE ALSO

       pdns_server(1)

AUTHOR

       PowerDNS.COM BV

COPYRIGHT

       2017, PowerDNS.COM BV

4.1                                               Feb 16, 2018                                   PDNS_CONTROL(1)