NAME

       rec_control - control pdns_recursor

SYNOPSIS

       rec_control [OPTION]...  COMMAND [COMMAND-OPTION]...

   DESCRIPTION
       rec_control allows the operator to control a running instance of the pdns_recursor.

       The     commands     that     can     be     passed     to     the     recursor    are    described    on
       http://doc.powerdns.com/md/recursor/running/#rec_control-commands

EXAMPLES

       To stop the recursor by hand, run:

       # rec_control quit

       To dump the cache to disk, execute:

       # rec_control dump-cache /tmp/the-cache

OPTIONS

       --help provide this helpful message.

       --config-dir=PATH
              Directory where the recursor.conf lives.

       --socket-dir=PATH
              Where the controlsocket will live, please use --config-dir instead.

       --socket-pid=PID
              When running in SMP mode, pid of pdns_recursor to control.

       --timeout=NUM
              Number of seconds to wait for the remote PowerDNS Recursor to respond.  Set to 0 for infinite.

COMMANDS

       current-queries
              Shows the currently active queries.

       dump-cache FILENAME
              Dumps the entire cache to FILENAME.  This file should not exist already, PowerDNS will  refuse  to
              overwrite it.  While dumping, the recursor will not answer questions.

       dump-edns FILENAME
              Dumps  the  EDNS  status  to the filename mentioned.  This file should not exist already, PowerDNS
              will refuse to overwrite it.  While dumping, the recursor will not answer questions.

       dump-nsspeeds FILENAME
              Dumps the nameserver speed statistics to the FILENAME  mentioned.   This  file  should  not  exist
              already,  PowerDNS  will  refuse  to  overwrite  it.   While dumping, the recursor will not answer
              questions.

       get STATISTIC [STATISTIC]...
              Retrieve     a     statistic.      For     items      that      can      be      queried,      see
              http://doc.powerdns.com/md/recursor/stats/

       get-all
              Retrieve all known statistics.

       get-parameter KEY [KEY]...
              Retrieves the specified configuration parameter(s).

       get-qtypelist
              Retrieves QType statistics.  Queries from cache aren't being counted yet.

       help   Shows a list of supported commands.

       ping   Check if server is alive.

       quit   Request shutdown of the recursor.

       quit-nicely
              Request nice shutdown of the recursor.

       reload-acls
              Reloads ACLs.

       reload-lua-script FILENAME
              (Re)loads Lua script FILENAME.  This replaces the script currently loaded.

       reload-zones
              Reload authoritative and forward zones.  Retains current configuration in case of errors.

       set-minimum-ttl NUM
              Set minimum-ttl-override to NUM.

       top-remotes
              Shows    the    top-20    most    active   remote   hosts.    Statistics   are   over   the   last
              'stats-ringbuffer-entries' queries.

       trace-regex REGEX
              Emit resolution trace for matching queries.  Empty regex to disable trace.

       unload-lua-script
              Unloads Lua script.

       version
              Report running version.

       wipe-cache DOMAIN [DOMAIN] [...]
              Wipe entries for DOMAIN from the cache.  This is useful if, for example, an important server has a
              new IP address, but the TTL has not yet expired.  Multiple domain names can be passed.  Note  that
              you  must  terminate  a  domain  with  a .! So to wipe powerdns.org, issue 'rec_control wipe-cache
              powerdns.org.'.  Versions beyond 3.1 don't need  the  trailing  dot.   Consider  not  only  wiping
              'www.domain.com.'  but  also  'domain.com.',  as  the  cached  nameservers  or target of CNAME may
              continue to be undesired.

BUGS

       None known.  File new ones at https://github.com/PowerDNS/pdns/issues.

RESOURCES

       Website: http://wiki.powerdns.com, http://www.powerdns.com

SEE ALSO

       pdns_recursor(1)

AUTHORS

       PowerDNS.COM BV.

                                                   April 2006                                     REC_CONTROL(1)