From: Peter van Dijk Date: Wed, 3 Oct 2012 10:24:10 +0000 (+0000) Subject: Minor doc fixes from Christian Hofstaedtler X-Git-Tag: auth-3.2-rc1~155 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=76ff4ffed31790d75b9fd0ebec1b42fb99a11f3b;p=thirdparty%2Fpdns.git Minor doc fixes from Christian Hofstaedtler git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@2727 d19b8d6e-7fed-0310-83ef-9ca221ded41b --- diff --git a/pdns/docs/pdns.xml b/pdns/docs/pdns.xml index b2a4710652..8eba0259a8 100644 --- a/pdns/docs/pdns.xml +++ b/pdns/docs/pdns.xml @@ -11855,7 +11855,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Like allow-from, except reading from file. Overrides the 'allow-from' setting. To use this feature, supply one netmask per line, with optional comments preceeded by a #. - Available since 3.1.5. + Available since version 3.1.5. @@ -11876,7 +11876,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Comma separated list of 'zonename=filename' pairs. Zones read from these files (in BIND format) are served authoritatively. Example: - auth-zones= ds9a.nl=/var/zones/ds9a.nl, powerdns.com=/var/zones/powerdns.com. Available since 3.1. + auth-zones= ds9a.nl=/var/zones/ds9a.nl, powerdns.com=/var/zones/powerdns.com. Available since version 3.1. @@ -11924,7 +11924,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR disable-packetcache - Turn off the packet cache. Useful when running with Lua scripts that can not be cached. Available since 3.2. + Turn off the packet cache. Useful when running with Lua scripts that can not be cached. Available since version 3.2. @@ -11953,7 +11953,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR export-etc-hosts - If set, this flag will export the host names and IP addresses mentioned in /etc/hosts. Available since 3.1. + If set, this flag will export the host names and IP addresses mentioned in /etc/hosts. Available since version 3.1. @@ -11969,7 +11969,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR generation of 'pc.home.com' within the recursor. An entry called 'server1.home' will be stored as 'server1.home', regardless of the export-etc-hosts setting. Available - in since 3.4. + in since version 3.4. @@ -11989,7 +11989,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Comma separated list of 'zonename=IP' pairs. Queries for zones listed here will be forwarded to the IP address listed. - forward-zones= ds9a.nl=213.244.168.210, powerdns.com=127.0.0.1. Available since 3.1. + forward-zones= ds9a.nl=213.244.168.210, powerdns.com=127.0.0.1. Available since version 3.1. Since version 3.1.5, multiple IP addresses can be specified. Additionally, port numbers other than 53 can be configured. @@ -12006,10 +12006,10 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Same as forward-zones, parsed from a file. Only 1 zone is allowed per line, specified as follows: - ds9a.nl=213.244.168.210, 1.2.3.4:5300. No comments are allowed. Available since 3.1.5. + ds9a.nl=213.244.168.210, 1.2.3.4:5300. No comments are allowed. Available since version 3.1.5. - Since 3.2, zones prefixed with a '+' are forwarded with the recursion-desired bit set to one, for which see 'forward-zones-recurse'. Default behaviour without '+' + Since version 3.2, zones prefixed with a '+' are forwarded with the recursion-desired bit set to one, for which see 'forward-zones-recurse'. Default behaviour without '+' is as with 'forward-zones'. @@ -12019,7 +12019,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Like regular 'forward-zones' (see above), but forwarded queries have the 'recursion desired' bit set to 1, meaning that this setting is intended to forward queries - to authoritative servers or to resolving servers. Available since 3.2. + to authoritative servers or to resolving servers. Available since version 3.2. @@ -12027,7 +12027,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR hint-file - If set, the root-hints are read from this file. If unset, default root hints are used. Available since 2.9.19. + If set, the root-hints are read from this file. If unset, default root hints are used. Available since version 2.9.19. @@ -12038,7 +12038,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR Local IPv4 or IPv6 addresses to bind to, comma separated. Defaults to only loopback. Addresses can also contain port numbers, for IPv4 specify like this: 1.2.3.4:5300, for IPv6: [::1]:5300. Port specifications are available since - 3.1.2. + version 3.1.2. When binding to wildcard addresses, UNIX semantics mean that answers may not be sent from the address a query was received on. It is highly recommended to bind to explicit addresses. @@ -12085,7 +12085,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR max-packetcache-entries - Maximum number of Packet Cache entries. 1 million per thread will generally suffice for most installations. Available since 3.2. + Maximum number of Packet Cache entries. 1 million per thread will generally suffice for most installations. Available since version 3.2. @@ -12093,7 +12093,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR max-cache-ttl - Maximum number of seconds to cache an item in the DNS cache, no matter what the original TTL specified. Available since 3.2. + Maximum number of seconds to cache an item in the DNS cache, no matter what the original TTL specified. Available since version 3.2. @@ -12112,7 +12112,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR max-tcp-clients - Maximum number of simultaneous incoming TCP connections allowed. Defaults to 128. Available since 2.9.18. + Maximum number of simultaneous incoming TCP connections allowed. Defaults to 128. Available since version 2.9.18. @@ -12128,7 +12128,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR network-timeout - Number of milliseconds to wait for a remote authoritative server to respond. Defaults to 1500 msec, available since 3.2. + Number of milliseconds to wait for a remote authoritative server to respond. Defaults to 1500 msec, available since version 3.2. @@ -12136,7 +12136,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR packetcache-ttl - Maximum number of seconds to cache an item in the packet cache, no matter what the original TTL specified. Available since 3.2. + Maximum number of seconds to cache an item in the packet cache, no matter what the original TTL specified. Available since version 3.2. @@ -12144,7 +12144,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR packetcache-servfail-ttl - Maximum number of seconds to cache a 'server failure' answer in the packet cache. Available since 3.2. + Maximum number of seconds to cache a 'server failure' answer in the packet cache. Available since version 3.2. @@ -12152,7 +12152,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR query-local-address - Send out local queries from this address, or addresses. Since 3.2, by adding multiple addresses, increased spoofing resilience is achieved. Addresses can be separated by a comma. + Send out local queries from this address, or addresses. Since version 3.2, by adding multiple addresses, increased spoofing resilience is achieved. Addresses can be separated by a comma. @@ -12160,7 +12160,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR query-local-address6 - Send out local IPv6 queries from this address or addresses Disabled by default, which also disables + Send out local IPv6 queries from this address or addresses. Disabled by default, which also disables outgoing IPv6 support. Since version 3.2, multiple addresses can be specified, separated by a comma. @@ -12248,7 +12248,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR version - Print version of this binary. Useful for checking which version of the PowerDNS recursor is installed on a system. Available since 3.1.5. + Print version of this binary. Useful for checking which version of the PowerDNS recursor is installed on a system. Available since version 3.1.5. @@ -12327,7 +12327,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR get-all - Retrieve all statistics in one go. Available since 3.2. + Retrieve all statistics in one go. Available since version 3.2. @@ -12335,7 +12335,7 @@ sql> insert into domainmetadata (domain_id, kind, content) values (7,'ALLOW-AXFR get-parameter parameter1 parameter2 .. - Retrieve a configuration parameter. All parameters from the configuration and command line can be queried. Available since 3.2. + Retrieve a configuration parameter. All parameters from the configuration and command line can be queried. Available since version 3.2. @@ -12719,14 +12719,14 @@ Feb 10 14:16:03 stats: 125784 questions, 13971 cache entries, 309 negative entri DNS query, overriding the internet. This is useful to combat botnets, or to disable domains unacceptable to an organization for whatever reason. - postresolve ( remoteip, domain, qtype, records, origrcode ) is called right before returning a response to a client (and, unless setvariable() is called, to the packet cache too). It allows inspection and modification of almost any detail in the return packet. Available since 3.4. + postresolve ( remoteip, domain, qtype, records, origrcode ) is called right before returning a response to a client (and, unless setvariable() is called, to the packet cache too). It allows inspection and modification of almost any detail in the return packet. Available since version 3.4. function nxdomain ( remoteip, domain, qtype ) is called after the DNS resolution process has run its course, but ended in an 'NXDOMAIN' situation, indicating that the domain or the specific record does not exist. This can be used for various purposes. - function nodata ( remoteip, domain, qtype, records ) is just like nxdomain, except it gets called when a domain exists, but the requested type does not. This is where one would implement DNS64. Available since 3.4. + function nodata ( remoteip, domain, qtype, records ) is just like nxdomain, except it gets called when a domain exists, but the requested type does not. This is where one would implement DNS64. Available since version 3.4. @@ -12849,16 +12849,16 @@ end a number of netmasks. If any of these match, the function returns true. - To log messages with the main PowerDNS Recursor process, use pdnslog(message). Available since 3.2. + To log messages with the main PowerDNS Recursor process, use pdnslog(message). Available since version 3.2. - To retrieve the IP address on which a query was received, use getlocaladdress(). Available since 3.2. + To retrieve the IP address on which a query was received, use getlocaladdress(). Available since version 3.2. - To indicate that an answer should not be cached in the packet cache, use setvariable(). Available since 3.3. + To indicate that an answer should not be cached in the packet cache, use setvariable(). Available since version 3.3. - To get fake AAAA records for DNS64 usage, use return "getFakeAAAARecords", domain, "fe80::21b:77ff:0:0". Available since 3.4. + To get fake AAAA records for DNS64 usage, use return "getFakeAAAARecords", domain, "fe80::21b:77ff:0:0". Available since version 3.4. @@ -13172,7 +13172,7 @@ end is especially useful as it triggers an immediate retrieval of the zone from the configured master. - Since 2.9.21, PowerDNS supports multiple masters. For the BIND backend, the native BIND configuration language suffices to specify + Since version 2.9.21, PowerDNS supports multiple masters. For the BIND backend, the native BIND configuration language suffices to specify multiple masters, for SQL based backends, list all master servers separated by commas in the 'master' field of the domains table. Supermaster automatic provisioning of slaves @@ -13525,7 +13525,7 @@ To enable a Lua script for a particular slave zone, determine the domain_id for max-cache-entries - Maximum number of cache entries. 1 million will generally suffice for most installations. Available since 2.9.22. + Maximum number of cache entries. 1 million will generally suffice for most installations. Available since version 2.9.22. @@ -13599,10 +13599,10 @@ To enable a Lua script for a particular slave zone, determine the domain_id for If set, PowerDNS will send out old-fashioned root-referrals when queried for domains for which it is not authoritative. Wastes some bandwidth but may solve incoming query floods if domains are delegated to you for which you are not authoritative, but which are queried by broken - recursors. Available since 2.9.19. + recursors. Available since version 2.9.19. - Since 2.9.21, it is possible to specify 'lean' root referrals, which waste less bandwidth. + Since version 2.9.21, it is possible to specify 'lean' root referrals, which waste less bandwidth. setgid=... @@ -14605,7 +14605,7 @@ To enable a Lua script for a particular slave zone, determine the domain_id for Tools to analyse DNS traffic - DNS is highly mission critical, it is therefore necessary to be able to study and compare DNS traffic. Since 2.9.18, PowerDNS comes + DNS is highly mission critical, it is therefore necessary to be able to study and compare DNS traffic. Since version 2.9.18, PowerDNS comes with three tools to aid in analysis: @@ -14687,7 +14687,7 @@ To enable a Lua script for a particular slave zone, determine the domain_id for Number of milliseconds to wait for an answer from the backend. If this time is ever exceeded, the backend - is declared dead and a new process is spawned. Available since 2.7. + is declared dead and a new process is spawned. Available since version 2.7. @@ -14705,7 +14705,7 @@ To enable a Lua script for a particular slave zone, determine the domain_id for In the configuration file, the previous example would be stored as: pipe-regex=^www.powerdns.com;(A|ANY)$ - Available since 2.8. + Available since version 2.8.