From cfd0f28a53721dc3c349dbc1dbcc4cfa7c64d29c Mon Sep 17 00:00:00 2001 From: Bert Hubert Date: Fri, 10 Mar 2006 13:10:23 +0000 Subject: [PATCH] documentation changes, add spiffy links to trac git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@575 d19b8d6e-7fed-0310-83ef-9ca221ded41b --- pdns/docs/Makefile | 16 ++-- pdns/docs/expand | 9 ++ pdns/docs/pdns.sgml | 205 ++++++++++++++++++++++++++++++++++++++------ 3 files changed, 199 insertions(+), 31 deletions(-) create mode 100755 pdns/docs/expand diff --git a/pdns/docs/Makefile b/pdns/docs/Makefile index b0e71e9a9..3b7ca4acb 100644 --- a/pdns/docs/Makefile +++ b/pdns/docs/Makefile @@ -1,23 +1,27 @@ -# $Id: Makefile,v 1.4 2003/09/21 16:06:45 ahu Exp $ +# $Id$ all: pdns.txt pdns.pdf html/index.html html.tar.gz - +pdns-expanded.sgml: pdns.sgml + ./expand < $< > $@ + clean: rm -rf *.dvi *.pdf *.tex *.toc *.aux *.txt *.ps *.bak *.tmp *~ *.log html.tar.gz html pdns -html/index.html: pdns.sgml +html/index.html: pdns-expanded.sgml db2html -V %use-id-as-filename% -o html $< html.tar.gz: html/index.html tar czf html.tar.gz html/ -%.txt: %.sgml +%.txt: %-expanded.sgml docbook2txt $< -%.pdf: %.sgml +%.pdf: %-expanded.sgml docbook2pdf $< publish: rsync --copy-links --delete -avrze ssh ./html pdns.txt pdns.pdf \ - exit.powerdns.com:/opt/websites/downloads.powerdns.com/www/documentation/ \ No newline at end of file + exit.powerdns.com:/opt/websites/downloads.powerdns.com/www/documentation/ + ssh exit.powerdns.com ln -s /opt/websites/downloads.powerdns.com/www/documentation/images \ + /opt/websites/downloads.powerdns.com/www/documentation/html/ diff --git a/pdns/docs/expand b/pdns/docs/expand new file mode 100755 index 000000000..635e2f9e7 --- /dev/null +++ b/pdns/docs/expand @@ -0,0 +1,9 @@ +#!/bin/sh +sed \ +'s|c\([0-9][0-9][0-9]*\)|commit \1|g' | +sed \ +'s|C\([0-9][0-9][0-9]*\)|\1|g' | +sed \ +'s|\sT\([0-9][0-9]*\)| \1|g' | +sed \ +'s|\st\([0-9][0-9]*\)| ticket \1|g' \ No newline at end of file diff --git a/pdns/docs/pdns.sgml b/pdns/docs/pdns.sgml index 96964d500..eeb18969d 100644 --- a/pdns/docs/pdns.sgml +++ b/pdns/docs/pdns.sgml @@ -1,8 +1,8 @@ - - - PowerDNS manual - + + + PowerDNS manual + PowerDNS BV
@@ -21,7 +21,7 @@ -- Dilbert - + @@ -36,7 +36,6 @@ of backends. These backends can either be plain zonefiles or be more dynamic in nature. - Prime examples of backends include relational databases, but also loadbalancing and failover algorithms. @@ -81,6 +80,162 @@ Before proceeding, it is advised to check the release notes for your PDNS version, as specified in the name of the distribution file. + Version 2.9.20 (unreleased) + + Besides adding OpenDBX, this release is mostly about fixing problems and speeding up the recursor. This release has been made possible by + XS4ALL and True. + + + Bugs fixed in the recursor: + + + + Possible stability issues in the recursor on encountering errors (c532, c533) + + + + + Memory leaks in recursor fixed (c534, c572). In a test 800 million real life DNS packets have been sent to the + recursor, representing several days of traffic from a major ISP, memory use was high (500MB), but stable. + + + + + Prune all data in PowerDNS - previously per-nameserver and per-query performance + statistics were kept around forever (c535) + + + + + IPv6 additional processing was broken. Reported by Lionel Elie Mamane, who also provided a fix. The problem + was fixed differently in the end. c562. + + + + + pdns_recursor did not shuffle answers since 2.9.19, leading to problems sending mail to the Hotmail servers. + Reported in t54, fixed in c567. + + + + + If a single nameserver had multiple IP addresses listed, PowerDNS would only use one of them. Noted by + Mark Martin, fixed in c570, who depends on a domain with 4 nameserver IP addresses of which 2 are broken. + + + + + + + + Improvements to the recursor: + + + + Commits C540, C541, C542, C543, C545, C547 and C548, C574 all speed up the recursor by a large factor, + without altering the DNS algorithm. + + + + + c549 and c550 work around gcc bug 24704 + if requested, which speeds up the recursor a lot, but involves a dirty hack. Enable with + ./configure --enable-gcc-skip-locking. No guarantees! + + + + + Bugs fixed in the authoritative nameserver: + + + + PowerDNS would no longer allow a '/' in domain names, fixed by c537, reported in t48. + + + + + On some compilers, processing of NAPTR records could cause the server to crash. Reported by Bernd Froemel + in t29, fixed in c538. + + + + + Referrals were subtly broken by recent CNAME/Wildcard improvements, fixed in c539. Fix and other + improvements sponsored by True. + + + + + PowerDNS would try to insert records it has no knowledge about in slave zones, which did not work. Reported + in t60, fixed in c566. A superior fix would be to implement the relevant unknown record standard. + + + + Improvements to the authoritative nameserver: + + + + Pipebackend did not properly propagate the ABI version to its children, fixed in c546, reported by + kickdaddy@gmail.com in t45. + + + + + OpenDBX backend added + (c559, c560, c561) by Norbert Sendetzky. From the website: + + The OpenDBX backend enables it to fetch DNS information from every DBMS supported by the OpenDBX library + and combines the power of one of the best DNS server implementations with the flexibility of the OpenDBX + library. + + OpenDBX adds some other features like database failover. Thanks Norbert! + + + + + LDAP fixes as reported in t37, fixed in c558, which maked pdns_control notify + work. + + + + + Arjo Hooimeijer added support for soa-refresh-default, soa-retry-default, + soa-expire-default, which were previously hardcoded. c563 and fallout in c573 (thanks to Wolfram Schlich). + + + + Miscellaneous: + + + + Fixes for g++ 4.1. Compiling with 4.1 realizes notable speedups. c568, c569. + + + + + PowerDNS now reports if it is running in 32 or 64 bit mode, useful for bi-arch users that need + to know if they are benefitting from their great processor. c571. + + + + + dnsscope compiles again, c551, c564 (FreeBSD 64-bit time_t). + + + + + Build scripts were added, mostly for internal use but we know some PowerDNS users build their + own packages too. c553, c554, c555, c556, c557. + + + + + bootstrap script was not included in release. Thanks to Stefan Arentz for noticing. Fixed in c574. + + + + + Version 2.9.19 Released 29th of October 2005. @@ -145,7 +300,7 @@ PowerDNS now prints out a warning when running with legacy LinuxThreads implementation instead of the high performance NPTL - library, see . Commit 455. + library, see . c455. @@ -155,22 +310,22 @@ - SPF records are now supported natively. Commit 472, closing ticket 22. + SPF records are now supported natively. c472, closing t22. - Improved IPv6 'bound to' messages. Thanks to Niels Bakker, Wichert Akkermans and Gerty de Wolf for suggestions. + Improved IPv6 'bound to' messages. Thanks to Niels Bakker, Wichert Akkerman and Gerty de Wolf for suggestions. - Separate graphs can now be made of IPv6 queries and answers. Commit 485. + Separate graphs can now be made of IPv6 queries and answers. c485. - Out of zone additional processing is now on by default to better comply with standards. Commit 487. + Out of zone additional processing is now on by default to better comply with standards. c487. @@ -212,34 +367,34 @@ Domain name validation has been made a lot stricter - it turns out PostgreSQL was interpreting some (corrupt) domain names - as unicode. Tested and suggested by Register.com (commit 451). + as unicode. Tested and suggested by Register.com (c451). - LDAP backend did not compile (commit 452, 453) due to partially applied patch (Norbert Sendetzky) + LDAP backend did not compile (commits C452, C453) due to partially applied patch (Norbert Sendetzky) - Incoming zone transfers work reliably again. Commit 460 and beyond. And 523 - closing Debian bug 330184. + Incoming zone transfers work reliably again. Fixed in c460 and beyond. And c523 - closing Debian bug 330184. - Recent g++ versions exposed a mistake in the PowerDNS recursor cache pruning code, causing random crashes. Fixed. Commit 465. Reported by + Recent g++ versions exposed a mistake in the PowerDNS recursor cache pruning code, causing random crashes. Fixed in c465. Reported by several Red Hat users. - PowerDNS recursor, and MTasker in general, did not work on Solaris. Patch by Juergen Ilse. Commit 471. Also moved most of PowerDNS over to - uint32_t style typedefs, which eases compilation problems on Solaris. Commit 477. + PowerDNS recursor, and MTasker in general, did not work on Solaris. Patch by Juergen Ilse, c471. Also moved most of PowerDNS over to + uint32_t style typedefs, which eases compilation problems on Solaris, c477. - Bindbackend2 did not properly search its include path for $INCLUDE statements. Noted by Mark Bergsma. Commit 474. + Bindbackend2 did not properly search its include path for $INCLUDE statements. Noted by Mark Bergsma, c474. @@ -249,39 +404,39 @@ - Pipebackend did not clean up, leading to an additional pipe backend per AXFR or pdns_control reload. Discovered by Marc Jauvin, fixed by commit 525. + Pipebackend did not clean up, leading to an additional pipe backend per AXFR or pdns_control reload. Discovered by Marc Jauvin, fixed by c525. Bindbackend (both old and current versions) did not honour 'include' statements in named.conf - on pdns_control rediscover. Noted by Marc Jauvin, fixed by commit 526. + on pdns_control rediscover. Noted by Marc Jauvin, fixed by c526. - Zone transfers were sometimes shuffled, which wastes useless time. Commit 478. + Zone transfers were sometimes shuffled, which wastes useless time, c478. - CNAMEs and Wildcards now work as in Bind, fixing many complaints. Commit 487. + CNAMEs and Wildcards now work as in Bind, fixing many complaints, c487. - NAPTR records were compressed, which would work, but was in violation of the RFC. Commit 493. + NAPTR records were compressed, which would work, but was in violation of the RFC, commit 493. - NAPTR records were not always parsed correctly from BIND zonefiles, fixed. Commit 494. + NAPTR records were not always parsed correctly from BIND zonefiles, fixed, commit 494. - Geobackend needed additional include statement to compile on more recent Linux distrbutions. Commit 496. + Geobackend needed additional include statement to compile on more recent Linux distrbutions, commit 496. -- 2.50.0