Changeset 936

Show
Ignore:
Timestamp:
12/31/06 16:07:47 (2 years ago)
Author:
ahu
Message:

SGML cleanups by Ruben Kerkhof, many thanks!

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/pdns/pdns/docs/pdns.sgml

    r935 r936  
    7676        on <ulink url="http://doc.powerdns.com/txt">http://doc.powerdns.com/txt/</ulink>.  
    7777      </para> 
     78    </sect1> 
    7879    <sect1 id="changelog"> 
    7980      <title>Release notes</title> 
    …… 
    14061407        </para> 
    14071408        <para> 
    1408         Bug fixes: 
    1409         <para> 
     1409          Bug fixes: 
    14101410          <itemizedlist> 
    14111411            <listitem> 
    …… 
    19421942                gpgsql no longer reports as gmysql (Sherwin Daganoto) 
    19431943              </para> 
     1944            </listitem> 
    19441945            <listitem> 
    19451946              <para> 
    …… 
    19851986              <para> 
    19861987                Cleanups by Norbert: getAuth moved to chopOff, arguments::contains massive cleanup, more. 
     1988              </para> 
    19871989            </listitem> 
    19881990          </itemizedlist> 
     1991        </para> 
    19891992      </sect2> 
    19901993       
    …… 
    19921995        <para> 
    19931996          Yet another iteration, hopefully this will be the last silly release.  
     1997        </para> 
    19941998        <para> 
    19951999          <warning> 
    …… 
    20792083              </para> 
    20802084            </listitem> 
    2081         </itemizedlist> 
    2082         </sect2>                 
     2085          </itemizedlist> 
     2086        </para> 
     2087      </sect2>           
    20832088      <sect2 id="changelog-2-9-8"><title>Version 2.9.8</title>   
    20842089        <para> 
    …… 
    23192324            </para> 
    23202325          </warning> 
     2326        </para> 
    23212327        <para> 
    23222328          <itemizedlist> 
    …… 
    30743080        </para> 
    30753081        <para>   
    3076         <itemizedlist> 
    3077         <listitem> 
    3078         <para> 
    3079         License changed to the GNU General Public License version 2. 
    3080         </para> 
    3081         </listitem> 
    3082         <listitem> 
    3083         <para> 
     3082          <itemizedlist> 
     3083            <listitem> 
     3084              <para> 
     3085               License changed to the GNU General Public License version 2. 
     3086              </para> 
     3087            </listitem> 
     3088            <listitem> 
     3089              <para> 
    30843090                Cleanups by Erik Bos @ xs4all. 
    3085         </para> 
    3086         </listitem> 
    3087         <listitem> 
    3088         <para> 
     3091              </para> 
     3092            </listitem> 
     3093            <listitem> 
     3094              <para> 
    30893095                Build improvements by Wichert Akkerman 
    3090         </para> 
    3091         </listitem> 
    3092         <listitem> 
    3093         <para> 
     3096              </para> 
     3097            </listitem> 
     3098            <listitem> 
     3099              <para> 
    30943100                Lots of work on the build system, entirely revamped. By PowerDNS. 
    3095         </para> 
    3096         </listitem> 
    3097         </itemizedlist> 
    3098         </sect2> 
     3101              </para> 
     3102            </listitem> 
     3103          </itemizedlist> 
     3104        </para> 
     3105      </sect2> 
    30993106         
    31003107      <sect2 id="changelog-2-8"><title>Version 2.8</title>       
    …… 
    35443551            </listitem> 
    35453552          </itemizedlist> 
     3553        </para> 
    35463554        <para> 
    35473555          Documentation: added details for <command>strict-rfc-axfrs</command>. This feature can be used if very old clients need to be able 
    …… 
    41314139            </listitem> 
    41324140          </itemizedlist> 
    4133  
     4141        </para> 
    41344142      </sect2> 
     4143 
    41354144      <sect2 id="changelog-1-99-11"><title>Version 1.99.11 Prerelease</title> 
    41364145        <para> 
    …… 
    50145023          the nameserver down a lot. 
    50155024        </para> 
    5016         <sect3><title>Known bugs</title> 
     5025        <sect3> 
     5026          <title>Known bugs</title> 
    50175027          <para> 
    50185028            Decreasing a ringbuffer on the website is a sure way to crash the daemon. Zone2sql, while improved, still 
    …… 
    50285038          <para> 
    50295039            Zone2sql does not close filedescriptors. 
    5030           <para> 
     5040          </para> 
    50315041 
    50325042          <para> 
    50335043            FreeBSD version does not stop when requested via the init.d script. 
    5034           <para> 
     5044          </para> 
    50355045 
    50365046        </sect3> 
    …… 
    53525362        (these people don't share the blame for any errors or mistakes in powerdns - those are all ours) 
    53535363      </para> 
    5354   </Chapter> 
     5364    </sect1> 
     5365</Chapter> 
    53555366 
    53565367<Chapter id="installing-on-unix"> 
    …… 
    59475958            </varlistentry> 
    59485959          </variablelist> 
     5960        </para> 
    59495961        </sect2> 
    59505962    </sect1> 
    …… 
    61746186        </screen> 
    61756187      </para> 
     6188      </sect1> 
    61766189      <sect1 id="syslog"><title>Operational logging using syslog</title> 
    61776190      <para>(<command>logging-facility</command> is available from 1.99.10 and onwards)</para> 
    …… 
    62356248          You should set these parameters immediately if they are not set! 
    62366249        </para> 
     6250        </sect2> 
    62376251        <sect2><title>Jailing the process in a chroot</title> 
    62386252        <para> 
    …… 
    63986412        The size of the packetcache can be observed with <command>/etc/init.d/pdns show packetcache-size</command> 
    63996413      </para> 
    6400     </sect1> 
    6401     <sect1 id="querycache"><title>Query Cache</title> 
     6414    </sect2> 
     6415    <sect2 id="querycache"><title>Query Cache</title> 
    64026416      <para> 
    64036417        Besides entire packets, PDNS can also cache individual backend queries. Each DNS query leads to a number of backend queries, 
    …… 
    64236437        Packet Cache. 
    64246438      </para> 
    6425     </sect1> 
     6439    </sect2> 
     6440  </sect1> 
    64266441  </chapter> 
    64276442  <chapter id="migration"><title>Migrating to PDNS</title> 
    …… 
    76217636      </para> 
    76227637      <para> 
    7623       <para> 
    76247638        <warning> 
    76257639          <para> 
    …… 
    76977711            </para> 
    76987712          </listitem> 
     7713        </varlistentry> 
    76997714        <varlistentry> 
    77007715          <term>URL</term> 
    …… 
    79928007  </chapter> 
    79938008  <chapter id="metrics"><title>Index of all internal metrics</title> 
    7994     <para></para> 
    7995       <sect1 id="counters-variables"><title>Counters &amp; variables</title> 
     8009    <sect1 id="counters-variables"><title>Counters &amp; variables</title> 
    79968010      <para> 
    79978011      A number of counters and variables are set during PDNS operation. These can be queried with the init.d 
    79988012      <command>dump</command>, <command>show</command> and <command>mrtg</command> commands, or viewed with the 
    79998013      webserver. 
    8000        
     8014      </para> 
     8015      <sect2 id="counters"> 
     8016        <title>Counters</title> 
     8017      <para> 
    80018018      <variablelist> 
    80028019        <varlistentry> 
    …… 
    80548071      </variablelist> 
    80558072    </para> 
    8056     <para> 
    8057       <sect2><title>Ring buffers</title> 
     8073    </sect2> 
     8074    <sect2> 
     8075      <title>Ring buffers</title> 
    80588076        <para> 
    80598077          Besides counters, PDNS also maintains the ringbuffers. A ringbuffer records events, each new event gets a place 
    …… 
    81338151    </variablelist> 
    81348152  </para> 
     8153  </sect2> 
     8154  </sect1> 
    81358155  </chapter> 
    81368156 
    …… 
    85888608        </variablelist> 
    85898609      </para> 
     8610    </sect1> 
    85908611    <sect1 id="pdns-devel-faq"><title>Backend developer HOWTO</title> 
    85918612      <para> 
    …… 
    87478768              </para> 
    87488769            </listitem> 
     8770          </varlistentry> 
    87498771          <varlistentry> 
    87508772            <term>Q: How does PowerDNS.COM BV expect to make money now that the nameserver is free?</term> 
    …… 
    87658787                In fact, their strategy is a lot like ours in general. 
    87668788              </para> 
     8789            </listitem> 
    87678790          </varlistentry> 
    87688791          <varlistentry> 
    …… 
    87728795                Sure, to do so, please contact us at <email>sales@powerdns.com</email> 
    87738796              </para> 
     8797            </listitem> 
    87748798          </varlistentry> 
    87758799          <varlistentry> 
    …… 
    88048828 
    88058829          <varlistentry> 
    8806             <term>Q: We are a Linux/Unix vendor, can we include PowerDNS? 
     8830            <term>Q: We are a Linux/Unix vendor, can we include PowerDNS?</term> 
    88078831            <listitem> 
    88088832              <para> 
    …… 
    99719995            </varlistentry> 
    99729996          </variablelist> 
     9997        </para> 
     9998      </sect2> 
    99739999      <sect2><title>Fancy records</title> 
    997410000        <para> 
    …… 
    1013810164          Make sure that the assigned id in the domains table matches the domain_id field in the records table! 
    1013910165        </para> 
     10166      </sect2> 
    1014010167    </sect1> 
    1014110168     
    …… 
    1063710664          is given. 
    1063810665        </para> 
     10666      </sect2> 
    1063910667      <sect2 id="bind-control-commands"><title>Pdns_control commands</title> 
    1064010668        <para> 
    …… 
    1069510723          </para> 
    1069610724        </sect3> 
     10725      </sect2> 
    1069710726      <sect2><title>Commands</title> 
    1069810727        <para> 
    …… 
    1083310862          </para> 
    1083410863        </warning> 
     10864      </para> 
    1083510865      <para> 
    1083610866        The main author for this module is Norbert Sendetzky who also has his own <ulink url="http://www.linuxnetworks.de/pdnsldap/index.html">PowerDNS-LDAP page</ulink>. 
    …… 
    1122011250        problems though. 
    1122111251      </para> 
     11252  </sect1> 
    1122211253  </appendix> 
    1122311254  <appendix id="backend-writers-guide"><title>Backend writers' guide</title> 
    …… 
    1151011541           
    1151111542          <varlistentry> 
    11512             <term>bool list(int domain_id) 
     11543            <term>bool list(int domain_id)</term> 
    1151311544            <listitem> 
    1151411545              <para> 
    …… 
    1188511916        <para> 
    1188611917          Supermaster/superslave is a complicated concept, if this is all unclear see <xref linkend="supermaster">. 
     11918        </para> 
    1188711919      </sect2> 
    1188811920    </sect1> 
    …… 
    1198312015          The FreeBSD Boost include files are installed in <filename>/usr/local/include</filename>, so prefix <command>CXXFLAGS=-I/usr/local/lib</command> 
    1198412016          to your <command>./configure</command> invocation. 
     12017        </para> 
    1198512018      </sect2> 
    1198612019      <sect2 id="unix-linux"><title>Linux</title> 
    …… 
    1201612049      <para> 
    1201712050        By Michel Stol (<email>michel@powerdns.com</email>). 
     12051      </para> 
    1201812052      <sect2><title>Assumptions</title> 
    1201912053        <para> 
    …… 
    1212612160        </sect4> 
    1212712161         
    12128         <sect3> 
     12162        <sect4> 
    1212912163          <title>Installing pthreads for Windows</title> 
    1213012164           
    …… 
    1214412178            on that later. 
    1214512179          </para>         
    12146         </sect3> 
     12180        </sect4> 
     12181      </sect3> 
    1214712182         
    1214812183      </sect2> 
    …… 
    1249412529      </sect2> 
    1249512530    </sect1> 
     12531  </appendix> 
    1249612532  <appendix id="license"><title>PowerDNS license (GNU General Public License version 2)</title> 
    1249712533    <para>