Show
Ignore:
Timestamp:
04/20/06 12:00:01 (7 years ago)
Author:
ahu
Message:

remove bashisms
fix install on Solaris, FreeBSD
add fake ./configure script to catch Boost or lack thereof
update documentation

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/pdns/pdns/docs/pdns.sgml

    r739 r751  
    12781278            <listitem> 
    12791279              <para> 
    1280                 delegation-only, a Verisign special. See <xref linkend="verisign">. 
     1280                delegation-only, a Verisign special.  
    12811281              </para> 
    12821282            </listitem> 
     
    59615961            <listitem> 
    59625962              <para> 
    5963                 A Verisign special, see <xref linkend="verisign">. 
     5963                A Verisign special. 
    59645964              </para> 
    59655965            </listitem> 
     
    61256125        </variablelist> 
    61266126      <para> 
    6127     <sect2 id="rec-control"><title>Controlling and querying the recursor</title> 
    6128         <para> 
    6129           To control and query the PowerDNS recursor, the tool <filename>rec_control</filename> is provided. This program 
    6130           talks to the recursor over the 'controlsocket', often stored in <filename>/var/run</filename>. 
    6131         </para> 
    6132         <para> 
    6133           As a sample command, try: 
    6134           <screen> 
    6135             # rec_control ping 
    6136             pong 
    6137           </screen> 
    6138         </para> 
    6139         <para> 
    6140           When not running as root, <command>--socket-dir=/tmp</command> might be appropriate. 
    6141         </para> 
     6127    </sect1> 
     6128    <sect1 id="rec-control"><title>Controlling and querying the recursor</title> 
     6129      <para> 
     6130        To control and query the PowerDNS recursor, the tool <filename>rec_control</filename> is provided. This program 
     6131        talks to the recursor over the 'controlsocket', often stored in <filename>/var/run</filename>. 
     6132      </para> 
     6133      <para> 
     6134        As a sample command, try: 
     6135        <screen> 
     6136          # rec_control ping 
     6137          pong 
     6138        </screen> 
     6139      </para> 
     6140      <para> 
     6141        When not running as root, <command>--socket-dir=/tmp</command> might be appropriate. 
     6142      </para> 
    61426143        <para> 
    61436144          All rec_control commands are documented below: 
     
    62136214          More details on what 'throttled' queries and the like are can be found below in <xref linkend="recursor-details">. 
    62146215        </para> 
    6215       </sect2> 
    6216  
    6217     <sect2 id="verisign"><title>Verisign weirdness</title> 
    6218         <para> 
    6219           <note> 
     6216    </sect1> 
     6217    <sect1 id="recursor-performance"><title>PowerDNS Recursor performance</title> 
     6218      <para> 
     6219        To get the best out of the PowerDNS recursor, which is important if you are doing thousands of queries per second, please  
     6220        consider the following.  
     6221        <itemizedlist> 
     6222          <listitem> 
    62206223            <para> 
    6221               Verisign backed off, this feature is no longer needed (for now). 
     6224              Limit the size of the cache to a sensible value. Cache hit rate does not improve meaningfully beyond 4 million <command>max-cache-entries</command>, 
     6225              reducing the memory footprint reduces CPU cache misses. 
    62226226            </para> 
    6223           </note> 
    6224         </para> 
    6225         <para> 
    6226           Verisign, the current operator of the COM and NET zones, decided to add a wildcard record so as to draw all queries for non-existing  
    6227           domains to their own page, which lists domains you might want to visist instead.  
    6228         </para> 
    6229         <para> 
    6230           To reinstate old behaviour, add <command>delegation-only=com,net</command> to your recursor configuration. 
    6231         </para> 
    6232         <para> 
    6233           What this does is reject all authoritative answers from the COM and NET servers. ISC, the current maintainers of BIND, have  
    6234           implemented this feature first, PowerDNS has mostly copied their algorithm. Thanks! 
    6235         </para> 
    6236         <para> 
    6237           Verisign might decide to evade our tactic with wildcard NS records, by which time other measures will be needed to restore the  
    6238           old behaviour. 
    6239         </para> 
    6240       </sect2> 
    6241            
    6242  
     6227          </listitem> 
     6228          <listitem> 
     6229            <para> 
     6230              Compile using g++ 4.1 or later. This compiler really does a good job on PowerDNS, much better than 3.4 or 4.0. 
     6231            </para> 
     6232          </listitem> 
     6233          <listitem> 
     6234            <para> 
     6235              Consider performing a 'profiled build' as described in the README. This is good for a 20% performance boost in some cases. 
     6236            </para> 
     6237          </listitem> 
     6238          <listitem> 
     6239            <para> 
     6240              When running with &gt;3000 queries per second, and running Linux versions prior to 2.6.17 on some motherboards, your computer may  
     6241              spend an inordinate amount of time working around an ACPI bug for each call to gettimeofday. This is solved by rebooting with 'clock=tsc' 
     6242              or upgrading to a 2.6.17 kernel. 
     6243            </para> 
     6244            <para> 
     6245              The above is relevant if dmesg shows <command>Using pmtmr for high-res timesource</command> 
     6246            </para> 
     6247          </listitem> 
     6248        </itemizedlist> 
     6249        Following the instructions above, you should be able to attain very high query rates. 
     6250      </para> 
    62436251    </sect1> 
    62446252    <sect1 id="recursor-details"><title>Details</title>