PowerDNS manual


Table of Contents
1. The PowerDNS dynamic nameserver
1.1. Function & design of PDNS
1.2. About this document
1.3. Release notes
1.3.1. 1.99.9 Early Access Prerelease
1.3.2. 1.99.8 Early Access Prerelease
1.3.3. 1.99.7 Early Access Prerelease
1.3.4. 1.99.6 Early Access Prerelease
1.3.5. 1.99.5 Early Access Prerelease
1.3.6. 1.99.4 Early Access Prerelease
1.3.7. 1.99.3 Early Access Prerelease
1.3.8. 1.99.2 Early Access Prerelease
1.3.9. 1.99.1 Early Access Prerelease
1.4. Acknowledgements
2. Installing
2.1. Possible problems at this point
2.2. Testing your install
2.2.1. Typical errors
3. Running PDNS
4. Configure database connectivity
4.1. Configuring MySQL
4.1.1. Common problems
5. Dynamic resolution using the PipeBackend
5.1. Deploying the PipeBackend with the BindBackend
6. Monitoring PDNS performance
6.1. Webserver
6.2. Via init.d commands
7. Security settings & considerations
7.1. Settings
7.1.1. Running as a less privileged identity
7.1.2. Jailing the process in a chroot
7.2. Considerations
8. Virtual hosting
9. Performance related settings
9.1. PacketCache
10. Migrating to PDNS
10.1. Zone2sql
11. Recursion
11.1. Details
12. Slave operation
12.1. Details
12.2. Supermaster automatic provisioning of slaves
13. Fancy records for seamless email and URL integration
14. Index of all settings
15. Index of all internal metrics
15.1. Counters & variables
15.1.1. Ring buffers
16. Supported record types and their storage
A. Backends in detail
A.1. PipeBackend protocol
A.1.1. Handshake
A.1.2. Questions
A.1.3. Answers
A.1.4. Sample perl backend
A.2. MySQL backend
A.2.1. Configuration settings
A.2.2. Notes
A.3. Generic MySQL backend
A.4. Generic PgSQL backend
A.4.1. Settings
A.5. Generic Oracle backend
A.6. Bind zone file backend
A.6.1. Operation
A.6.2. Performance
A.6.3. Master/slave configuration
B. PDNS internals
B.1. Controlsocket
B.2. Guardian
B.3. Modules & Backends
B.4. How PDNS translates DNS queries into backend queries
C. Backend writers' guide
C.1. Simple read-only non-slave backends
C.1.1. A sample minimal backend
C.1.2. Interface definition
C.1.3. Reporting errors
C.1.4. Declaring and reading configuration details
C.2. Read/write slave-capable backends
List of Tables
16-1. SOA fields
C-1. DNSResourceRecord class
C-2. SOAData struct