<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>PowerDNS manual</title><link rel="stylesheet" href="docbook.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><meta name="description" content="It is a book about a Spanish guy called Manual. You should read it. -- Dilbert" /><link rel="home" href="index.html" title="PowerDNS manual" /><link rel="next" href="powerdns.html" title="Chapter 1. The PowerDNS dynamic nameserver" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">PowerDNS manual</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="powerdns.html">Next</a></td></tr></table><hr /></div><div class="book" title="PowerDNS manual"><div class="titlepage"><div><div><h1 class="title"><a id="idp4059376"></a>PowerDNS manual</h1></div><div><div class="author"><h3 class="author"></h3><div class="affiliation"><span class="orgname">PowerDNS BV<br /></span><div class="address"><p><br />
<code class="email"><<a class="email" href="mailto:powerdns.support@netherlabs.nl">powerdns.support@netherlabs.nl</a>></code><br />
</p></div></div></div></div><div><p class="pubdate">v3.0-pre $Date: 2011-01-06 23:00:05 +0100 (Thu, 06 Jan 2011) $</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>
</p><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p><br />
It is a book about a Spanish guy called Manual. You should read it.<br />
-- Dilbert<br />
</p></div></blockquote></div><p>
</p></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="powerdns.html">1. The PowerDNS dynamic nameserver</a></span></dt><dd><dl><dt><span class="sect1"><a href="powerdns.html#function-design">1. Function & design of PDNS</a></span></dt><dt><span class="sect1"><a href="about.html">2. About this document</a></span></dt><dt><span class="sect1"><a href="changelog.html">3. Release notes</a></span></dt><dd><dl><dt><span class="sect2"><a href="changelog.html#changelog-auth-3-2">3.1. PowerDNS Authoritative Server 3.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-3-1">3.2. PowerDNS Authoritative Server 3.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-2-9-22-6">3.3. Authoritative Server version 2.9.22.6</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-2-9-22-5">3.4. Authoritative Server version 2.9.22.5</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-3-0-1">3.5. PowerDNS Authoritative Server 3.0.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-3-0">3.6. PowerDNS Authoritative Server 3.0</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-3-1">3.7. Recursor version 3.3.1 </a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-3">3.8. Recursor version 3.3 </a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-2">3.9. Recursor version 3.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-7-2">3.10. Recursor version 3.1.7.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-7-1">3.11. Recursor version 3.1.7.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-2-9-22">3.12. Authoritative Server version 2.9.22</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-2-9-21-2">3.13. Authoritative Server version 2.9.21.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-auth-2-9-21-1">3.14. Authoritative Server version 2.9.21.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-7">3.15. Recursor version 3.1.7</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-6">3.16. Recursor version 3.1.6</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-5">3.17. Recursor version 3.1.5</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-21">3.18. PowerDNS Authoritative Server version 2.9.21</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-4">3.19. Recursor version 3.1.4</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-3">3.20. Recursor version 3.1.3</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-2">3.21. Recursor version 3.1.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-1-1">3.22. Recursor version 3.1.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-0-1">3.23. Recursor version 3.0.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-recursor-3-0">3.24. Recursor version 3.0</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-20">3.25. Version 2.9.20</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-19">3.26. Version 2.9.19</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-18">3.27. Version 2.9.18</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-17">3.28. Version 2.9.17</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-16">3.29. Version 2.9.16</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-15">3.30. Version 2.9.15</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-14">3.31. Version 2.9.14</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-13">3.32. Version 2.9.13</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-12">3.33. Version 2.9.12</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-11">3.34. Version 2.9.11</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-10">3.35. Version 2.9.10</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-8">3.36. Version 2.9.8</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-7">3.37. Version 2.9.7</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-6">3.38. Version 2.9.6</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-5">3.39. Version 2.9.5</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-4">3.40. Version 2.9.4</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-3">3.41. Version 2.9.3a</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-2">3.42. Version 2.9.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9-1">3.43. Version 2.9.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-9">3.44. Version 2.9</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-8">3.45. Version 2.8</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-7">3.46. Version 2.7 and 2.7.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-6-1">3.47. Version 2.6.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-6">3.48. Version 2.6</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-5-1">3.49. Version 2.5.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-5">3.50. Version 2.5</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-4">3.51. Version 2.4</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-3">3.52. Version 2.3</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-2">3.53. Version 2.2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-1">3.54. Version 2.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-0-1">3.55. Version 2.0.1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-0">3.56. Version 2.0</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-0-rc2">3.57. Version 2.0 Release Candidate 2</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-2-0-rc1">3.58. Version 2.0 Release Candidate 1</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-12">3.59. Version 1.99.12 Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-11">3.60. Version 1.99.11 Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-10">3.61. Version 1.99.10 Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-9">3.62. Version 1.99.9 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-8">3.63. Version 1.99.8 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#changelog-1-99-7">3.64. Version 1.99.7 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7473920">3.65. Version 1.99.6 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7487696">3.66. Version 1.99.5 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7505760">3.67. Version 1.99.4 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7524240">3.68. Version 1.99.3 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7541440">3.69. Version 1.99.2 Early Access Prerelease</a></span></dt><dt><span class="sect2"><a href="changelog.html#idp7564112">3.70. Version 1.99.1 Early Access Prerelease</a></span></dt></dl></dd><dt><span class="sect1"><a href="security-policy.html">4. Security</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2006-01.html">5. PowerDNS Security Advisory 2006-01: Malformed TCP queries can lead to a buffer overflow which might be exploitable</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2006-02.html">6. PowerDNS Security Advisory 2006-02: Zero second CNAME TTLs can make PowerDNS exhaust allocated stack space, and crash</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2008-01.html">7. PowerDNS Security Advisory 2008-01: System random generator can be predicted, leading to the potential to 'spoof' PowerDNS Recursor</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2008-02.html">8. PowerDNS Security Advisory 2008-02: By not responding to certain queries, domains become easier to spoof</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2008-03.html">9. PowerDNS Security Advisory 2008-02: Some PowerDNS Configurations can be forced to restart remotely</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2010-01.html">10. PowerDNS Security Advisory 2010-01: PowerDNS Recursor up to and including 3.1.7.1 can be brought down and probably exploited</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2010-02.html">11. PowerDNS Security Advisory 2010-02: PowerDNS Recursor up to and including 3.1.7.1 can be spoofed into accepting bogus data</a></span></dt><dt><span class="sect1"><a href="powerdns-advisory-2012-01.html">12. PowerDNS Security Advisory 2012-01: PowerDNS Authoritative Server can be caused to generate a traffic loop</a></span></dt><dt><span class="sect1"><a href="thanks-to.html">13. Acknowledgements</a></span></dt></dl></dd><dt><span class="chapter"><a href="installing-on-unix.html">2. Installing on Unix</a></span></dt><dd><dl><dt><span class="sect1"><a href="installing-on-unix.html#problems">1. Possible problems at this point</a></span></dt><dt><span class="sect1"><a href="testing.html">2. Testing your install</a></span></dt><dd><dl><dt><span class="sect2"><a href="testing.html#idp7785968">2.1. Typical errors</a></span></dt></dl></dd><dt><span class="sect1"><a href="pdns-on-unix.html">3. Running PDNS on unix</a></span></dt></dl></dd><dt><span class="chapter"><a href="windows.html">3. Installing on Microsoft Windows</a></span></dt><dd><dl><dt><span class="sect1"><a href="windows.html#windows-configuration">1. Configuring PDNS on Microsoft Windows</a></span></dt><dt><span class="sect1"><a href="running-on-windows.html">2. Running PDNS on Microsoft Windows</a></span></dt></dl></dd><dt><span class="chapter"><a href="configuring-db-connection.html">4. Basic setup: configuring database connectivity</a></span></dt><dd><dl><dt><span class="sect1"><a href="configuring-db-connection.html#configuring-mysql">1. Example: configuring MySQL</a></span></dt><dd><dl><dt><span class="sect2"><a href="configuring-db-connection.html#idp7884976">1.1. Common problems</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="pipebackend-dynamic-resolution.html">5. Dynamic resolution using the PipeBackend</a></span></dt><dd><dl><dt><span class="sect1"><a href="pipebackend-dynamic-resolution.html#pipe-and-bind">1. Deploying the PipeBackend with the BindBackend</a></span></dt></dl></dd><dt><span class="chapter"><a href="monitoring.html">6. Logging & Monitoring Authoritative Server performance</a></span></dt><dd><dl><dt><span class="sect1"><a href="monitoring.html#webserver">1. Webserver</a></span></dt><dt><span class="sect1"><a href="init-d-commands.html">2. Via init.d commands</a></span></dt><dt><span class="sect1"><a href="syslog.html">3. Operational logging using syslog</a></span></dt></dl></dd><dt><span class="chapter"><a href="security.html">7. Security settings & considerations</a></span></dt><dd><dl><dt><span class="sect1"><a href="security.html#settings">1. Settings</a></span></dt><dd><dl><dt><span class="sect2"><a href="security.html#idp7950656">1.1. Running as a less privileged identity</a></span></dt><dt><span class="sect2"><a href="security.html#idp7953984">1.2. Jailing the process in a chroot</a></span></dt></dl></dd><dt><span class="sect1"><a href="considerations.html">2. Considerations</a></span></dt></dl></dd><dt><span class="chapter"><a href="virtual.html">8. Virtual hosting</a></span></dt><dt><span class="chapter"><a href="performance.html">9. Authoritative Server Performance</a></span></dt><dd><dl><dt><span class="sect1"><a href="performance.html#idp7974352">1. General advice</a></span></dt><dt><span class="sect1"><a href="nptl.html">2. Native Posix Thread Library vs LinuxThreads</a></span></dt><dt><span class="sect1"><a href="performance-settings.html">3. Performance related settings</a></span></dt><dd><dl><dt><span class="sect2"><a href="performance-settings.html#packetcache">3.1. Packet Cache</a></span></dt><dt><span class="sect2"><a href="performance-settings.html#querycache">3.2. Query Cache</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="migration.html">10. Migrating to PowerDNS</a></span></dt><dd><dl><dt><span class="sect1"><a href="migration.html#zone2sql">1. Zone2sql</a></span></dt></dl></dd><dt><span class="chapter"><a href="upgrades.html">11. Notes on upgrading</a></span></dt><dd><dl><dt><span class="sect1"><a href="upgrades.html#from2.9to3.0">1. From PowerDNS Authoritative Server 2.9.x to 3.0</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#idp8047840">1.1. Frequently Asked Questions about 3.0</a></span></dt></dl></dd><dt><span class="sect1"><a href="from3.0to3.1.html">2. From PowerDNS Authoritative Server 3.0 to 3.1</a></span></dt><dt><span class="sect1"><a href="from3.1to3.2.html">3. From PowerDNS Authoritative Server 3.1 to 3.2</a></span></dt></dl></dd><dt><span class="chapter"><a href="powerdnssec-auth.html">12. Serving authoritative DNSSEC data</a></span></dt><dd><dl><dt><span class="section"><a href="powerdnssec-auth.html#dnssec-introduction">1. A brief introduction to DNSSEC</a></span></dt><dt><span class="section"><a href="dnssec-supported.html">2. Profile, Supported Algorithms, Record Types & Modes of operation</a></span></dt><dd><dl><dt><span class="section"><a href="dnssec-supported.html#dnssec-presigned-mode">2.1. DNSSEC: live-signed vs orthodox 'pre-signed' mode</a></span></dt></dl></dd><dt><span class="section"><a href="dnssec-migration.html">3. Migration</a></span></dt><dd><dl><dt><span class="section"><a href="dnssec-migration.html#powerdnssec-migration">3.1. From an existing PowerDNS installation</a></span></dt><dt><span class="section"><a href="dnssec-migration.html#dnssec-bind-migration">3.2. From existing non-DNSSEC non-PowerDNS setups</a></span></dt><dt><span class="section"><a href="dnssec-migration.html#dnssec-dnssec-migration-presigned">3.3. From existing DNSSEC non-PowerDNS setups, pre-signed</a></span></dt><dt><span class="section"><a href="dnssec-migration.html#dnssec-dnssec-migration-live">3.4. From existing DNSSEC non-PowerDNS setups, live signing</a></span></dt></dl></dd><dt><span class="section"><a href="powerdnssec.html">4. Records, Keys, signatures, hashes within PowerDNSSEC in online signing mode</a></span></dt><dd><dl><dt><span class="section"><a href="powerdnssec.html#nsecX">4.1. (Hashed) Denial of Existence</a></span></dt><dt><span class="section"><a href="powerdnssec.html#rrsig">4.2. Signatures</a></span></dt></dl></dd><dt><span class="section"><a href="pdnssec.html">5. 'pdnssec' for PowerDNSSEC command & control</a></span></dt><dt><span class="section"><a href="dnssec-advice-precautions.html">6. DNSSEC advice & precautions</a></span></dt><dd><dl><dt><span class="section"><a href="dnssec-advice-precautions.html#dnssec-packet-size-tcp">6.1. Packet sizes, fragments, TCP/IP service</a></span></dt></dl></dd><dt><span class="section"><a href="dnssec-operational-doctrine.html">7. Operational instructions</a></span></dt><dd><dl><dt><span class="section"><a href="dnssec-operational-doctrine.html#publish-ds">7.1. Publishing a DS</a></span></dt><dt><span class="section"><a href="dnssec-operational-doctrine.html#zsk-rollover">7.2. ZSK rollover</a></span></dt><dt><span class="section"><a href="dnssec-operational-doctrine.html#ksk-rollover">7.3. KSK rollover</a></span></dt><dt><span class="section"><a href="dnssec-operational-doctrine.html#going-insecure">7.4. Going insecure</a></span></dt><dt><span class="section"><a href="dnssec-operational-doctrine.html#nsec3-change">7.5. NSEC(3) change</a></span></dt></dl></dd><dt><span class="section"><a href="dnssec-modes.html">8. Modes of operation</a></span></dt><dd><dl><dt><span class="section"><a href="dnssec-modes.html#dnssec-presigned">8.1. PowerDNSSEC Pre-signed records</a></span></dt><dt><span class="section"><a href="dnssec-modes.html#dnssec-frontserver">8.2. PowerDNSSEC Front-signing</a></span></dt><dt><span class="section"><a href="dnssec-modes.html#dnssec-bind">8.3. PowerDNSSEC BIND-mode operation</a></span></dt><dt><span class="section"><a href="dnssec-modes.html#dnssec-bind-hybrid">8.4. PowerDNSSEC hybrid BIND-mode operation</a></span></dt><dt><span class="section"><a href="dnssec-modes.html#dnssec-direct-database">8.5. Rules for filling out fields in database backends</a></span></dt></dl></dd><dt><span class="section"><a href="dnssec-security.html">9. Security</a></span></dt><dt><span class="section"><a href="dnssec-performance.html">10. Performance</a></span></dt><dt><span class="section"><a href="dnssec-thanks-to.html">11. Thanks to, acknowledgements</a></span></dt></dl></dd><dt><span class="chapter"><a href="tsig.html">13. TSIG: shared secret authorization and authentication</a></span></dt><dd><dl><dt><span class="section"><a href="tsig.html#tsig-outbound-axfr">1. Provisioning outbound AXFR access</a></span></dt><dt><span class="section"><a href="tsig-outbound-notify-axfr.html">2. Provisioning signed notification and AXFR requests</a></span></dt></dl></dd><dt><span class="chapter"><a href="allow-axfr-from.html">14. AXFR ACLs</a></span></dt><dt><span class="chapter"><a href="domainmetadata.html">15. Per zone settings aka Domain Metadata</a></span></dt><dt><span class="chapter"><a href="recursion.html">16. Recursion</a></span></dt><dd><dl><dt><span class="sect1"><a href="recursion.html#recursion-details">1. Details</a></span></dt></dl></dd><dt><span class="chapter"><a href="built-in-recursor.html">17. PowerDNS Recursor: a high performance resolving nameserver</a></span></dt><dd><dl><dt><span class="sect1"><a href="built-in-recursor.html#recursor-settings">1. pdns_recursor settings</a></span></dt><dt><span class="sect1"><a href="recursor-command-line.html">2. pdns_recursor command line</a></span></dt><dt><span class="sect1"><a href="rec-control.html">3. Controlling and querying the recursor</a></span></dt><dt><span class="sect1"><a href="recursor-performance.html">4. PowerDNS Recursor performance</a></span></dt><dd><dl><dt><span class="sect2"><a href="recursor-performance.html#recursor-caches">4.1. Recursor Caches</a></span></dt></dl></dd><dt><span class="sect1"><a href="recursor-details.html">5. Details</a></span></dt><dd><dl><dt><span class="sect2"><a href="recursor-details.html#anti-spoofing">5.1. Anti-spoofing</a></span></dt><dt><span class="sect2"><a href="recursor-details.html#idp8506416">5.2. Throttling</a></span></dt></dl></dd><dt><span class="sect1"><a href="recursor-stats.html">6. Statistics</a></span></dt><dt><span class="sect1"><a href="recursor-scripting.html">7. Scripting</a></span></dt><dd><dl><dt><span class="sect2"><a href="recursor-scripting.html#idp8531600">7.1. Configuring Lua scripts</a></span></dt><dt><span class="sect2"><a href="recursor-scripting.html#idp8540416">7.2. Writing Lua PowerDNS Recursor scripts</a></span></dt></dl></dd><dt><span class="sect1"><a href="recursor-design-and-engineering.html">8. Design and Engineering of the PowerDNS Recursor</a></span></dt><dd><dl><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8583232">8.1. The PowerDNS Recursor</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8584736">8.2. Synchronous code using MTasker</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8593456">8.3. MPlexer</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8604672">8.4. MOADNSParser</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8628272">8.5. The C++ Standard Library / Boost</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8633392">8.6. Actual DNS Algorithm</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8651232">8.7. The non-cached case</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8683792">8.8. Some of the things we glossed over</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8690160">8.9. The Recursor Cache</a></span></dt><dt><span class="sect2"><a href="recursor-design-and-engineering.html#idp8701472">8.10. Some small things</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="replication.html">18. Master/Slave operation & replication</a></span></dt><dd><dl><dt><span class="sect1"><a href="replication.html#native-replication">1. Native replication</a></span></dt><dt><span class="sect1"><a href="slave.html">2. Slave operation</a></span></dt><dd><dl><dt><span class="sect2"><a href="slave.html#supermaster">2.1. Supermaster automatic provisioning of slaves</a></span></dt><dt><span class="sect2"><a href="slave.html#lua-axfr-script">2.2. Modifying a slave zone using a script</a></span></dt></dl></dd><dt><span class="sect1"><a href="master.html">3. Master operation</a></span></dt></dl></dd><dt><span class="chapter"><a href="fancy-records.html">19. Fancy records for seamless email and URL integration</a></span></dt><dt><span class="chapter"><a href="all-settings.html">20. Index of all Authoritative Server settings</a></span></dt><dt><span class="chapter"><a href="metrics.html">21. Index of all Authoritative Server metrics</a></span></dt><dd><dl><dt><span class="sect1"><a href="metrics.html#counters-variables">1. Counters & variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="metrics.html#counters">1.1. Counters</a></span></dt><dt><span class="sect2"><a href="metrics.html#idp8921056">1.2. Ring buffers</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="types.html">22. Supported record types and their storage</a></span></dt><dt><span class="chapter"><a href="faq.html">23. HOWTO & Frequently Asked Questions</a></span></dt><dd><dl><dt><span class="sect1"><a href="faq.html#pdns-help-faq">1. Getting support, free and paid FAQ</a></span></dt><dt><span class="sect1"><a href="pdns-users-faq.html">2. Using and Compiling PowerDNS FAQ</a></span></dt><dt><span class="sect1"><a href="pdns-devel-faq.html">3. Backend developer HOWTO</a></span></dt><dt><span class="sect1"><a href="powerdns-company-faq.html">4. About PowerDNS.COM BV, 'the company'</a></span></dt></dl></dd><dt><span class="chapter"><a href="tools.html">24. Other tools included with PowerDNS</a></span></dt><dd><dl><dt><span class="sect1"><a href="tools.html#nproxy">1. Notification proxy (nproxy)</a></span></dt></dl></dd><dt><span class="chapter"><a href="analysis.html">25. Tools to analyse DNS traffic</a></span></dt><dt><span class="appendix"><a href="backends-detail.html">A. Backends in detail</a></span></dt><dd><dl><dt><span class="sect1"><a href="backends-detail.html#pipebackend">1. PipeBackend</a></span></dt><dd><dl><dt><span class="sect2"><a href="backends-detail.html#pipebackend-protocol">1.1. PipeBackend protocol</a></span></dt><dt><span class="sect2"><a href="backends-detail.html#idp9184016">1.2. Notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="randombackend.html">2. Random Backend</a></span></dt><dt><span class="sect1"><a href="generic-mypgsql-backends.html">3. Generic MySQL and PgSQL backends</a></span></dt><dd><dl><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9219840">3.1. MySQL specifics</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9231056">3.2. PostgreSQL specifics</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#goracle">3.3. Oracle specifics</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9248080">3.4. Basic functionality</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#dnssec-queries">3.5. DNSSEC queries</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#master-slave-queries">3.6. Master/slave queries</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9329680">3.7. Fancy records</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9341776">3.8. Settings and specifying queries</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9359520">3.9. Native operation</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9362352">3.10. Slave operation</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9367520">3.11. Superslave operation</a></span></dt><dt><span class="sect2"><a href="generic-mypgsql-backends.html#idp9370368">3.12. Master operation</a></span></dt></dl></dd><dt><span class="sect1"><a href="oracle.html">4. Oracle backend</a></span></dt><dd><dl><dt><span class="sect2"><a href="oracle.html#idp9400256">4.1. The Database Schema</a></span></dt><dt><span class="sect2"><a href="oracle.html#idp9472608">4.2. The SQL Statements</a></span></dt></dl></dd><dt><span class="sect1"><a href="gsqlite.html">5. Generic SQLite backend (2 and 3)</a></span></dt><dd><dl><dt><span class="sect2"><a href="gsqlite.html#idp9592480">5.1. Compiling the SQLite backend</a></span></dt><dt><span class="sect2"><a href="gsqlite.html#idp9597200">5.2. Setting up the database</a></span></dt><dt><span class="sect2"><a href="gsqlite.html#idp9605776">5.3. Using the SQLite backend</a></span></dt></dl></dd><dt><span class="sect1"><a href="db2.html">6. DB2 backend</a></span></dt><dt><span class="sect1"><a href="bindbackend.html">7. Bind zone file backend</a></span></dt><dd><dl><dt><span class="sect2"><a href="bindbackend.html#idp9651008">7.1. Operation</a></span></dt><dt><span class="sect2"><a href="bindbackend.html#bind-control-commands">7.2. Pdns_control commands</a></span></dt><dt><span class="sect2"><a href="bindbackend.html#idp9664912">7.3. Performance</a></span></dt><dt><span class="sect2"><a href="bindbackend.html#idp9667648">7.4. Master/slave configuration</a></span></dt><dt><span class="sect2"><a href="bindbackend.html#idp9672048">7.5. Commands</a></span></dt></dl></dd><dt><span class="sect1"><a href="odbc.html">8. ODBC backend</a></span></dt><dt><span class="sect1"><a href="xdbbackend.html">9. XDB Backend</a></span></dt><dt><span class="sect1"><a href="ldap.html">10. LDAP backend</a></span></dt><dt><span class="sect1"><a href="opendbx.html">11. OpenDBX backend</a></span></dt><dt><span class="sect1"><a href="geo.html">12. Geo backend</a></span></dt><dt><span class="sect1"><a href="luabackend.html">13. Lua Backend</a></span></dt><dt><span class="sect1"><a href="tinydnsbackend.html">14. TinyDNS Backend</a></span></dt><dd><dl><dt><span class="sect2"><a href="tinydnsbackend.html#tinydnsbackend-parameters">14.1. Configuration Parameters</a></span></dt><dt><span class="sect2"><a href="tinydnsbackend.html#tinydnsbackend-features">14.2. Location and Timestamp support</a></span></dt><dt><span class="sect2"><a href="tinydnsbackend.html#tinydnsbackend-master-mode">14.3. Master mode</a></span></dt><dt><span class="sect2"><a href="tinydnsbackend.html#tinydnsbackend-implementation-notes">14.4. Useful implementation notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="remotebackend.html">15. Remote Backend</a></span></dt><dd><dl><dt><span class="sect2"><a href="remotebackend.html#remotebackend-compiling">15.1. Compiling</a></span></dt><dt><span class="sect2"><a href="remotebackend.html#remotebackend-usage">15.2. Usage</a></span></dt><dt><span class="sect2"><a href="remotebackend.html#remotebackend-api">15.3. API</a></span></dt><dt><span class="sect2"><a href="remotebackend.html#remotebackend-examples">15.4. Examples</a></span></dt></dl></dd></dl></dd><dt><span class="appendix"><a href="pdns-internals.html">B. PDNS internals</a></span></dt><dd><dl><dt><span class="sect1"><a href="pdns-internals.html#controlsocket">1. Controlsocket</a></span></dt><dd><dl><dt><span class="sect2"><a href="pdns-internals.html#pdnscontrol">1.1. pdns_control</a></span></dt></dl></dd><dt><span class="sect1"><a href="guardian.html">2. Guardian</a></span></dt><dt><span class="sect1"><a href="modules.html">3. Modules & Backends</a></span></dt><dt><span class="sect1"><a href="dns-to-query.html">4. How PDNS translates DNS queries into backend queries</a></span></dt><dt><span class="sect1"><a href="adding-rr-types.html">5. Adding new DNS record types</a></span></dt></dl></dd><dt><span class="appendix"><a href="backend-writers-guide.html">C. Backend writers' guide</a></span></dt><dd><dl><dt><span class="sect1"><a href="backend-writers-guide.html#simple-backends">1. Simple read-only native backends</a></span></dt><dd><dl><dt><span class="sect2"><a href="backend-writers-guide.html#idp10173008">1.1. A sample minimal backend</a></span></dt><dt><span class="sect2"><a href="backend-writers-guide.html#idp10181584">1.2. Interface definition</a></span></dt></dl></dd><dt><span class="sect1"><a href="backend-error-reporting.html">2. Reporting errors</a></span></dt><dt><span class="sect1"><a href="backend-configuration-details.html">3. Declaring and reading configuration details</a></span></dt><dt><span class="sect1"><a href="rw-backends.html">4. Read/write slave-capable backends</a></span></dt><dd><dl><dt><span class="sect2"><a href="rw-backends.html#idp10316240">4.1. Supermaster/Superslave capability</a></span></dt></dl></dd><dt><span class="sect1"><a href="master-backends.html">5. Read/write master-capable backends</a></span></dt></dl></dd><dt><span class="appendix"><a href="compiling-powerdns.html">D. Compiling PowerDNS</a></span></dt><dd><dl><dt><span class="sect1"><a href="compiling-powerdns.html#on-unix">1. Compiling PowerDNS on Unix</a></span></dt><dd><dl><dt><span class="sect2"><a href="compiling-powerdns.html#unix-aix">1.1. AIX</a></span></dt><dt><span class="sect2"><a href="compiling-powerdns.html#unix-freebsd">1.2. FreeBSD</a></span></dt><dt><span class="sect2"><a href="compiling-powerdns.html#unix-linux">1.3. Linux</a></span></dt><dt><span class="sect2"><a href="compiling-powerdns.html#unix-macosx">1.4. MacOS X</a></span></dt><dt><span class="sect2"><a href="compiling-powerdns.html#unix-openbsd">1.5. OpenBSD</a></span></dt><dt><span class="sect2"><a href="compiling-powerdns.html#unix-solaris">1.6. Solaris</a></span></dt></dl></dd><dt><span class="sect1"><a href="on-windows.html">2. Compiling PowerDNS on Windows</a></span></dt><dd><dl><dt><span class="sect2"><a href="on-windows.html#idp10358384">2.1. Assumptions</a></span></dt><dt><span class="sect2"><a href="on-windows.html#idp10369616">2.2. Prerequisites</a></span></dt><dt><span class="sect2"><a href="on-windows.html#idp10382624">2.3. Nullsoft Installer</a></span></dt><dt><span class="sect2"><a href="on-windows.html#idp10392416">2.4. Setting up the build-environment</a></span></dt><dt><span class="sect2"><a href="on-windows.html#idp10438688">2.5. Compilation</a></span></dt><dt><span class="sect2"><a href="on-windows.html#idp10452624">2.6. Miscellaneous</a></span></dt></dl></dd></dl></dd><dt><span class="appendix"><a href="license.html">E. PowerDNS license (GNU General Public License version 2)</a></span></dt><dt><span class="appendix"><a href="further-copyrights.html">F. Further copyright statements</a></span></dt><dd><dl><dt><span class="sect1"><a href="further-copyrights.html#idp10495376">1. AES implementation by Brian Gladman</a></span></dt></dl></dd><dt><span class="appendix"><a href="cryptographic-notes-eccn.html">G. Cryptographic software and export control</a></span></dt><dd><dl><dt><span class="sect1"><a href="cryptographic-notes-eccn.html#idp10506800">1. Specific United States Export Control Notes</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1.1. <a href="powerdns-advisory-2006-01.html#idp7588800">PowerDNS Security Advisory</a></dt><dt>1.2. <a href="powerdns-advisory-2006-02.html#idp7609088">PowerDNS Security Advisory</a></dt><dt>1.3. <a href="powerdns-advisory-2008-01.html#idp7625952">PowerDNS Security Advisory</a></dt><dt>1.4. <a href="powerdns-advisory-2008-02.html#idp7650352">PowerDNS Security Advisory</a></dt><dt>1.5. <a href="powerdns-advisory-2008-03.html#idp7667728">PowerDNS Security Advisory</a></dt><dt>1.6. <a href="powerdns-advisory-2010-01.html#idp7685120">PowerDNS Security Advisory</a></dt><dt>1.7. <a href="powerdns-advisory-2010-02.html#idp50272">PowerDNS Security Advisory</a></dt><dt>1.8. <a href="powerdns-advisory-2012-01.html#idp7725408">PowerDNS Security Advisory</a></dt><dt>22.1. <a href="types.html#idp8979808">SOA fields</a></dt><dt>A.1. <a href="backends-detail.html#idp9129408">PipeBackend capabilities</a></dt><dt>A.2. <a href="randombackend.html#idp9189600">Random Backend capabilities</a></dt><dt>A.3. <a href="generic-mypgsql-backends.html#idp9206848">Generic PgSQL and MySQL backend capabilities</a></dt><dt>A.4. <a href="oracle.html#idp9373904">Oracle backend capabilities</a></dt><dt>A.5. <a href="gsqlite.html#idp9580512">Generic SQLite backend capabilities</a></dt><dt>A.6. <a href="db2.html#idp9610160">DB2 backend capabilities</a></dt><dt>A.7. <a href="bindbackend.html#idp9633888">Bind zone file backend capabilities</a></dt><dt>A.8. <a href="odbc.html#idp9681408">ODBC backend capabilities</a></dt><dt>A.9. <a href="ldap.html#idp9710112">LDAP backend capabilities</a></dt><dt>A.10. <a href="opendbx.html#idp9720704">OpenDBX backend capabilities</a></dt><dt>A.11. <a href="geo.html#idp9731264">Geo backend capabilities</a></dt><dt>A.12. <a href="luabackend.html#idp9747344">Lua backend capabilities</a></dt><dt>A.13. <a href="tinydnsbackend.html#idp9759984">TinyDNS backend capabilities</a></dt><dt>A.14. <a href="remotebackend.html#idp9804016">Remote backend capabilities</a></dt><dt>C.1. <a href="backend-writers-guide.html#idp10182416">DNSResourceRecord class</a></dt><dt>C.2. <a href="backend-writers-guide.html#idp10195504">SOAData struct</a></dt><dt>C.3. <a href="rw-backends.html#idp10280320">DomainInfo struct</a></dt></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="powerdns.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. The PowerDNS dynamic nameserver</td></tr></table></div></body></html>
