NAME

       pdns_control - Contreol 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

       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.

       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)

AUTHORS

       PowerDNS.com BV.

                                          December 2002                           PDNS_CONTROL(1)