← Back to branch summary

~ubuntu-branches/ubuntu/precise/pdnsd/precise

« back to all changes in this revision

Viewing changes to doc/html/doc.html

  • Committer: Bazaar Package Importer
  • Author(s): Mahyuddin Susanto
  • Date: 2011-03-09 18:54:22 UTC
  • mfrom: (1.3.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20110309185422-33hwmg565m18dpu4
Tags: 1.2.8-par-1
http://bugs.debian.org/596302
http://bugs.debian.org/596302
https://launchpad.net/bugs/712938
http://bugs.debian.org/466332
http://bugs.debian.org/504211
http://bugs.debian.org/476538
http://bugs.debian.org/487467
http://bugs.debian.org/527352
http://bugs.debian.org/602262
http://bugs.debian.org/519656
http://bugs.debian.org/597734
http://bugs.debian.org/602329
http://bugs.debian.org/617373
https://launchpad.net/bugs/452351
http://bugs.debian.org/548173
http://bugs.debian.org/610148
* New Maintainer. (Closes: #596302)
* New Upstream Releases. (Closes: #596302, LP: #712938)
* debian/patches/05_fix_spelling.patch: Fix spelling errors.
* debian/patches/04_ipv6_localhost.patch. Adding ipv6 in localhost.
  (Closes: #466332, #504211)
* debian/init.d:
  - Add init status. (Closes: #476538)
  - Don't says starting pdnsd if already started. (Closes: #487467)
* deban/changelog: Fix incorrect date in 1.2.7-par-1 (Closes: #527352)
* debian/control:
  - Add Vcs-Browser and Vcs-Git to alioth.
  - Bump Standards-Version to 3.9.1.
* debian/copyright: Updated as per DEP-5 specification.
* debian/pdnsd-recurse.conf:
  - Adding recurse mode. (Closes: #602262)
  - Fixing recursive neg section. (Closes: #519656)
* doc/pdnsd.conf.in: Separate ip address by new line. Thanks to
  Raphael Geissert. (Closes: #597734)
* perm_cache size set to default. (Closes: #602329)
  - doc/pdnsd.conf.in
  - debian/pdnsd.conf
  - debian/pdnsd-recurse.conf
  - debian/pdnsd-resolvconf.conf
* debian/002_NetMan_pdnsd: add compabilty with WiFi. 
  (Closes: #617373, LP: #452351)
* Ack'd NMU upload. (Closes: #548173)
* Update debconf Indonesian translations. (Closes: #610148)
* Switch to quilt system.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/doc.html
2
2
<html>
3
3
  <head>
4
4
    <title>pdnsd Documentation</title>
 
5
    <meta http-equiv="Content-type" content="text/html; charset=ISO-8859-1">
5
6
    <style type="text/css">
6
7
      <!--
7
8
      .small { font-family:helvetica; font-size:small; text-align:center; }
41
42
    License,  as  published by the Free Software Foundation; either version
42
43
    3, or (at your option) any later version.<br>
43
44
    You can find a copy of the GNU GPL in the file <code>COPYING</code> in the source or documentation directory.<br>
44
 
    This manual is up-to-date for version 1.2.7-par. For older documentation, please refer to the doc
 
45
    This manual is up-to-date for version 1.2.8-par. For older documentation, please refer to the doc
45
46
    directory of the respective pdnsd package.<br>
46
47
    A somewhat outdated pdnsd HOWTO (&quot;unofficial&quot; step-by-step installation and setup instructions)
47
48
    is available at <a href="http://www.geocities.com/sunil_tt/">http://www.geocities.com/sunil_tt/</a>.
901
902
      </tr>
902
903
      <tr>
903
904
        <td>
904
 
          <b><code>neg_rrs_pol=(on|off|auth);</code></b><br>
 
905
          <b><code>neg_rrs_pol=(on|off|auth|default);</code></b><br>
905
906
          This sets the RR set policy for negative caching; this tells pdnsd under which circumstances
906
907
          it should cache a record type negatively for a certain domain. <code>off</code> will
907
908
          turn the negative caching of record types off, <code>on</code> will always add a negative
908
909
          cache entry when a name server did not return a record type we asked it for, and <code>auth</code>
909
910
          will only add such entries if the answer came from an authoritative name server for that
910
 
          domain. The preset is <code>auth</code>. This is normally the right thing, as some caching servers
911
 
          behave strangely.
 
911
          domain.<br>
 
912
          <em>New in version 1.2.8:</em> The <code>default</code> setting will add a negatively cached record
 
913
          if either the answer was authoritive or the answer indicated the name server had "recursion available"
 
914
          while the query explicitly requested such recursion.<br>
 
915
          The preset is "<code>default</code>" (used to be <code>auth</code>).
912
916
        </td>
913
917
      </tr>
914
918
      <tr>
982
986
      </tr>
983
987
      <tr>
984
988
        <td>
 
989
          <b><code>ignore_cd=(on|off);</code></b><br>
 
990
          <em>New in version 1.2.8:</em> This option lets you specify that the CD bit of a DNS query will be ignored.
 
991
          Otherwise pdnsd will reply FORMERR to clients that set this bit in a query.
 
992
          It is safe to enable this option, as the CD bit refers to 'Checking Disabled'
 
993
          which means that the client will accept non-authenticated data.<br>
 
994
          This option is on by default. Turn it off if you want the old behaviour (before version 1.2.8).
 
995
        </td>
 
996
      </tr>
 
997
      <tr>
 
998
        <td>
985
999
          <b><code>scheme_file=<i>string</i>;</code></b><br>
986
1000
          In addition to normal uptests, you may specify that some servers shall only be queried when a certain
987
1001
          pcmcia-cs scheme is active (only under linux). For that, pdnsd needs to know where the file resides that
1454
1468
          <b><code>purge_cache=(on|off);</code></b><br>
1455
1469
          In every fetched dns record, there is a cache timeout given, which 
1456
1470
          specifies how long the fetched data may be cached until it needs to be 
1457
 
          reloaded. If <code>purge_cache</code> is set to <code>off</code>, the cached records are not purged 
 
1471
          reloaded. If <code>purge_cache</code> is set to <code>off</code>, the stale records are not purged 
1458
1472
          (unless the cache size would be exceeded, in this case the oldest records are purged). 
1459
1473
          Instead, they are still served if they cannot succesfully be
1460
 
          updated (e.g. because all servers are down).
 
1474
          updated (e.g. because all servers are down).<br>
 
1475
          Default is <code>off</code>.
1461
1476
        </td>
1462
1477
      </tr>
1463
1478
      <tr>
1520
1535
      </tr>
1521
1536
      <tr>
1522
1537
        <td>
1523
 
          <b><code><a name="rootserver">root_server=(on|off);</a></code></b><br>
1524
 
          <em>New in version 1.2:</em> Set this option to <code>on</code> if the servers
1525
 
          specified in a section are root servers. A root server will typically only give
1526
 
          the name servers for the top-level domain in its reply. Setting <code>root_server=on</code>
1527
 
          will cause pdnsd to try to use cached information about top-level domains to reduce to number
1528
 
          of queries to root servers, making the resolving of new names more efficient.
 
1538
          <b><code><a name="rootserver">root_server=(on|off|discover);</a></code></b><br>
 
1539
          Set this option to <code>on</code> if the servers specified in a section are root servers.
 
1540
          A root server will typically only give the name servers for the top-level domain in its reply.
 
1541
          Setting <code>root_server=on</code> will cause pdnsd to try to use cached information about
 
1542
          top-level domains to reduce to number of queries to root servers, making the resolving of
 
1543
          new names more efficient.
1529
1544
          You can get a list of available root servers by running the command
1530
1545
          <code>"dig&nbsp;.&nbsp;ns"</code>.<br>
1531
1546
          This option is also necessary if you use the <a href="#delegationonly"><code>delegation_only</code></a> option.<br>
 
1547
          <em>New in version 1.2.8:</em> This option may also be set to "<code>discover</code>".
 
1548
          This will cause pdnsd to query the servers provided with the <code>ip=</code> option
 
1549
          to obtain the full list of root servers. The root-server addresses will replace the addresses
 
1550
          specified with the <code>ip=</code> option.
 
1551
          This will only be done once on startup, or after a "<code>pdnsd-ctl&nbsp;config</code>" command.
 
1552
          In this case the name servers specified with the <code>ip=</code> option don't have to be
 
1553
          root servers, they just have to know the names and addresses of the root servers.
 
1554
          After root-server discovery pdnsd will behave just as if <code>root_server=on</code>
 
1555
          had been specified.<br>
1532
1556
          Default is <code>off</code>.
1533
1557
        </td>
1534
1558
      </tr>
2477
2501
    Copyright&nbsp;(C)&nbsp;2003,&nbsp;2004,&nbsp;2005,&nbsp;2006,&nbsp;2007,&nbsp;2008&nbsp;<a href="mailto:p.a.rombouts@home.nl">Paul&nbsp;Rombouts</a>
2478
2502
    </address>
2479
2503
    <p>
2480
 
      <i>Last revised: 04 September 2008 by Paul Rombouts</i>
 
2504
      <i>Last revised: 24 December 2009 by Paul Rombouts</i>
2481
2505
    </p>
2482
2506
  </body>
2483
2507
</html>