Sophie: pdns-3.0.1-0.1mdv2010.2 i586

pdns-3.0.1-0.1mdv2010.2.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Controlling and querying the recursor</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PowerDNS manual"
HREF="index.html"><LINK
REL="UP"
TITLE="PowerDNS resolver/recursing nameserver"
HREF="built-in-recursor.html"><LINK
REL="PREVIOUS"
TITLE="PowerDNS resolver/recursing nameserver"
HREF="built-in-recursor.html"><LINK
REL="NEXT"
TITLE="PowerDNS Recursor performance"
HREF="recursor-performance.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PowerDNS manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="built-in-recursor.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 12. PowerDNS resolver/recursing nameserver</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="recursor-performance.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="REC-CONTROL"
>12.2. Controlling and querying the recursor</A
></H1
><P
>	To control and query the PowerDNS recursor, the tool <TT
CLASS="FILENAME"
>rec_control</TT
> is provided. This program
	talks to the recursor over the 'controlsocket', often stored in <TT
CLASS="FILENAME"
>/var/run</TT
>.
      </P
><P
>	As a sample command, try:
	<PRE
CLASS="SCREEN"
>	  # rec_control ping
	  pong
	</PRE
>
      </P
><P
>	When not running as root, <B
CLASS="COMMAND"
>--socket-dir=/tmp</B
> might be appropriate.
      </P
><P
>	  All rec_control commands are documented below:
	  <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>dump-cache filename</DT
><DD
><P
>		  Dumps the entire cache to the filename mentioned. This file should not exist already, PowerDNS
		  will refuse to overwrite it. While dumping, the recursor will not answer questions.
		</P
></DD
><DT
>get statistic</DT
><DD
><P
>		  Retrieve a statistic. For items that can be queried, see below.
		</P
></DD
><DT
>ping</DT
><DD
><P
>		  Check if server is alive.
		</P
></DD
><DT
>quit</DT
><DD
><P
>		  Request shutdown of the recursor.
		</P
></DD
><DT
>reload-zones</DT
><DD
><P
>		Reload data about all authoritative and forward zones. The configuration file is also scanned 
		to see if the <B
CLASS="COMMAND"
>auth-domain</B
>, <B
CLASS="COMMAND"
>forward-domain</B
> and <B
CLASS="COMMAND"
>export-etc-hosts</B
>
		statements have changed, and if so, these changes are incorporated.
		</P
></DD
><DT
>top-remotes</DT
><DD
><P
>		  Shows the top-20 most active remote hosts. Statistics are over the last 'remotes-ringbuffer-entries' queries, which
		  defaults to 0.
		</P
></DD
><DT
>wipe-cache domain0. [domain1. domain2.]</DT
><DD
><P
>		  Wipe entries 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. For versions before 3.1, you must terminate a domain with a .! So to wipe powerdns.org,
		  issue 'rec_control wipe-cache powerdns.org.'. For later versions, the dot is optional. 
		</P
><P
>		  Note that deletion is exact, wiping 'com.' will leave 'www.powerdns.com.' untouched!
		</P
><P
>		  <DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>		    In PowerDNS versions 3.0.0 and 3.0.1 this command is slightly buggy and might cause your nameserver to crash if the first
		    query after wiping the cache is for the domain you just wiped.
		    </P
></TD
></TR
></TABLE
></DIV
>
		  <DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>		    Don't just wipe 'www.somedomain.com', its NS records or CNAME target may still be undesired, so wipe 'somedomain.com' as well.
		    </P
></TD
></TR
></TABLE
></DIV
>
		</P
></DD
></DL
></DIV
>
	</P
><P
>	  The command 'get' can query a large number of statistics, which are detailed in <A
HREF="recursor-stats.html"
>Section 12.5</A
>.

	</P
><P
>	  More details on what 'throttled' queries and the like are can be found below in <A
HREF="recursor-details.html"
>Section 12.4</A
>.
	</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="built-in-recursor.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="recursor-performance.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>PowerDNS resolver/recursing nameserver</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="built-in-recursor.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>PowerDNS Recursor performance</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>