BIND 10 bind10-20120517-release, updated. b786c589fa25a8b0a521b7ec51c9ef50f843f4bf [bind10-20120517-release] regenerate guide and messages document
BIND 10 source code commits
bind10-changes at lists.isc.org
Thu May 17 02:50:15 UTC 2012
The branch, bind10-20120517-release has been updated
via b786c589fa25a8b0a521b7ec51c9ef50f843f4bf (commit)
via e883d6e88789ec44ae301b88cb3d8f233516ba0a (commit)
from 8bdcbf99f497f4cae2d0344e06f8f65824706642 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit b786c589fa25a8b0a521b7ec51c9ef50f843f4bf
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed May 16 21:49:11 2012 -0500
[bind10-20120517-release] regenerate guide and messages document
This is only for date version change.
but diff is long due to generate link IDs and different build
tool ued last time.
(The plan to be done real soon is to not include these files
in the master.)
commit e883d6e88789ec44ae301b88cb3d8f233516ba0a
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed May 16 21:47:43 2012 -0500
[bind10-20120517-release] bump version for snapshot release
-----------------------------------------------------------------------
Summary of changes:
configure.ac | 2 +-
doc/guide/bind10-guide.html | 84 ++++----
doc/guide/bind10-guide.txt | 445 ++++++++++++++++++++--------------------
doc/guide/bind10-messages.html | 6 +-
4 files changed, 269 insertions(+), 268 deletions(-)
-----------------------------------------------------------------------
diff --git a/configure.ac b/configure.ac
index cf70e3f..fcc72c5 100644
--- a/configure.ac
+++ b/configure.ac
@@ -2,7 +2,7 @@
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.59])
-AC_INIT(bind10-devel, 20120405, bind10-dev at isc.org)
+AC_INIT(bind10-devel, 20120517, bind10-dev at isc.org)
AC_CONFIG_SRCDIR(README)
AM_INIT_AUTOMAKE
m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])])dnl be backward compatible
diff --git a/doc/guide/bind10-guide.html b/doc/guide/bind10-guide.html
index abead8b..8aeb05c 100644
--- a/doc/guide/bind10-guide.html
+++ b/doc/guide/bind10-guide.html
@@ -1,18 +1,18 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Guide</title><link rel="stylesheet" type="text/css" href="./bind10-guide.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><meta name="description" content="BIND 10 is a framework that features Domain Name System (DNS) suite and Dynamic Host Configuration Protocol (DHCP) servers managed by Internet Systems Consortium (ISC). It includes DNS libraries, modular components for controlling authoritative and recursive DNS servers, and experimental DHCPv4 and DHCPv6 servers. This is the reference guide for BIND 10 version 20120405. The most up-to-date version of this document (in PDF, HTML, and plain text formats), along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Guide"><div class="titlepage"><div><div><h1 class="title"><a name="id3843
20"></a>BIND 10 Guide</h1></div><div><h2 class="subtitle">Administrator Reference for BIND 10</h2></div><div><p class="releaseinfo">This is the reference guide for BIND 10 version
- 20120405.</p></div><div><p class="copyright">Copyright © 2010-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a framework that features Domain Name System
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Guide</title><link rel="stylesheet" href="./bind10-guide.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="BIND 10 is a framework that features Domain Name System (DNS) suite and Dynamic Host Configuration Protocol (DHCP) servers managed by Internet Systems Consortium (ISC). It includes DNS libraries, modular components for controlling authoritative and recursive DNS servers, and experimental DHCPv4 and DHCPv6 servers. This is the reference guide for BIND 10 version 20120517. The most up-to-date version of this document (in PDF, HTML, and plain text formats), along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Guide"><div class="titlepage"><div><div><h1 class="title"><a name="id1168
229451102"></a>BIND 10 Guide</h1></div><div><h2 class="subtitle">Administrator Reference for BIND 10</h2></div><div><p class="releaseinfo">This is the reference guide for BIND 10 version
+ 20120517.</p></div><div><p class="copyright">Copyright © 2010-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a framework that features Domain Name System
(DNS) suite and Dynamic Host Configuration Protocol (DHCP)
servers managed by Internet Systems Consortium (ISC). It
includes DNS libraries, modular components for controlling
authoritative and recursive DNS servers, and experimental DHCPv4
and DHCPv6 servers.
</p><p>
- This is the reference guide for BIND 10 version 20120405.
+ This is the reference guide for BIND 10 version 20120517.
The most up-to-date version of this document (in PDF, HTML,
and plain text formats), along with other documents for
BIND 10, can be found at <a class="ulink" href="http://bind10.isc.org/docs" target="_top">http://bind10.isc.org/docs</a>.
- </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="preface"><a href="#id383993">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="#acknowledgements">1. Acknowledgements</a></span></dt></dl></dd><dt><span class="chapter"><a href="#intro">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id384039">1.1. Supported Platforms</a></span></dt><dt><span class="section"><a href="#required-software">1.2. Required Software</a></span></dt><dt><span class="section"><a href="#starting_stopping">1.3. Starting and Stopping the Server</a></span></dt><dt><span class="section"><a href="#managing_once_running">1.4. Managing BIND 10</a></span></dt></dl></dd><dt><span class="chapter"><a href="#installation">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#build-requirements">2.1. Building Requirements</a></span></dt><dt><span class="section"><a href="#quickstart">2.2. Quick
start</a></span></dt><dt><span class="section"><a href="#install">2.3. Installation from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id384785">2.3.1. Download Tar File</a></span></dt><dt><span class="section"><a href="#id384808">2.3.2. Retrieve from Git</a></span></dt><dt><span class="section"><a href="#id384882">2.3.3. Configure before the build</a></span></dt><dt><span class="section"><a href="#id384993">2.3.4. Build</a></span></dt><dt><span class="section"><a href="#id385010">2.3.5. Install</a></span></dt><dt><span class="section"><a href="#id385036">2.3.6. Install Hierarchy</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#bind10">3. Starting BIND10 with <span class="command"><strong>bind10</strong></span></a></span></dt><dd><dl><dt><span class="section"><a href="#start">3.1. Starting BIND 10</a></span></dt><dt><span class="section"><a href="#bind10.config">3.2. Configuration of started processes</a></span></dt></dl></dd><dt><sp
an class="chapter"><a href="#msgq">4. Command channel</a></span></dt><dt><span class="chapter"><a href="#cfgmgr">5. Configuration manager</a></span></dt><dt><span class="chapter"><a href="#cmdctl">6. Remote control daemon</a></span></dt><dd><dl><dt><span class="section"><a href="#cmdctl.spec">6.1. Configuration specification for b10-cmdctl</a></span></dt></dl></dd><dt><span class="chapter"><a href="#bindctl">7. Control and configure user interface</a></span></dt><dt><span class="chapter"><a href="#authserver">8. Authoritative Server</a></span></dt><dd><dl><dt><span class="section"><a href="#id386045">8.1. Server Configurations</a></span></dt><dt><span class="section"><a href="#id386324">8.2. Data Source Backends</a></span></dt><dd><dl><dt><span class="section"><a href="#in-memory-datasource">8.2.1. In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-with-sqlite3-backend">8.2.2. In-memory Data Source With SQLite3 Backend</a></span></d
t><dt><span class="section"><a href="#in-memory-datasource-loading">8.2.3. Reloading an In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-disabling">8.2.4. Disabling In-memory Data Sources</a></span></dt></dl></dd><dt><span class="section"><a href="#id386600">8.3. Loading Master Zones Files</a></span></dt></dl></dd><dt><span class="chapter"><a href="#xfrin">9. Incoming Zone Transfers</a></span></dt><dd><dl><dt><span class="section"><a href="#id386752">9.1. Configuration for Incoming Zone Transfers</a></span></dt><dt><span class="section"><a href="#id386796">9.2. Enabling IXFR</a></span></dt><dt><span class="section"><a href="#zonemgr">9.3. Secondary Manager</a></span></dt><dt><span class="section"><a href="#id386939">9.4. Trigger an Incoming Zone Transfer Manually</a></span></dt><dt><span class="section"><a href="#id386970">9.5. Incoming Transfers with In-memory Datasource</a></span></dt></dl></dd><dt><span class="chapter"><a href=
"#xfrout">10. Outbound Zone Transfers</a></span></dt><dt><span class="chapter"><a href="#resolverserver">11. Recursive Name Server</a></span></dt><dd><dl><dt><span class="section"><a href="#id387254">11.1. Access Control</a></span></dt><dt><span class="section"><a href="#id387393">11.2. Forwarding</a></span></dt></dl></dd><dt><span class="chapter"><a href="#dhcp4">12. DHCPv4 Server</a></span></dt><dd><dl><dt><span class="section"><a href="#dhcp4-usage">12.1. DHCPv4 Server Usage</a></span></dt><dt><span class="section"><a href="#dhcp4-config">12.2. DHCPv4 Server Configuration</a></span></dt><dt><span class="section"><a href="#dhcp4-std">12.3. Supported standards</a></span></dt><dt><span class="section"><a href="#dhcp4-limit">12.4. DHCPv4 Server Limitations</a></span></dt></dl></dd><dt><span class="chapter"><a href="#dhcp6">13. DHCPv6 Server</a></span></dt><dd><dl><dt><span class="section"><a href="#dhcp6-usage">13.1. DHCPv6 Server Usage</a></span></dt><dt><span class="section
"><a href="#dhcp6-config">13.2. DHCPv6 Server Configuration</a></span></dt><dt><span class="section"><a href="#dhcp6-std">13.3. Supported DHCPv6 Standards</a></span></dt><dt><span class="section"><a href="#dhcp6-limit">13.4. DHCPv6 Server Limitations</a></span></dt></dl></dd><dt><span class="chapter"><a href="#libdhcp">14. libdhcp++ library</a></span></dt><dd><dl><dt><span class="section"><a href="#iface-detect">14.1. Interface detection</a></span></dt><dt><span class="section"><a href="#packet-handling">14.2. DHCPv4/DHCPv6 packet handling</a></span></dt></dl></dd><dt><span class="chapter"><a href="#statistics">15. Statistics</a></span></dt><dt><span class="chapter"><a href="#logging">16. Logging</a></span></dt><dd><dl><dt><span class="section"><a href="#id388289">16.1. Logging configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#id388304">16.1.1. Loggers</a></span></dt><dt><span class="section"><a href="#id388607">16.1.2. Output Options</a></span></dt><d
t><span class="section"><a href="#id388815">16.1.3. Example session</a></span></dt></dl></dd><dt><span class="section"><a href="#id389072">16.2. Logging Message Format</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>3.1. <a href="#id385324"></a></dt></dl></div><div class="preface" title="Preface"><div class="titlepage"><div><div><h2 class="title"><a name="id383993"></a>Preface</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#acknowledgements">1. Acknowledgements</a></span></dt></dl></div><div class="section" title="1. Acknowledgements"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>ISC would like to acknowledge generous support for
+ </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="preface"><a href="#id1168229451188">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="#acknowledgements">1. Acknowledgements</a></span></dt></dl></dd><dt><span class="chapter"><a href="#intro">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229451269">1.1. Supported Platforms</a></span></dt><dt><span class="section"><a href="#required-software">1.2. Required Software</a></span></dt><dt><span class="section"><a href="#starting_stopping">1.3. Starting and Stopping the Server</a></span></dt><dt><span class="section"><a href="#managing_once_running">1.4. Managing BIND 10</a></span></dt></dl></dd><dt><span class="chapter"><a href="#installation">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#build-requirements">2.1. Building Requirements</a></span></dt><dt><span class="section"><a href="#quickstar
t">2.2. Quick start</a></span></dt><dt><span class="section"><a href="#install">2.3. Installation from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229436809">2.3.1. Download Tar File</a></span></dt><dt><span class="section"><a href="#id1168229436828">2.3.2. Retrieve from Git</a></span></dt><dt><span class="section"><a href="#id1168229436889">2.3.3. Configure before the build</a></span></dt><dt><span class="section"><a href="#id1168229436986">2.3.4. Build</a></span></dt><dt><span class="section"><a href="#id1168229437002">2.3.5. Install</a></span></dt><dt><span class="section"><a href="#id1168229437026">2.3.6. Install Hierarchy</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#bind10">3. Starting BIND10 with <span class="command"><strong>bind10</strong></span></a></span></dt><dd><dl><dt><span class="section"><a href="#start">3.1. Starting BIND 10</a></span></dt><dt><span class="section"><a href="#bind10.config">3.2. Configurati
on of started processes</a></span></dt></dl></dd><dt><span class="chapter"><a href="#msgq">4. Command channel</a></span></dt><dt><span class="chapter"><a href="#cfgmgr">5. Configuration manager</a></span></dt><dt><span class="chapter"><a href="#cmdctl">6. Remote control daemon</a></span></dt><dd><dl><dt><span class="section"><a href="#cmdctl.spec">6.1. Configuration specification for b10-cmdctl</a></span></dt></dl></dd><dt><span class="chapter"><a href="#bindctl">7. Control and configure user interface</a></span></dt><dt><span class="chapter"><a href="#authserver">8. Authoritative Server</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229437965">8.1. Server Configurations</a></span></dt><dt><span class="section"><a href="#id1168229438210">8.2. Data Source Backends</a></span></dt><dd><dl><dt><span class="section"><a href="#in-memory-datasource">8.2.1. In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-with-sqlite3-ba
ckend">8.2.2. In-memory Data Source With SQLite3 Backend</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-loading">8.2.3. Reloading an In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-disabling">8.2.4. Disabling In-memory Data Sources</a></span></dt></dl></dd><dt><span class="section"><a href="#id1168229438510">8.3. Loading Master Zones Files</a></span></dt></dl></dd><dt><span class="chapter"><a href="#xfrin">9. Incoming Zone Transfers</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229438743">9.1. Configuration for Incoming Zone Transfers</a></span></dt><dt><span class="section"><a href="#id1168229438780">9.2. Enabling IXFR</a></span></dt><dt><span class="section"><a href="#zonemgr">9.3. Secondary Manager</a></span></dt><dt><span class="section"><a href="#id1168229438894">9.4. Trigger an Incoming Zone Transfer Manually</a></span></dt><dt><span class="section"><a href="#id1168229438921">9.5.
Incoming Transfers with In-memory Datasource</a></span></dt></dl></dd><dt><span class="chapter"><a href="#xfrout">10. Outbound Zone Transfers</a></span></dt><dt><span class="chapter"><a href="#resolverserver">11. Recursive Name Server</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229439222">11.1. Access Control</a></span></dt><dt><span class="section"><a href="#id1168229439337">11.2. Forwarding</a></span></dt></dl></dd><dt><span class="chapter"><a href="#dhcp4">12. DHCPv4 Server</a></span></dt><dd><dl><dt><span class="section"><a href="#dhcp4-usage">12.1. DHCPv4 Server Usage</a></span></dt><dt><span class="section"><a href="#dhcp4-config">12.2. DHCPv4 Server Configuration</a></span></dt><dt><span class="section"><a href="#dhcp4-std">12.3. Supported standards</a></span></dt><dt><span class="section"><a href="#dhcp4-limit">12.4. DHCPv4 Server Limitations</a></span></dt></dl></dd><dt><span class="chapter"><a href="#dhcp6">13. DHCPv6 Server</a></span></dt><dd
><dl><dt><span class="section"><a href="#dhcp6-usage">13.1. DHCPv6 Server Usage</a></span></dt><dt><span class="section"><a href="#dhcp6-config">13.2. DHCPv6 Server Configuration</a></span></dt><dt><span class="section"><a href="#dhcp6-std">13.3. Supported DHCPv6 Standards</a></span></dt><dt><span class="section"><a href="#dhcp6-limit">13.4. DHCPv6 Server Limitations</a></span></dt></dl></dd><dt><span class="chapter"><a href="#libdhcp">14. libdhcp++ library</a></span></dt><dd><dl><dt><span class="section"><a href="#iface-detect">14.1. Interface detection</a></span></dt><dt><span class="section"><a href="#packet-handling">14.2. DHCPv4/DHCPv6 packet handling</a></span></dt></dl></dd><dt><span class="chapter"><a href="#statistics">15. Statistics</a></span></dt><dt><span class="chapter"><a href="#logging">16. Logging</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229440555">16.1. Logging configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#i
d1168229440566">16.1.1. Loggers</a></span></dt><dt><span class="section"><a href="#id1168229440808">16.1.2. Output Options</a></span></dt><dt><span class="section"><a href="#id1168229440992">16.1.3. Example session</a></span></dt></dl></dd><dt><span class="section"><a href="#id1168229441201">16.2. Logging Message Format</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>3.1. <a href="#id1168229437266"></a></dt></dl></div><div class="preface" title="Preface"><div class="titlepage"><div><div><h2 class="title"><a name="id1168229451188"></a>Preface</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#acknowledgements">1. Acknowledgements</a></span></dt></dl></div><div class="section" title="1. Acknowledgements"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>ISC would like to a
cknowledge generous support for
BIND 10 development of DHCPv4 and DHCPv6 components provided
- by <a class="ulink" href="http://www.comcast.com/" target="_top">Comcast</a>.</p></div></div><div class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="intro"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id384039">1.1. Supported Platforms</a></span></dt><dt><span class="section"><a href="#required-software">1.2. Required Software</a></span></dt><dt><span class="section"><a href="#starting_stopping">1.3. Starting and Stopping the Server</a></span></dt><dt><span class="section"><a href="#managing_once_running">1.4. Managing BIND 10</a></span></dt></dl></div><p>
+ by <a class="ulink" href="http://www.comcast.com/" target="_top">Comcast</a>.</p></div></div><div class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="intro"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id1168229451269">1.1. Supported Platforms</a></span></dt><dt><span class="section"><a href="#required-software">1.2. Required Software</a></span></dt><dt><span class="section"><a href="#starting_stopping">1.3. Starting and Stopping the Server</a></span></dt><dt><span class="section"><a href="#managing_once_running">1.4. Managing BIND 10</a></span></dt></dl></div><p>
BIND is the popular implementation of a DNS server, developer
interfaces, and DNS tools.
BIND 10 is a rewrite of BIND 9. BIND 10 is written in C++ and Python
@@ -22,8 +22,8 @@
provides forwarding.
</p><p>
This guide covers the experimental prototype of
- BIND 10 version 20120405.
- </p><div class="section" title="1.1. Supported Platforms"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id384039"></a>1.1. Supported Platforms</h2></div></div></div><p>
+ BIND 10 version 20120517.
+ </p><div class="section" title="1.1. Supported Platforms"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229451269"></a>1.1. Supported Platforms</h2></div></div></div><p>
BIND 10 builds have been tested on Debian GNU/Linux 5 and unstable,
Ubuntu 9.10, NetBSD 5, Solaris 10, FreeBSD 7 and 8, CentOS
Linux 5.3, and MacOS 10.6.
@@ -162,7 +162,7 @@
and, of course, DNS. These include detailed developer
documentation and code examples.
- </p></div><div class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="installation"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#build-requirements">2.1. Building Requirements</a></span></dt><dt><span class="section"><a href="#quickstart">2.2. Quick start</a></span></dt><dt><span class="section"><a href="#install">2.3. Installation from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id384785">2.3.1. Download Tar File</a></span></dt><dt><span class="section"><a href="#id384808">2.3.2. Retrieve from Git</a></span></dt><dt><span class="section"><a href="#id384882">2.3.3. Configure before the build</a></span></dt><dt><span class="section"><a href="#id384993">2.3.4. Build</a></span></dt><dt><span class="section"><a href="#id385010">2.3.5. Install</a></span></dt><dt><span class="section"><a href="#id385036">2.3.6.
Install Hierarchy</a></span></dt></dl></dd></dl></div><div class="section" title="2.1. Building Requirements"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="build-requirements"></a>2.1. Building Requirements</h2></div></div></div><p>
+ </p></div><div class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="installation"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#build-requirements">2.1. Building Requirements</a></span></dt><dt><span class="section"><a href="#quickstart">2.2. Quick start</a></span></dt><dt><span class="section"><a href="#install">2.3. Installation from source</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229436809">2.3.1. Download Tar File</a></span></dt><dt><span class="section"><a href="#id1168229436828">2.3.2. Retrieve from Git</a></span></dt><dt><span class="section"><a href="#id1168229436889">2.3.3. Configure before the build</a></span></dt><dt><span class="section"><a href="#id1168229436986">2.3.4. Build</a></span></dt><dt><span class="section"><a href="#id1168229437002">2.3.5. Install</a></span></dt><dt><span class="s
ection"><a href="#id1168229437026">2.3.6. Install Hierarchy</a></span></dt></dl></dd></dl></div><div class="section" title="2.1. Building Requirements"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="build-requirements"></a>2.1. Building Requirements</h2></div></div></div><p>
In addition to the run-time requirements, building BIND 10
from source code requires various development include headers.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
@@ -224,14 +224,14 @@
the Git code revision control system or as a downloadable
tar file. It may also be available in pre-compiled ready-to-use
packages from operating system vendors.
- </p><div class="section" title="2.3.1. Download Tar File"><div class="titlepage"><div><div><h3 class="title"><a name="id384785"></a>2.3.1. Download Tar File</h3></div></div></div><p>
+ </p><div class="section" title="2.3.1. Download Tar File"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229436809"></a>2.3.1. Download Tar File</h3></div></div></div><p>
Downloading a release tar file is the recommended method to
obtain the source code.
</p><p>
The BIND 10 releases are available as tar file downloads from
<a class="ulink" href="ftp://ftp.isc.org/isc/bind10/" target="_top">ftp://ftp.isc.org/isc/bind10/</a>.
Periodic development snapshots may also be available.
- </p></div><div class="section" title="2.3.2. Retrieve from Git"><div class="titlepage"><div><div><h3 class="title"><a name="id384808"></a>2.3.2. Retrieve from Git</h3></div></div></div><p>
+ </p></div><div class="section" title="2.3.2. Retrieve from Git"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229436828"></a>2.3.2. Retrieve from Git</h3></div></div></div><p>
Downloading this "bleeding edge" code is recommended only for
developers or advanced users. Using development code in a production
environment is not recommended.
@@ -265,7 +265,7 @@
<span class="command"><strong>autoheader</strong></span>,
<span class="command"><strong>automake</strong></span>,
and related commands.
- </p></div><div class="section" title="2.3.3. Configure before the build"><div class="titlepage"><div><div><h3 class="title"><a name="id384882"></a>2.3.3. Configure before the build</h3></div></div></div><p>
+ </p></div><div class="section" title="2.3.3. Configure before the build"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229436889"></a>2.3.3. Configure before the build</h3></div></div></div><p>
BIND 10 uses the GNU Build System to discover build environment
details.
To generate the makefiles using the defaults, simply run:
@@ -296,16 +296,16 @@
</p><p>
If the configure fails, it may be due to missing or old
dependencies.
- </p></div><div class="section" title="2.3.4. Build"><div class="titlepage"><div><div><h3 class="title"><a name="id384993"></a>2.3.4. Build</h3></div></div></div><p>
+ </p></div><div class="section" title="2.3.4. Build"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229436986"></a>2.3.4. Build</h3></div></div></div><p>
After the configure step is complete, to build the executables
from the C++ code and prepare the Python scripts, run:
</p><pre class="screen">$ <strong class="userinput"><code>make</code></strong></pre><p>
- </p></div><div class="section" title="2.3.5. Install"><div class="titlepage"><div><div><h3 class="title"><a name="id385010"></a>2.3.5. Install</h3></div></div></div><p>
+ </p></div><div class="section" title="2.3.5. Install"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229437002"></a>2.3.5. Install</h3></div></div></div><p>
To install the BIND 10 executables, support files,
and documentation, run:
</p><pre class="screen">$ <strong class="userinput"><code>make install</code></strong></pre><p>
- </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The install step may require superuser privileges.</p></div></div><div class="section" title="2.3.6. Install Hierarchy"><div class="titlepage"><div><div><h3 class="title"><a name="id385036"></a>2.3.6. Install Hierarchy</h3></div></div></div><p>
+ </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The install step may require superuser privileges.</p></div></div><div class="section" title="2.3.6. Install Hierarchy"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229437026"></a>2.3.6. Install Hierarchy</h3></div></div></div><p>
The following is the layout of the complete BIND 10 installation:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
<code class="filename">bin/</code> —
@@ -397,7 +397,7 @@
during startup or shutdown. Unless specified, the component is started
in usual way. This is the list of components that need to be started
in a special way, with the value of special used for them:
- </p><div class="table"><a name="id385324"></a><p class="title"><b>Table 3.1. </b></p><div class="table-contents"><table border="1"><colgroup><col align="left" class="component"><col align="left" class="special"><col align="left" class="description"></colgroup><thead><tr><th align="left">Component</th><th align="left">Special</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left">b10-auth</td><td align="left">auth</td><td align="left">Authoritative server</td></tr><tr><td align="left">b10-resolver</td><td align="left">resolver</td><td align="left">The resolver</td></tr><tr><td align="left">b10-cmdctl</td><td align="left">cmdctl</td><td align="left">The command control (remote control interface)</td></tr></tbody></table></div></div><p><br class="table-break">
+ </p><div class="table"><a name="id1168229437266"></a><p class="title"><b>Table 3.1. </b></p><div class="table-contents"><table border="1"><colgroup><col align="left"><col align="left"><col align="left"></colgroup><thead><tr><th align="left">Component</th><th align="left">Special</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left">b10-auth</td><td align="left">auth</td><td align="left">Authoritative server</td></tr><tr><td align="left">b10-resolver</td><td align="left">resolver</td><td align="left">The resolver</td></tr><tr><td align="left">b10-cmdctl</td><td align="left">cmdctl</td><td align="left">The command control (remote control interface)</td></tr></tbody></table></div></div><p><br class="table-break">
</p><p>
The kind specifies how a failure of the component should
be handled. If it is set to <span class="quote">“<span class="quote">dispensable</span>”</span>
@@ -625,12 +625,12 @@ shutdown
the details and relays (over a <span class="command"><strong>b10-msgq</strong></span> command
channel) the configuration on to the specified module.
</p><p>
- </p></div><div class="chapter" title="Chapter 8. Authoritative Server"><div class="titlepage"><div><div><h2 class="title"><a name="authserver"></a>Chapter 8. Authoritative Server</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id386045">8.1. Server Configurations</a></span></dt><dt><span class="section"><a href="#id386324">8.2. Data Source Backends</a></span></dt><dd><dl><dt><span class="section"><a href="#in-memory-datasource">8.2.1. In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-with-sqlite3-backend">8.2.2. In-memory Data Source With SQLite3 Backend</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-loading">8.2.3. Reloading an In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-disabling">8.2.4. Disabling In-memory Data Sources</a></span></dt></dl></dd><dt><span class="section"><a href="#id386600">8
.3. Loading Master Zones Files</a></span></dt></dl></div><p>
+ </p></div><div class="chapter" title="Chapter 8. Authoritative Server"><div class="titlepage"><div><div><h2 class="title"><a name="authserver"></a>Chapter 8. Authoritative Server</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id1168229437965">8.1. Server Configurations</a></span></dt><dt><span class="section"><a href="#id1168229438210">8.2. Data Source Backends</a></span></dt><dd><dl><dt><span class="section"><a href="#in-memory-datasource">8.2.1. In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-with-sqlite3-backend">8.2.2. In-memory Data Source With SQLite3 Backend</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-loading">8.2.3. Reloading an In-memory Data Source</a></span></dt><dt><span class="section"><a href="#in-memory-datasource-disabling">8.2.4. Disabling In-memory Data Sources</a></span></dt></dl></dd><dt><span class="section"><a href
="#id1168229438510">8.3. Loading Master Zones Files</a></span></dt></dl></div><p>
The <span class="command"><strong>b10-auth</strong></span> is the authoritative DNS server.
It supports EDNS0 and DNSSEC. It supports IPv6.
Normally it is started by the <span class="command"><strong>bind10</strong></span> master
process.
- </p><div class="section" title="8.1. Server Configurations"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386045"></a>8.1. Server Configurations</h2></div></div></div><p>
+ </p><div class="section" title="8.1. Server Configurations"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229437965"></a>8.1. Server Configurations</h2></div></div></div><p>
<span class="command"><strong>b10-auth</strong></span> is configured via the
<span class="command"><strong>b10-cfgmgr</strong></span> configuration manager.
The module name is <span class="quote">“<span class="quote">Auth</span>”</span>.
@@ -712,7 +712,7 @@ This may be a temporary setting until then.
if configured.)
</dd></dl></div><p>
- </p></div><div class="section" title="8.2. Data Source Backends"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386324"></a>8.2. Data Source Backends</h2></div></div></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+ </p></div><div class="section" title="8.2. Data Source Backends"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438210"></a>8.2. Data Source Backends</h2></div></div></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
For the development prototype release, <span class="command"><strong>b10-auth</strong></span>
supports a SQLite3 data source backend and in-memory data source
backend.
@@ -791,7 +791,7 @@ This may be a temporary setting until then.
and/or <code class="varname">zones[<em class="replaceable"><code>0</code></em>]</code>
for the relevant zone as needed.)
- </p></div></div><div class="section" title="8.3. Loading Master Zones Files"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386600"></a>8.3. Loading Master Zones Files</h2></div></div></div><p>
+ </p></div></div><div class="section" title="8.3. Loading Master Zones Files"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438510"></a>8.3. Loading Master Zones Files</h2></div></div></div><p>
RFC 1035 style DNS master zone files may imported
into a BIND 10 SQLite3 data source by using the
<span class="command"><strong>b10-loadzone</strong></span> utility.
@@ -820,7 +820,7 @@ This may be a temporary setting until then.
If you reload a zone already existing in the database,
all records from that prior zone disappear and a whole new set
appears.
- </p></div></div><div class="chapter" title="Chapter 9. Incoming Zone Transfers"><div class="titlepage"><div><div><h2 class="title"><a name="xfrin"></a>Chapter 9. Incoming Zone Transfers</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id386752">9.1. Configuration for Incoming Zone Transfers</a></span></dt><dt><span class="section"><a href="#id386796">9.2. Enabling IXFR</a></span></dt><dt><span class="section"><a href="#zonemgr">9.3. Secondary Manager</a></span></dt><dt><span class="section"><a href="#id386939">9.4. Trigger an Incoming Zone Transfer Manually</a></span></dt><dt><span class="section"><a href="#id386970">9.5. Incoming Transfers with In-memory Datasource</a></span></dt></dl></div><p>
+ </p></div></div><div class="chapter" title="Chapter 9. Incoming Zone Transfers"><div class="titlepage"><div><div><h2 class="title"><a name="xfrin"></a>Chapter 9. Incoming Zone Transfers</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id1168229438743">9.1. Configuration for Incoming Zone Transfers</a></span></dt><dt><span class="section"><a href="#id1168229438780">9.2. Enabling IXFR</a></span></dt><dt><span class="section"><a href="#zonemgr">9.3. Secondary Manager</a></span></dt><dt><span class="section"><a href="#id1168229438894">9.4. Trigger an Incoming Zone Transfer Manually</a></span></dt><dt><span class="section"><a href="#id1168229438921">9.5. Incoming Transfers with In-memory Datasource</a></span></dt></dl></div><p>
Incoming zones are transferred using the <span class="command"><strong>b10-xfrin</strong></span>
process which is started by <span class="command"><strong>bind10</strong></span>.
When received, the zone is stored in the corresponding BIND 10
@@ -834,7 +834,7 @@ This may be a temporary setting until then.
IXFR. Due to some implementation limitations of the current
development release, however, it only tries AXFR by default,
and care should be taken to enable IXFR.
- </p><div class="section" title="9.1. Configuration for Incoming Zone Transfers"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386752"></a>9.1. Configuration for Incoming Zone Transfers</h2></div></div></div><p>
+ </p><div class="section" title="9.1. Configuration for Incoming Zone Transfers"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438743"></a>9.1. Configuration for Incoming Zone Transfers</h2></div></div></div><p>
In practice, you need to specify a list of secondary zones to
enable incoming zone transfers for these zones (you can still
trigger a zone transfer manually, without a prior configuration
@@ -850,7 +850,7 @@ This may be a temporary setting until then.
> <strong class="userinput"><code>config commit</code></strong></pre><p>
(We assume there has been no zone configuration before).
- </p></div><div class="section" title="9.2. Enabling IXFR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386796"></a>9.2. Enabling IXFR</h2></div></div></div><p>
+ </p></div><div class="section" title="9.2. Enabling IXFR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438780"></a>9.2. Enabling IXFR</h2></div></div></div><p>
As noted above, <span class="command"><strong>b10-xfrin</strong></span> uses AXFR for
zone transfers by default. To enable IXFR for zone transfers
for a particular zone, set the <strong class="userinput"><code>use_ixfr</code></strong>
@@ -902,13 +902,13 @@ This may be a temporary setting until then.
(i.e. no SOA record for it), <span class="command"><strong>b10-zonemgr</strong></span>
will automatically tell <span class="command"><strong>b10-xfrin</strong></span>
to transfer the zone in.
- </p></div><div class="section" title="9.4. Trigger an Incoming Zone Transfer Manually"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386939"></a>9.4. Trigger an Incoming Zone Transfer Manually</h2></div></div></div><p>
+ </p></div><div class="section" title="9.4. Trigger an Incoming Zone Transfer Manually"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438894"></a>9.4. Trigger an Incoming Zone Transfer Manually</h2></div></div></div><p>
To manually trigger a zone transfer to retrieve a remote zone,
you may use the <span class="command"><strong>bindctl</strong></span> utility.
For example, at the <span class="command"><strong>bindctl</strong></span> prompt run:
</p><pre class="screen">> <strong class="userinput"><code>Xfrin retransfer zone_name="<code class="option">foo.example.org</code>" master=<code class="option">192.0.2.99</code></code></strong></pre><p>
- </p></div><div class="section" title="9.5. Incoming Transfers with In-memory Datasource"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id386970"></a>9.5. Incoming Transfers with In-memory Datasource</h2></div></div></div><p>
+ </p></div><div class="section" title="9.5. Incoming Transfers with In-memory Datasource"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229438921"></a>9.5. Incoming Transfers with In-memory Datasource</h2></div></div></div><p>
In the case of an incoming zone transfer, the received zone is
first stored in the corresponding BIND 10 datasource. In
case the secondary zone is served by an in-memory datasource
@@ -963,7 +963,7 @@ Xfrout/transfer_acl[0] {"action": "ACCEPT"} any (default)</pre><p>
TSIGs in the incoming messages and to sign responses.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
The way to specify zone specific configuration (ACLs, etc) is
likely to be changed.
- </p></div></div><div class="chapter" title="Chapter 11. Recursive Name Server"><div class="titlepage"><div><div><h2 class="title"><a name="resolverserver"></a>Chapter 11. Recursive Name Server</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id387254">11.1. Access Control</a></span></dt><dt><span class="section"><a href="#id387393">11.2. Forwarding</a></span></dt></dl></div><p>
+ </p></div></div><div class="chapter" title="Chapter 11. Recursive Name Server"><div class="titlepage"><div><div><h2 class="title"><a name="resolverserver"></a>Chapter 11. Recursive Name Server</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id1168229439222">11.1. Access Control</a></span></dt><dt><span class="section"><a href="#id1168229439337">11.2. Forwarding</a></span></dt></dl></div><p>
The <span class="command"><strong>b10-resolver</strong></span> process is started by
<span class="command"><strong>bind10</strong></span>.
@@ -997,7 +997,7 @@ Xfrout/transfer_acl[0] {"action": "ACCEPT"} any (default)</pre><p>
</pre><p>
</p><p>(Replace the <span class="quote">“<span class="quote"><em class="replaceable"><code>2</code></em></span>”</span>
as needed; run <span class="quote">“<span class="quote"><strong class="userinput"><code>config show
- Resolver/listen_on</code></strong></span>”</span> if needed.)</p><div class="section" title="11.1. Access Control"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id387254"></a>11.1. Access Control</h2></div></div></div><p>
+ Resolver/listen_on</code></strong></span>”</span> if needed.)</p><div class="section" title="11.1. Access Control"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229439222"></a>11.1. Access Control</h2></div></div></div><p>
By default, the <span class="command"><strong>b10-resolver</strong></span> daemon only accepts
DNS queries from the localhost (127.0.0.1 and ::1).
The <code class="option">Resolver/query_acl</code> configuration may
@@ -1030,7 +1030,7 @@ Xfrout/transfer_acl[0] {"action": "ACCEPT"} any (default)</pre><p>
</pre><p>(Replace the <span class="quote">“<span class="quote"><em class="replaceable"><code>2</code></em></span>”</span>
as needed; run <span class="quote">“<span class="quote"><strong class="userinput"><code>config show
Resolver/query_acl</code></strong></span>”</span> if needed.)</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This prototype access control configuration
- syntax may be changed.</p></div></div><div class="section" title="11.2. Forwarding"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id387393"></a>11.2. Forwarding</h2></div></div></div><p>
+ syntax may be changed.</p></div></div><div class="section" title="11.2. Forwarding"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229439337"></a>11.2. Forwarding</h2></div></div></div><p>
To enable forwarding, the upstream address and port must be
configured to forward queries to, such as:
@@ -1342,7 +1342,7 @@ eth0 fe80::21e:8cff:fe9b:7349
}
}
</pre><p>
- </p></div><div class="chapter" title="Chapter 16. Logging"><div class="titlepage"><div><div><h2 class="title"><a name="logging"></a>Chapter 16. Logging</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id388289">16.1. Logging configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#id388304">16.1.1. Loggers</a></span></dt><dt><span class="section"><a href="#id388607">16.1.2. Output Options</a></span></dt><dt><span class="section"><a href="#id388815">16.1.3. Example session</a></span></dt></dl></dd><dt><span class="section"><a href="#id389072">16.2. Logging Message Format</a></span></dt></dl></div><div class="section" title="16.1. Logging configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id388289"></a>16.1. Logging configuration</h2></div></div></div><p>
+ </p></div><div class="chapter" title="Chapter 16. Logging"><div class="titlepage"><div><div><h2 class="title"><a name="logging"></a>Chapter 16. Logging</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id1168229440555">16.1. Logging configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#id1168229440566">16.1.1. Loggers</a></span></dt><dt><span class="section"><a href="#id1168229440808">16.1.2. Output Options</a></span></dt><dt><span class="section"><a href="#id1168229440992">16.1.3. Example session</a></span></dt></dl></dd><dt><span class="section"><a href="#id1168229441201">16.2. Logging Message Format</a></span></dt></dl></div><div class="section" title="16.1. Logging configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229440555"></a>16.1. Logging configuration</h2></div></div></div><p>
The logging system in BIND 10 is configured through the
Logging module. All BIND 10 modules will look at the
@@ -1351,7 +1351,7 @@ eth0 fe80::21e:8cff:fe9b:7349
- </p><div class="section" title="16.1.1. Loggers"><div class="titlepage"><div><div><h3 class="title"><a name="id388304"></a>16.1.1. Loggers</h3></div></div></div><p>
+ </p><div class="section" title="16.1.1. Loggers"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229440566"></a>16.1.1. Loggers</h3></div></div></div><p>
Within BIND 10, a message is logged through a component
called a "logger". Different parts of BIND 10 log messages
@@ -1372,7 +1372,7 @@ eth0 fe80::21e:8cff:fe9b:7349
(what to log), and the <code class="option">output_options</code>
(where to log).
- </p><div class="section" title="16.1.1.1. name (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id388335"></a>16.1.1.1. name (string)</h4></div></div></div><p>
+ </p><div class="section" title="16.1.1.1. name (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440590"></a>16.1.1.1. name (string)</h4></div></div></div><p>
Each logger in the system has a name, the name being that
of the component using it to log messages. For instance,
if you want to configure logging for the resolver module,
@@ -1445,7 +1445,7 @@ eth0 fe80::21e:8cff:fe9b:7349
<span class="quote">“<span class="quote">Auth.cache</span>”</span> logger will appear in the output
with a logger name of <span class="quote">“<span class="quote">b10-auth.cache</span>”</span>).
- </p></div><div class="section" title="16.1.1.2. severity (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id388469"></a>16.1.1.2. severity (string)</h4></div></div></div><p>
+ </p></div><div class="section" title="16.1.1.2. severity (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440691"></a>16.1.1.2. severity (string)</h4></div></div></div><p>
This specifies the category of messages logged.
Each message is logged with an associated severity which
@@ -1461,7 +1461,7 @@ eth0 fe80::21e:8cff:fe9b:7349
- </p></div><div class="section" title="16.1.1.3. output_options (list)"><div class="titlepage"><div><div><h4 class="title"><a name="id388527"></a>16.1.1.3. output_options (list)</h4></div></div></div><p>
+ </p></div><div class="section" title="16.1.1.3. output_options (list)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440741"></a>16.1.1.3. output_options (list)</h4></div></div></div><p>
Each logger can have zero or more
<code class="option">output_options</code>. These specify where log
@@ -1471,7 +1471,7 @@ eth0 fe80::21e:8cff:fe9b:7349
The other options for a logger are:
- </p></div><div class="section" title="16.1.1.4. debuglevel (integer)"><div class="titlepage"><div><div><h4 class="title"><a name="id388546"></a>16.1.1.4. debuglevel (integer)</h4></div></div></div><p>
+ </p></div><div class="section" title="16.1.1.4. debuglevel (integer)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440758"></a>16.1.1.4. debuglevel (integer)</h4></div></div></div><p>
When a logger's severity is set to DEBUG, this value
specifies what debug messages should be printed. It ranges
@@ -1480,7 +1480,7 @@ eth0 fe80::21e:8cff:fe9b:7349
If severity for the logger is not DEBUG, this value is ignored.
- </p></div><div class="section" title="16.1.1.5. additive (true or false)"><div class="titlepage"><div><div><h4 class="title"><a name="id388566"></a>16.1.1.5. additive (true or false)</h4></div></div></div><p>
+ </p></div><div class="section" title="16.1.1.5. additive (true or false)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440773"></a>16.1.1.5. additive (true or false)</h4></div></div></div><p>
If this is true, the <code class="option">output_options</code> from
the parent will be used. For example, if there are two
@@ -1494,18 +1494,18 @@ eth0 fe80::21e:8cff:fe9b:7349
- </p></div></div><div class="section" title="16.1.2. Output Options"><div class="titlepage"><div><div><h3 class="title"><a name="id388607"></a>16.1.2. Output Options</h3></div></div></div><p>
+ </p></div></div><div class="section" title="16.1.2. Output Options"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229440808"></a>16.1.2. Output Options</h3></div></div></div><p>
The main settings for an output option are the
<code class="option">destination</code> and a value called
<code class="option">output</code>, the meaning of which depends on
the destination that is set.
- </p><div class="section" title="16.1.2.1. destination (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id388624"></a>16.1.2.1. destination (string)</h4></div></div></div><p>
+ </p><div class="section" title="16.1.2.1. destination (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440824"></a>16.1.2.1. destination (string)</h4></div></div></div><p>
The destination is the type of output. It can be one of:
- </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"> console </li><li class="listitem"> file </li><li class="listitem"> syslog </li></ul></div></div><div class="section" title="16.1.2.2. output (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id388658"></a>16.1.2.2. output (string)</h4></div></div></div><p>
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"> console </li><li class="listitem"> file </li><li class="listitem"> syslog </li></ul></div></div><div class="section" title="16.1.2.2. output (string)"><div class="titlepage"><div><div><h4 class="title"><a name="id1168229440856"></a>16.1.2.2. output (string)</h4></div></div></div><p>
Depending on what is set as the output destination, this
value is interpreted as follows:
@@ -1535,12 +1535,12 @@ eth0 fe80::21e:8cff:fe9b:7349
The other options for <code class="option">output_options</code> are:
- </p><div class="section" title="16.1.2.2.1. flush (true of false)"><div class="titlepage"><div><div><h5 class="title"><a name="id388766"></a>16.1.2.2.1. flush (true of false)</h5></div></div></div><p>
+ </p><div class="section" title="16.1.2.2.1. flush (true of false)"><div class="titlepage"><div><div><h5 class="title"><a name="id1168229440950"></a>16.1.2.2.1. flush (true of false)</h5></div></div></div><p>
Flush buffers after each log message. Doing this will
reduce performance but will ensure that if the program
terminates abnormally, all messages up to the point of
termination are output.
- </p></div><div class="section" title="16.1.2.2.2. maxsize (integer)"><div class="titlepage"><div><div><h5 class="title"><a name="id388778"></a>16.1.2.2.2. maxsize (integer)</h5></div></div></div><p>
+ </p></div><div class="section" title="16.1.2.2.2. maxsize (integer)"><div class="titlepage"><div><div><h5 class="title"><a name="id1168229440961"></a>16.1.2.2.2. maxsize (integer)</h5></div></div></div><p>
Only relevant when destination is file, this is maximum
file size of output files in bytes. When the maximum
size is reached, the file is renamed and a new file opened.
@@ -1549,11 +1549,11 @@ eth0 fe80::21e:8cff:fe9b:7349
etc.)
</p><p>
If this is 0, no maximum file size is used.
- </p></div><div class="section" title="16.1.2.2.3. maxver (integer)"><div class="titlepage"><div><div><h5 class="title"><a name="id388795"></a>16.1.2.2.3. maxver (integer)</h5></div></div></div><p>
+ </p></div><div class="section" title="16.1.2.2.3. maxver (integer)"><div class="titlepage"><div><div><h5 class="title"><a name="id1168229440973"></a>16.1.2.2.3. maxver (integer)</h5></div></div></div><p>
Maximum number of old log files to keep around when
rolling the output file. Only relevant when
<code class="option">destination</code> is <span class="quote">“<span class="quote">file</span>”</span>.
- </p></div></div></div><div class="section" title="16.1.3. Example session"><div class="titlepage"><div><div><h3 class="title"><a name="id388815"></a>16.1.3. Example session</h3></div></div></div><p>
+ </p></div></div></div><div class="section" title="16.1.3. Example session"><div class="titlepage"><div><div><h3 class="title"><a name="id1168229440992"></a>16.1.3. Example session</h3></div></div></div><p>
In this example we want to set the global logging to
write to the file <code class="filename">/var/log/my_bind10.log</code>,
@@ -1714,7 +1714,7 @@ Logging/loggers[0]/output_options[0]/maxver 8 integer (modified)
And every module will now be using the values from the
logger named <span class="quote">“<span class="quote">*</span>”</span>.
- </p></div></div><div class="section" title="16.2. Logging Message Format"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id389072"></a>16.2. Logging Message Format</h2></div></div></div><p>
+ </p></div></div><div class="section" title="16.2. Logging Message Format"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id1168229441201"></a>16.2. Logging Message Format</h2></div></div></div><p>
Each message written by BIND 10 to the configured logging
destinations comprises a number of components that identify
the origin of the message and, if the message indicates
diff --git a/doc/guide/bind10-guide.txt b/doc/guide/bind10-guide.txt
index d1095be..6676e95 100644
--- a/doc/guide/bind10-guide.txt
+++ b/doc/guide/bind10-guide.txt
@@ -2,9 +2,9 @@
Administrator Reference for BIND 10
- This is the reference guide for BIND 10 version 20120405.
+ This is the reference guide for BIND 10 version 20120517.
- Copyright © 2010-2012 Internet Systems Consortium, Inc.
+ Copyright (c) 2010-2012 Internet Systems Consortium, Inc.
Abstract
@@ -14,7 +14,7 @@ Administrator Reference for BIND 10
for controlling authoritative and recursive DNS servers, and experimental
DHCPv4 and DHCPv6 servers.
- This is the reference guide for BIND 10 version 20120405. The most
+ This is the reference guide for BIND 10 version 20120517. The most
up-to-date version of this document (in PDF, HTML, and plain text
formats), along with other documents for BIND 10, can be found at
http://bind10.isc.org/docs.
@@ -160,12 +160,12 @@ Preface
1. Acknowledgements
-1. Acknowledgements
+1. Acknowledgements
ISC would like to acknowledge generous support for BIND 10 development of
DHCPv4 and DHCPv6 components provided by Comcast.
-Chapter 1. Introduction
+Chapter 1. Introduction
Table of Contents
@@ -183,9 +183,9 @@ Chapter 1. Introduction
DNS. BIND 10 provides a EDNS0- and DNSSEC-capable authoritative DNS server
and a caching recursive name server which also provides forwarding.
- This guide covers the experimental prototype of BIND 10 version 20120405.
+ This guide covers the experimental prototype of BIND 10 version 20120517.
-1.1. Supported Platforms
+1.1. Supported Platforms
BIND 10 builds have been tested on Debian GNU/Linux 5 and unstable, Ubuntu
9.10, NetBSD 5, Solaris 10, FreeBSD 7 and 8, CentOS Linux 5.3, and MacOS
@@ -193,7 +193,7 @@ Chapter 1. Introduction
is planned for BIND 10 to build, install and run on Windows and standard
Unix-type platforms.
-1.2. Required Software
+1.2. Required Software
BIND 10 requires at least Python 3.1 (http://www.python.org/). It has also
been tested with Python 3.2.
@@ -219,7 +219,7 @@ Chapter 1. Introduction
installation nor standard packages collections. You may need to install
them separately.
-1.3. Starting and Stopping the Server
+1.3. Starting and Stopping the Server
BIND 10 is modular. Part of this modularity is accomplished using multiple
cooperating processes which, together, provide the server functionality.
@@ -232,43 +232,44 @@ Chapter 1. Introduction
processes as needed. The processes started by the bind10 command have
names starting with "b10-", including:
- o b10-auth — Authoritative DNS server. This process serves DNS requests.
- o b10-cfgmgr — Configuration manager. This process maintains all of the
+ o b10-auth -- Authoritative DNS server. This process serves DNS
+ requests.
+ o b10-cfgmgr -- Configuration manager. This process maintains all of the
configuration for BIND 10.
- o b10-cmdctl — Command and control service. This process allows external
- control of the BIND 10 system.
- o b10-msgq — Message bus daemon. This process coordinates communication
+ o b10-cmdctl -- Command and control service. This process allows
+ external control of the BIND 10 system.
+ o b10-msgq -- Message bus daemon. This process coordinates communication
between all of the other BIND 10 processes.
- o b10-resolver — Recursive name server. This process handles incoming
+ o b10-resolver -- Recursive name server. This process handles incoming
queries.
- o b10-sockcreator — Socket creator daemon. This process creates sockets
+ o b10-sockcreator -- Socket creator daemon. This process creates sockets
used by network-listening BIND 10 processes.
- o b10-stats — Statistics collection daemon. This process collects and
+ o b10-stats -- Statistics collection daemon. This process collects and
reports statistics data.
- o b10-stats-httpd — HTTP server for statistics reporting. This process
+ o b10-stats-httpd -- HTTP server for statistics reporting. This process
reports statistics data in XML format over HTTP.
- o b10-xfrin — Incoming zone transfer service. This process is used to
+ o b10-xfrin -- Incoming zone transfer service. This process is used to
transfer a new copy of a zone into BIND 10, when acting as a secondary
server.
- o b10-xfrout — Outgoing zone transfer service. This process is used to
+ o b10-xfrout -- Outgoing zone transfer service. This process is used to
handle transfer requests to send a local zone to a remote secondary
server, when acting as a master server.
- o b10-zonemgr — Secondary manager. This process keeps track of timers
+ o b10-zonemgr -- Secondary manager. This process keeps track of timers
and other necessary information for BIND 10 to act as a slave server.
These are ran automatically by bind10 and do not need to be run manually.
-1.4. Managing BIND 10
+1.4. Managing BIND 10
Once BIND 10 is running, a few commands are used to interact directly with
the system:
- o bindctl — interactive administration interface. This is a low-level
+ o bindctl -- interactive administration interface. This is a low-level
command-line tool which allows a developer or an experienced
administrator to control BIND 10.
- o b10-loadzone — zone file loader. This tool will load standard
+ o b10-loadzone -- zone file loader. This tool will load standard
masterfile-format zone files into BIND 10.
- o b10-cmdctl-usermgr — user access control. This tool allows an
+ o b10-cmdctl-usermgr -- user access control. This tool allows an
administrator to authorize additional users to manage BIND 10.
The tools and modules are covered in full detail in this guide. In
@@ -278,7 +279,7 @@ Chapter 1. Introduction
Python for the message bus, configuration backend, and, of course, DNS.
These include detailed developer documentation and code examples.
-Chapter 2. Installation
+Chapter 2. Installation
Table of Contents
@@ -300,7 +301,7 @@ Chapter 2. Installation
2.3.6. Install Hierarchy
-2.1. Building Requirements
+2.1. Building Requirements
In addition to the run-time requirements, building BIND 10 from source
code requires various development include headers.
@@ -326,7 +327,7 @@ Chapter 2. Installation
Visit the wiki at http://bind10.isc.org/wiki/SystemSpecificNotes for
system-specific installation tips.
-2.2. Quick start
+2.2. Quick start
Note
@@ -337,48 +338,48 @@ Chapter 2. Installation
To quickly get started with BIND 10, follow these steps.
-  1. Install required run-time and build dependencies.
-  2. Download the BIND 10 source tar file from
+ 1. Install required run-time and build dependencies.
+ 2. Download the BIND 10 source tar file from
ftp://ftp.isc.org/isc/bind10/.
-  3. Extract the tar file:
+ 3. Extract the tar file:
$ gzcat bind10-VERSION.tar.gz | tar -xvf -
-  4. Go into the source and run configure:
+ 4. Go into the source and run configure:
$ cd bind10-VERSION
$ ./configure
-  5. Build it:
+ 5. Build it:
$ make
-  6. Install it (to default /usr/local):
+ 6. Install it (to default /usr/local):
$ make install
-  7. Start the server:
+ 7. Start the server:
$ /usr/local/sbin/bind10
-  8. Test it; for example:
+ 8. Test it; for example:
$ dig @127.0.0.1 -c CH -t TXT authors.bind
-  9. Load desired zone file(s), for example:
+ 9. Load desired zone file(s), for example:
$ b10-loadzone your.zone.example.org
- 10. Test the new zone.
+ 10. Test the new zone.
-2.3. Installation from source
+2.3. Installation from source
BIND 10 is open source software written in C++ and Python. It is freely
available in source code form from ISC via the Git code revision control
system or as a downloadable tar file. It may also be available in
pre-compiled ready-to-use packages from operating system vendors.
- 2.3.1. Download Tar File
+ 2.3.1. Download Tar File
Downloading a release tar file is the recommended method to obtain the
source code.
@@ -387,7 +388,7 @@ Chapter 2. Installation
ftp://ftp.isc.org/isc/bind10/. Periodic development snapshots may also be
available.
- 2.3.2. Retrieve from Git
+ 2.3.2. Retrieve from Git
Downloading this "bleeding edge" code is recommended only for developers
or advanced users. Using development code in a production environment is
@@ -402,7 +403,7 @@ Chapter 2. Installation
The latest development code, including temporary experiments and
un-reviewed code, is available via the BIND 10 code revision control
system. This is powered by Git and all the BIND 10 development is public.
- The leading development is done in the “masterâ€.
+ The leading development is done in the "master".
The code can be checked out from git://git.bind10.isc.org/bind10; for
example:
@@ -415,7 +416,7 @@ Chapter 2. Installation
the --install switch. This will run autoconf, aclocal, libtoolize,
autoheader, automake, and related commands.
- 2.3.3. Configure before the build
+ 2.3.3. Configure before the build
BIND 10 uses the GNU Build System to discover build environment details.
To generate the makefiles using the defaults, simply run:
@@ -450,14 +451,14 @@ Chapter 2. Installation
If the configure fails, it may be due to missing or old dependencies.
- 2.3.4. Build
+ 2.3.4. Build
After the configure step is complete, to build the executables from the
C++ code and prepare the Python scripts, run:
$ make
- 2.3.5. Install
+ 2.3.5. Install
To install the BIND 10 executables, support files, and documentation, run:
@@ -467,22 +468,22 @@ Chapter 2. Installation
The install step may require superuser privileges.
- 2.3.6. Install Hierarchy
+ 2.3.6. Install Hierarchy
The following is the layout of the complete BIND 10 installation:
- o bin/ — general tools and diagnostic clients.
- o etc/bind10-devel/ — configuration files.
- o lib/ — libraries and python modules.
- o libexec/bind10-devel/ — executables that a user wouldn't normally run
+ o bin/ -- general tools and diagnostic clients.
+ o etc/bind10-devel/ -- configuration files.
+ o lib/ -- libraries and python modules.
+ o libexec/bind10-devel/ -- executables that a user wouldn't normally run
directly and are not run independently. These are the BIND 10 modules
which are daemons started by the bind10 tool.
- o sbin/ — commands used by the system administrator.
- o share/bind10-devel/ — configuration specifications.
- o share/man/ — manual pages (online documentation).
- o var/bind10-devel/ — data source and configuration databases.
+ o sbin/ -- commands used by the system administrator.
+ o share/bind10-devel/ -- configuration specifications.
+ o share/man/ -- manual pages (online documentation).
+ o var/bind10-devel/ -- data source and configuration databases.
-Chapter 3. Starting BIND10 with bind10
+Chapter 3. Starting BIND10 with bind10
Table of Contents
@@ -509,7 +510,7 @@ Chapter 3. Starting BIND10 with bind10
b10-cmdctl for administration tools to communicate with the system, and
b10-stats for statistics collection.
-3.1. Starting BIND 10
+3.1. Starting BIND 10
To start the BIND 10 service, simply run bind10. Run it with the --verbose
switch to get additional debugging or diagnostic output.
@@ -518,9 +519,9 @@ Chapter 3. Starting BIND10 with bind10
If the setproctitle Python module is detected at start up, the process
names for the Python-based daemons will be renamed to better identify them
- instead of just “pythonâ€. This is not needed on some operating systems.
+ instead of just "python". This is not needed on some operating systems.
-3.2. Configuration of started processes
+3.2. Configuration of started processes
The processes to be started can be configured, with the exception of the
b10-sockcreator, b10-msgq and b10-cfgmgr.
@@ -547,7 +548,7 @@ Chapter 3. Starting BIND10 with bind10
usual way. This is the list of components that need to be started in a
special way, with the value of special used for them:
- Table 3.1.Â
+ Table 3.1.
+------------------------------------------------------------------------+
| Component | Special | Description |
@@ -561,11 +562,11 @@ Chapter 3. Starting BIND10 with bind10
+------------------------------------------------------------------------+
The kind specifies how a failure of the component should be handled. If it
- is set to “dispensable†(the default unless you set something else), it
- will get started again if it fails. If it is set to “needed†and it fails
+ is set to "dispensable" (the default unless you set something else), it
+ will get started again if it fails. If it is set to "needed" and it fails
at startup, the whole bind10 shuts down and exits with error exit code.
But if it fails some time later, it is just started again. If you set it
- to “coreâ€, you indicate that the system is not usable without the
+ to "core", you indicate that the system is not usable without the
component and if such component fails, the system shuts down no matter
when the failure happened. This is the behaviour of the core components
(the ones you can't turn off), but you can declare any other components as
@@ -578,10 +579,10 @@ Chapter 3. Starting BIND10 with bind10
the default is enough.
There are other parameters we didn't use in our example. One of them is
- “addressâ€. It is the address used by the component on the b10-msgq message
+ "address". It is the address used by the component on the b10-msgq message
bus. The special components already know their address, but the usual ones
don't. The address is by convention the thing after b10-, with the first
- letter capital (eg. b10-stats would have “Stats†as its address).
+ letter capital (eg. b10-stats would have "Stats" as its address).
The last one is process. It is the name of the process to be started. It
defaults to the name of the component if not set, but you can use this to
@@ -622,11 +623,11 @@ Chapter 3. Starting BIND10 with bind10
locking the sqlite database, if used. The configuration might be changed
to something more convenient in future.
-Chapter 4. Command channel
+Chapter 4. Command channel
The BIND 10 components use the b10-msgq message routing daemon to
communicate with other BIND 10 components. The b10-msgq implements what is
- called the “Command Channelâ€. Processes intercommunicate by sending
+ called the "Command Channel". Processes intercommunicate by sending
messages on the command channel. Example messages include shutdown, get
configurations, and set configurations. This Command Channel is not used
for DNS message passing. It is used only to control and monitor the BIND
@@ -636,7 +637,7 @@ Chapter 4. Command channel
default, BIND 10 uses port 9912 for the b10-msgq service. It listens on
127.0.0.1.
-Chapter 5. Configuration manager
+Chapter 5. Configuration manager
The configuration manager, b10-cfgmgr, handles all BIND 10 system
configuration. It provides persistent storage for configuration, and
@@ -648,7 +649,7 @@ Chapter 5. Configuration manager
The administrator doesn't connect to it directly, but uses a user
interface to communicate with the configuration manager via b10-cmdctl's
- REST-ful interface. b10-cmdctl is covered in Chapter 6, Remote control
+ REST-ful interface. b10-cmdctl is covered in Chapter 6, Remote control
daemon.
Note
@@ -672,10 +673,10 @@ Chapter 5. Configuration manager
The configuration manager does not have any command line arguments.
Normally it is not started manually, but is automatically started using
- the bind10 master process (as covered in Chapter 3, Starting BIND10 with
+ the bind10 master process (as covered in Chapter 3, Starting BIND10 with
bind10).
-Chapter 6. Remote control daemon
+Chapter 6. Remote control daemon
Table of Contents
@@ -688,7 +689,7 @@ Chapter 6. Remote control daemon
When b10-cmdctl starts, it firsts asks b10-cfgmgr about what modules are
running and what their configuration is (over the b10-msgq channel). Then
- it will start listening on HTTPS for clients — the user interface — such
+ it will start listening on HTTPS for clients -- the user interface -- such
as bindctl.
b10-cmdctl directly sends commands (received from the user interface) to
@@ -715,7 +716,7 @@ Chapter 6. Remote control daemon
/usr/local/etc/bind10-devel/cmdctl-accounts.csv. This comma-delimited file
lists the accounts with a user name, hashed password, and salt. (A sample
file is at /usr/local/share/bind10-devel/cmdctl-accounts.csv. It contains
- the user named “root†with the password “bind10â€.)
+ the user named "root" with the password "bind10".)
The administrator may create a user account with the b10-cmdctl-usermgr
tool.
@@ -726,14 +727,14 @@ Chapter 6. Remote control daemon
connection is stateless and times out in 1200 seconds by default. This can
be redefined by using the --idle-timeout command line argument.
-6.1. Configuration specification for b10-cmdctl
+6.1. Configuration specification for b10-cmdctl
The configuration items for b10-cmdctl are: key_file cert_file
accounts_file
The control commands are: print_settings shutdown
-Chapter 7. Control and configure user interface
+Chapter 7. Control and configure user interface
Note
@@ -753,7 +754,7 @@ Chapter 7. Control and configure user interface
b10-cfgmgr which then stores the details and relays (over a b10-msgq
command channel) the configuration on to the specified module.
-Chapter 8. Authoritative Server
+Chapter 8. Authoritative Server
Table of Contents
@@ -775,10 +776,10 @@ Chapter 8. Authoritative Server
DNSSEC. It supports IPv6. Normally it is started by the bind10 master
process.
-8.1. Server Configurations
+8.1. Server Configurations
b10-auth is configured via the b10-cfgmgr configuration manager. The
- module name is “Authâ€. The configuration data items are:
+ module name is "Auth". The configuration data items are:
database_file
This is an optional string to define the path to find the SQLite3
@@ -787,8 +788,8 @@ Chapter 8. Authoritative Server
datasources
datasources configures data sources. The list items include: type
- to define the required data source type (such as “memoryâ€); class
- to optionally select the class (it defaults to “INâ€); and zones to
+ to define the required data source type (such as "memory"); class
+ to optionally select the class (it defaults to "IN"); and zones to
define the file path name, the filetype (e.g., sqlite3), and the
origin (default domain). By default, this is empty.
@@ -816,9 +817,9 @@ Chapter 8. Authoritative Server
loadzone
loadzone tells b10-auth to load or reload a zone file. The
arguments include: class which optionally defines the class (it
- defaults to “INâ€); origin is the domain name of the zone; and
+ defaults to "IN"); origin is the domain name of the zone; and
datasrc optionally defines the type of datasource (it defaults to
- “memoryâ€).
+ "memory").
Note
@@ -834,7 +835,7 @@ Chapter 8. Authoritative Server
argument to select the process ID to stop. (Note that the BIND 10
boss process may restart this service if configured.)
-8.2. Data Source Backends
+8.2. Data Source Backends
Note
@@ -847,13 +848,13 @@ Chapter 8. Authoritative Server
/usr/local/var/bind10-devel/zone.sqlite3. (The full path is what was
defined at build configure time for --localstatedir. The default is
/usr/local/var/.) This data file location may be changed by defining the
- “database_file†configuration.
+ "database_file" configuration.
- 8.2.1. In-memory Data Source
+ 8.2.1. In-memory Data Source
The following commands to bindctl provide an example of configuring an
- in-memory data source containing the “example.com†zone with the zone file
- named “example.com.zoneâ€:
+ in-memory data source containing the "example.com" zone with the zone file
+ named "example.com.zone":
> config add Auth/datasources
> config set Auth/datasources[0]/type "memory"
@@ -865,11 +866,11 @@ Chapter 8. Authoritative Server
The authoritative server will begin serving it immediately after it is
loaded.
- 8.2.2. In-memory Data Source With SQLite3 Backend
+ 8.2.2. In-memory Data Source With SQLite3 Backend
The following commands to bindctl provide an example of configuring an
- in-memory data source containing the “example.org†zone with a SQLite3
- backend file named “example.org.sqlite3â€:
+ in-memory data source containing the "example.org" zone with a SQLite3
+ backend file named "example.org.sqlite3":
> config add Auth/datasources
> config set Auth/datasources[1]/type "memory"
@@ -882,14 +883,14 @@ Chapter 8. Authoritative Server
The authoritative server will begin serving it immediately after it is
loaded.
- 8.2.3. Reloading an In-memory Data Source
+ 8.2.3. Reloading an In-memory Data Source
Use the Auth loadzone command in bindctl to reload a changed master file
into memory; for example:
> Auth loadzone origin="example.com"
- 8.2.4. Disabling In-memory Data Sources
+ 8.2.4. Disabling In-memory Data Sources
By default, the memory data source is disabled; it must be configured
explicitly. To disable all the in-memory zones, specify a null list for
@@ -906,7 +907,7 @@ Chapter 8. Authoritative Server
(Replace the list number(s) in datasources[0] and/or zones[0] for the
relevant zone as needed.)
-8.3. Loading Master Zones Files
+8.3. Loading Master Zones Files
RFC 1035 style DNS master zone files may imported into a BIND 10 SQLite3
data source by using the b10-loadzone utility.
@@ -937,7 +938,7 @@ Chapter 8. Authoritative Server
If you reload a zone already existing in the database, all records from
that prior zone disappear and a whole new set appears.
-Chapter 9. Incoming Zone Transfers
+Chapter 9. Incoming Zone Transfers
Table of Contents
@@ -955,13 +956,13 @@ Chapter 9. Incoming Zone Transfers
started by bind10. When received, the zone is stored in the corresponding
BIND 10 data source, and its records can be served by b10-auth. In
combination with b10-zonemgr (for automated SOA checks), this allows the
- BIND 10 server to provide “secondary†service.
+ BIND 10 server to provide "secondary" service.
The b10-xfrin process supports both AXFR and IXFR. Due to some
implementation limitations of the current development release, however, it
only tries AXFR by default, and care should be taken to enable IXFR.
-9.1. Configuration for Incoming Zone Transfers
+9.1. Configuration for Incoming Zone Transfers
In practice, you need to specify a list of secondary zones to enable
incoming zone transfers for these zones (you can still trigger a zone
@@ -978,7 +979,7 @@ Chapter 9. Incoming Zone Transfers
(We assume there has been no zone configuration before).
-9.2. Enabling IXFR
+9.2. Enabling IXFR
As noted above, b10-xfrin uses AXFR for zone transfers by default. To
enable IXFR for zone transfers for a particular zone, set the use_ixfr
@@ -1001,7 +1002,7 @@ Chapter 9. Incoming Zone Transfers
be implemented in a near future version, at which point we will enable
IXFR by default.
-9.3. Secondary Manager
+9.3. Secondary Manager
The b10-zonemgr process is started by bind10. It keeps track of SOA
refresh, retry, and expire timers and other details for BIND 10 to perform
@@ -1027,14 +1028,14 @@ Chapter 9. Incoming Zone Transfers
for it), b10-zonemgr will automatically tell b10-xfrin to transfer the
zone in.
-9.4. Trigger an Incoming Zone Transfer Manually
+9.4. Trigger an Incoming Zone Transfer Manually
To manually trigger a zone transfer to retrieve a remote zone, you may use
the bindctl utility. For example, at the bindctl prompt run:
> Xfrin retransfer zone_name="foo.example.org" master=192.0.2.99
-9.5. Incoming Transfers with In-memory Datasource
+9.5. Incoming Transfers with In-memory Datasource
In the case of an incoming zone transfer, the received zone is first
stored in the corresponding BIND 10 datasource. In case the secondary zone
@@ -1044,9 +1045,9 @@ Chapter 9. Incoming Zone Transfers
The administrator doesn't have to do anything for b10-auth to serve the
new version of the zone, except for the configuration such as the one
- described in Section 8.2.2, “In-memory Data Source With SQLite3 Backendâ€.
+ described in Section 8.2.2, "In-memory Data Source With SQLite3 Backend".
-Chapter 10. Outbound Zone Transfers
+Chapter 10. Outbound Zone Transfers
The b10-xfrout process is started by bind10. When the b10-auth
authoritative DNS server receives an AXFR or IXFR request, b10-auth
@@ -1095,7 +1096,7 @@ Chapter 10. Outbound Zone Transfers
The way to specify zone specific configuration (ACLs, etc) is likely to be
changed.
-Chapter 11. Recursive Name Server
+Chapter 11. Recursive Name Server
Table of Contents
@@ -1126,26 +1127,26 @@ Chapter 11. Recursive Name Server
> config set Resolver/listen_on[2]/port 53
> config commit
- (Replace the “2†as needed; run “config show Resolver/listen_on†if
+ (Replace the "2" as needed; run "config show Resolver/listen_on" if
needed.)
-11.1. Access Control
+11.1. Access Control
By default, the b10-resolver daemon only accepts DNS queries from the
localhost (127.0.0.1 and ::1). The Resolver/query_acl configuration may be
used to reject, drop, or allow specific IPs or networks. This
configuration list is first match.
- The configuration's action item may be set to “ACCEPT†to allow the
- incoming query, “REJECT†to respond with a DNS REFUSED return code, or
- “DROP†to ignore the query without any response (such as a blackhole). For
+ The configuration's action item may be set to "ACCEPT" to allow the
+ incoming query, "REJECT" to respond with a DNS REFUSED return code, or
+ "DROP" to ignore the query without any response (such as a blackhole). For
more information, see the respective debugging messages:
RESOLVER_QUERY_ACCEPTED, RESOLVER_QUERY_REJECTED, and
RESOLVER_QUERY_DROPPED.
The required configuration's from item is set to an IPv4 or IPv6 address,
addresses with an network mask, or to the special lowercase keywords
- “any6†(for any IPv6 address) or “any4†(for any IPv4 address).
+ "any6" (for any IPv6 address) or "any4" (for any IPv4 address).
For example to allow the 192.168.1.0/24 network to use your recursive name
server, at the bindctl prompt run:
@@ -1155,14 +1156,14 @@ Chapter 11. Recursive Name Server
> config set Resolver/query_acl[2]/from "192.168.1.0/24"
> config commit
- (Replace the “2†as needed; run “config show Resolver/query_acl†if
+ (Replace the "2" as needed; run "config show Resolver/query_acl" if
needed.)
Note
This prototype access control configuration syntax may be changed.
-11.2. Forwarding
+11.2. Forwarding
To enable forwarding, the upstream address and port must be configured to
forward queries to, such as:
@@ -1178,7 +1179,7 @@ Chapter 11. Recursive Name Server
> config set Resolver/forward_addresses []
> config commit
-Chapter 12. DHCPv4 Server
+Chapter 12. DHCPv4 Server
Table of Contents
@@ -1198,7 +1199,7 @@ Chapter 12. DHCPv4 Server
clients. Even though principles of both DHCPv4 and DHCPv6 are somewhat
similar, these are two radically different protocols. BIND10 offers server
implementations for both DHCPv4 and DHCPv6. This chapter is about DHCP for
- IPv4. For a description of the DHCPv6 server, see Chapter 13, DHCPv6
+ IPv4. For a description of the DHCPv6 server, see Chapter 13, DHCPv6
Server.
The DHCPv4 server component is currently under intense development. You
@@ -1206,7 +1207,7 @@ Chapter 12. DHCPv4 Server
developers mailing list.
The DHCPv4 and DHCPv6 components in BIND10 architecture are internally
- code named “Keaâ€.
+ code named "Kea".
Note
@@ -1214,17 +1215,17 @@ Chapter 12. DHCPv4 Server
servers. That means that while they are capable of performing DHCP
configuration, they are not fully functional yet. In particular, neither
has functional lease databases. This means that they will assign the same,
- fixed, hardcoded addresses to any client that will ask. See Section 12.4,
- “DHCPv4 Server Limitations†and Section 13.4, “DHCPv6 Server Limitationsâ€
+ fixed, hardcoded addresses to any client that will ask. See Section 12.4,
+ "DHCPv4 Server Limitations" and Section 13.4, "DHCPv6 Server Limitations"
for detailed description.
-12.1. DHCPv4 Server Usage
+12.1. DHCPv4 Server Usage
BIND10 provides the DHCPv4 server component since December 2011. It is a
skeleton server and can be described as an early prototype that is not
fully functional yet. It is mature enough to conduct first tests in lab
- environment, but it has significant limitations. See Section 12.4, “DHCPv4
- Server Limitations†for details.
+ environment, but it has significant limitations. See Section 12.4, "DHCPv4
+ Server Limitations" for details.
The DHCPv4 server is implemented as b10-dhcp4 daemon. As it is not
configurable yet, it is fully autonomous, that is it does not interact
@@ -1250,7 +1251,7 @@ Chapter 12. DHCPv4 Server
started directly, but rather via bind10. Please be aware of this planned
change.
-12.2. DHCPv4 Server Configuration
+12.2. DHCPv4 Server Configuration
The DHCPv4 server does not have a lease database implemented yet nor any
support for configuration, so every time the same set of configuration
@@ -1271,60 +1272,60 @@ Chapter 12. DHCPv4 Server
Lease database and configuration support is planned for 2012.
-12.3. Supported standards
+12.3. Supported standards
The following standards and draft standards are currently supported:
- o RFC2131: Supported messages are DISCOVER, OFFER, REQUEST, and ACK.
- o RFC2132: Supported options are: PAD (0), END(255), Message Type(53),
+ o RFC2131: Supported messages are DISCOVER, OFFER, REQUEST, and ACK.
+ o RFC2132: Supported options are: PAD (0), END(255), Message Type(53),
DHCP Server Identifier (54), Domain Name (15), DNS Servers (6), IP
Address Lease Time (51), Subnet mask (1), and Routers (3).
-12.4. DHCPv4 Server Limitations
+12.4. DHCPv4 Server Limitations
These are the current limitations of the DHCPv4 server software. Most of
them are reflections of the early stage of development and should be
- treated as “not implemented yetâ€, rather than actual limitations.
+ treated as "not implemented yet", rather than actual limitations.
- o During initial IPv4 node configuration, the server is expected to send
+ o During initial IPv4 node configuration, the server is expected to send
packets to a node that does not have IPv4 address assigned yet. The
server requires certain tricks (or hacks) to transmit such packets.
This is not implemented yet, therefore DHCPv4 server supports relayed
traffic only (that is, normal point to point communication).
- o b10-dhcp4 provides a single, fixed, hardcoded lease to any client that
+ o b10-dhcp4 provides a single, fixed, hardcoded lease to any client that
asks. There is no lease manager implemented. If two clients request
addresses, they will both get the same fixed address.
- o b10-dhcp4 does not support any configuration mechanisms yet. The whole
+ o b10-dhcp4 does not support any configuration mechanisms yet. The whole
configuration is currently hardcoded. The only way to tweak
- configuration is to directly modify source code. See see Section 12.2,
- “DHCPv4 Server Configuration†for details.
- o Upon start, the server will open sockets on all interfaces that are
+ configuration is to directly modify source code. See see Section 12.2,
+ "DHCPv4 Server Configuration" for details.
+ o Upon start, the server will open sockets on all interfaces that are
not loopback, are up and running and have IPv4 address. Support for
multiple interfaces is not coded in reception routines yet, so if you
are running this code on a machine that has many interfaces and
b10-dhcp4 happens to listen on wrong interface, the easiest way to
work around this problem is to turn down other interfaces. This
limitation will be fixed shortly.
- o PRL (Parameter Request List, a list of options requested by a client)
+ o PRL (Parameter Request List, a list of options requested by a client)
is currently ignored and server assigns DNS SERVER and DOMAIN NAME
options.
- o b10-dhcp4 does not support BOOTP. That is a design choice. This
+ o b10-dhcp4 does not support BOOTP. That is a design choice. This
limitation is permanent. If you have legacy nodes that can't use DHCP
and require BOOTP support, please use latest version of ISC DHCP
http://www.isc.org/software/dhcp.
- o Interface detection is currently working on Linux only. See
- Section 14.1, “Interface detection†for details.
- o b10-dhcp4 does not verify that assigned address is unused. According
+ o Interface detection is currently working on Linux only. See
+ Section 14.1, "Interface detection" for details.
+ o b10-dhcp4 does not verify that assigned address is unused. According
to RFC2131, the allocating server should verify that address is no
used by sending ICMP echo request.
- o Address renewal (RENEW), rebinding (REBIND), confirmation (CONFIRM),
+ o Address renewal (RENEW), rebinding (REBIND), confirmation (CONFIRM),
duplication report (DECLINE) and release (RELEASE) are not supported
yet.
- o DNS Update is not supported yet.
- o -v (verbose) command line option is currently the default, and cannot
+ o DNS Update is not supported yet.
+ o -v (verbose) command line option is currently the default, and cannot
be disabled.
-Chapter 13. DHCPv6 Server
+Chapter 13. DHCPv6 Server
Table of Contents
@@ -1339,14 +1340,14 @@ Chapter 13. DHCPv6 Server
Dynamic Host Configuration Protocol for IPv6 (DHCPv6) is specified in
RFC3315. BIND10 provides DHCPv6 server implementation that is described in
this chapter. For a description of the DHCPv4 server implementation, see
- Chapter 12, DHCPv4 Server.
+ Chapter 12, DHCPv4 Server.
The DHCPv6 server component is currently under intense development. You
may want to check out BIND10 DHCP (Kea) wiki and recent posts on BIND10
developers mailing list.
The DHCPv4 and DHCPv6 components in BIND10 architecture are internally
- code named “Keaâ€.
+ code named "Kea".
Note
@@ -1354,17 +1355,17 @@ Chapter 13. DHCPv6 Server
servers. That means that while they are capable of performing DHCP
configuration, they are not fully functional yet. In particular, neither
has functional lease databases. This means that they will assign the same,
- fixed, hardcoded addresses to any client that will ask. See Section 12.4,
- “DHCPv4 Server Limitations†and Section 13.4, “DHCPv6 Server Limitationsâ€
+ fixed, hardcoded addresses to any client that will ask. See Section 12.4,
+ "DHCPv4 Server Limitations" and Section 13.4, "DHCPv6 Server Limitations"
for detailed description.
-13.1. DHCPv6 Server Usage
+13.1. DHCPv6 Server Usage
BIND10 provides the DHCPv6 server component since September 2011. It is a
skeleton server and can be described as an early prototype that is not
fully functional yet. It is mature enough to conduct first tests in lab
- environment, but it has significant limitations. See Section 13.4, “DHCPv6
- Server Limitations†for details.
+ environment, but it has significant limitations. See Section 13.4, "DHCPv6
+ Server Limitations" for details.
The DHCPv6 server is implemented as b10-dhcp6 daemon. As it is not
configurable yet, it is fully autonomous, that is it does not interact
@@ -1390,7 +1391,7 @@ Chapter 13. DHCPv6 Server
started directly, but rather via bind10. Please be aware of this planned
change.
-13.2. DHCPv6 Server Configuration
+13.2. DHCPv6 Server Configuration
The DHCPv6 server does not have lease database implemented yet or any
support for configuration, so every time the same set of configuration
@@ -1410,50 +1411,50 @@ Chapter 13. DHCPv6 Server
Lease database and configuration support is planned for 2012.
-13.3. Supported DHCPv6 Standards
+13.3. Supported DHCPv6 Standards
The following standards and draft standards are currently supported:
- o RFC3315: Supported messages are SOLICIT, ADVERTISE, REQUEST, and
+ o RFC3315: Supported messages are SOLICIT, ADVERTISE, REQUEST, and
REPLY. Supported options are SERVER_ID, CLIENT_ID, IA_NA, and
IAADDRESS.
- o RFC3646: Supported option is DNS_SERVERS.
+ o RFC3646: Supported option is DNS_SERVERS.
-13.4. DHCPv6 Server Limitations
+13.4. DHCPv6 Server Limitations
These are the current limitations of the DHCPv6 server software. Most of
them are reflections of the early stage of development and should be
- treated as “not implemented yetâ€, rather than actual limitations.
+ treated as "not implemented yet", rather than actual limitations.
- o Relayed traffic is not supported.
- o b10-dhcp6 provides a single, fixed, hardcoded lease to any client that
+ o Relayed traffic is not supported.
+ o b10-dhcp6 provides a single, fixed, hardcoded lease to any client that
asks. There is no lease manager implemented. If two clients request
addresses, they will both get the same fixed address.
- o b10-dhcp6 does not support any configuration mechanisms yet. The whole
+ o b10-dhcp6 does not support any configuration mechanisms yet. The whole
configuration is currently hardcoded. The only way to tweak
- configuration is to directly modify source code. See see Section 13.2,
- “DHCPv6 Server Configuration†for details.
- o Upon start, the server will open sockets on all interfaces that are
+ configuration is to directly modify source code. See see Section 13.2,
+ "DHCPv6 Server Configuration" for details.
+ o Upon start, the server will open sockets on all interfaces that are
not loopback, are up, running and are multicast capable and have IPv6
address. Support for multiple interfaces is not coded in reception
routines yet, so if you are running this code on a machine that has
many interfaces and b10-dhcp6 happens to listen on wrong interface,
the easiest way to work around this problem is to turn down other
interfaces. This limitation will be fixed shortly.
- o ORO (Option Request Option, a list of options requested by a client)
+ o ORO (Option Request Option, a list of options requested by a client)
is currently ignored and server assigns DNS SERVER option.
- o Temporary addresses are not supported yet.
- o Prefix delegation is not supported yet.
- o Address renewal (RENEW), rebinding (REBIND), confirmation (CONFIRM),
+ o Temporary addresses are not supported yet.
+ o Prefix delegation is not supported yet.
+ o Address renewal (RENEW), rebinding (REBIND), confirmation (CONFIRM),
duplication report (DECLINE) and release (RELEASE) are not supported
yet.
- o DNS Update is not supported yet.
- o Interface detection is currently working on Linux only. See
- Section 14.1, “Interface detection†for details.
- o -v (verbose) command line option is currently the default, and cannot
+ o DNS Update is not supported yet.
+ o Interface detection is currently working on Linux only. See
+ Section 14.1, "Interface detection" for details.
+ o -v (verbose) command line option is currently the default, and cannot
be disabled.
-Chapter 14. libdhcp++ library
+Chapter 14. libdhcp++ library
Table of Contents
@@ -1471,7 +1472,7 @@ Chapter 14. libdhcp++ library
is designed to be portable, universal library useful for any kind of
DHCP-related software.
-14.1. Interface detection
+14.1. Interface detection
Both DHCPv4 and DHCPv6 components share network interface detection
routines. Interface detection is currently only supported on Linux
@@ -1493,11 +1494,11 @@ Chapter 14. libdhcp++ library
# For DHCPv4, please use following format:
#eth0 192.0.2.5
-14.2. DHCPv4/DHCPv6 packet handling
+14.2. DHCPv4/DHCPv6 packet handling
TODO: Describe packet handling here, with pointers to wiki
-Chapter 15. Statistics
+Chapter 15. Statistics
The b10-stats process is started by bind10. It periodically collects
statistics data from various modules and aggregates it.
@@ -1529,7 +1530,7 @@ Chapter 15. Statistics
}
-Chapter 16. Logging
+Chapter 16. Logging
Table of Contents
@@ -1543,13 +1544,13 @@ Chapter 16. Logging
16.2. Logging Message Format
-16.1. Logging configuration
+16.1. Logging configuration
The logging system in BIND 10 is configured through the Logging module.
All BIND 10 modules will look at the configuration in Logging to see what
should be logged and to where.
- 16.1.1. Loggers
+ 16.1.1. Loggers
Within BIND 10, a message is logged through a component called a "logger".
Different parts of BIND 10 log messages through different loggers, and
@@ -1562,78 +1563,78 @@ Chapter 16. Logging
(the component that is generating the messages), the severity (what to
log), and the output_options (where to log).
- 16.1.1.1. name (string)
+ 16.1.1.1. name (string)
Each logger in the system has a name, the name being that of the component
using it to log messages. For instance, if you want to configure logging
- for the resolver module, you add an entry for a logger named “Resolverâ€.
+ for the resolver module, you add an entry for a logger named "Resolver".
This configuration will then be used by the loggers in the Resolver
module, and all the libraries used by it.
If you want to specify logging for one specific library within the module,
you set the name to module.library. For example, the logger used by the
- nameserver address store component has the full name of “Resolver.nsasâ€.
+ nameserver address store component has the full name of "Resolver.nsas".
If there is no entry in Logging for a particular library, it will use the
configuration given for the module.
To illustrate this, suppose you want the cache library to log messages of
severity DEBUG, and the rest of the resolver code to log messages of
severity INFO. To achieve this you specify two loggers, one with the name
- “Resolver†and severity INFO, and one with the name “Resolver.cache†with
+ "Resolver" and severity INFO, and one with the name "Resolver.cache" with
severity DEBUG. As there are no entries for other libraries (e.g. the
- nsas), they will use the configuration for the module (“Resolverâ€), so
+ nsas), they will use the configuration for the module ("Resolver"), so
giving the desired behavior.
- One special case is that of a module name of “*†(asterisks), which is
+ One special case is that of a module name of "*" (asterisks), which is
interpreted as any module. You can set global logging options by using
this, including setting the logging configuration for a library that is
- used by multiple modules (e.g. “*.config†specifies the configuration
+ used by multiple modules (e.g. "*.config" specifies the configuration
library code in whatever module is using it).
If there are multiple logger specifications in the configuration that
might match a particular logger, the specification with the more specific
logger name takes precedence. For example, if there are entries for for
- both “*†and “Resolverâ€, the resolver module — and all libraries it uses —
- will log messages according to the configuration in the second entry
- (“Resolverâ€). All other modules will use the configuration of the first
- entry (“*â€). If there was also a configuration entry for “Resolver.cacheâ€,
+ both "*" and "Resolver", the resolver module -- and all libraries it uses
+ -- will log messages according to the configuration in the second entry
+ ("Resolver"). All other modules will use the configuration of the first
+ entry ("*"). If there was also a configuration entry for "Resolver.cache",
the cache library within the resolver would use that in preference to the
- entry for “Resolverâ€.
+ entry for "Resolver".
One final note about the naming. When specifying the module name within a
logger, use the name of the module as specified in bindctl, e.g.
- “Resolver†for the resolver module, “Xfrout†for the xfrout module, etc.
+ "Resolver" for the resolver module, "Xfrout" for the xfrout module, etc.
When the message is logged, the message will include the name of the
logger generating the message, but with the module name replaced by the
name of the process implementing the module (so for example, a message
- generated by the “Auth.cache†logger will appear in the output with a
- logger name of “b10-auth.cacheâ€).
+ generated by the "Auth.cache" logger will appear in the output with a
+ logger name of "b10-auth.cache").
- 16.1.1.2. severity (string)
+ 16.1.1.2. severity (string)
This specifies the category of messages logged. Each message is logged
with an associated severity which may be one of the following (in
descending order of severity):
- o FATAL
- o ERROR
- o WARN
- o INFO
- o DEBUG
+ o FATAL
+ o ERROR
+ o WARN
+ o INFO
+ o DEBUG
When the severity of a logger is set to one of these values, it will only
log messages of that severity, and the severities above it. The severity
may also be set to NONE, in which case all messages from that logger are
inhibited.
- 16.1.1.3. output_options (list)
+ 16.1.1.3. output_options (list)
Each logger can have zero or more output_options. These specify where log
messages are sent to. These are explained in detail below.
The other options for a logger are:
- 16.1.1.4. debuglevel (integer)
+ 16.1.1.4. debuglevel (integer)
When a logger's severity is set to DEBUG, this value specifies what debug
messages should be printed. It ranges from 0 (least verbose) to 99 (most
@@ -1641,80 +1642,80 @@ Chapter 16. Logging
If severity for the logger is not DEBUG, this value is ignored.
- 16.1.1.5. additive (true or false)
+ 16.1.1.5. additive (true or false)
If this is true, the output_options from the parent will be used. For
- example, if there are two loggers configured; “Resolver†and
- “Resolver.cacheâ€, and additive is true in the second, it will write the
- log messages not only to the destinations specified for “Resolver.cacheâ€,
+ example, if there are two loggers configured; "Resolver" and
+ "Resolver.cache", and additive is true in the second, it will write the
+ log messages not only to the destinations specified for "Resolver.cache",
but also to the destinations as specified in the output_options in the
- logger named “Resolverâ€.
+ logger named "Resolver".
- 16.1.2. Output Options
+ 16.1.2. Output Options
The main settings for an output option are the destination and a value
called output, the meaning of which depends on the destination that is
set.
- 16.1.2.1. destination (string)
+ 16.1.2.1. destination (string)
The destination is the type of output. It can be one of:
- o console
- o file
- o syslog
+ o console
+ o file
+ o syslog
- 16.1.2.2. output (string)
+ 16.1.2.2. output (string)
Depending on what is set as the output destination, this value is
interpreted as follows:
- destination is “consoleâ€
+ destination is "console"
- The value of output must be one of “stdout†(messages printed to
- standard output) or “stderr†(messages printed to standard error).
+ The value of output must be one of "stdout" (messages printed to
+ standard output) or "stderr" (messages printed to standard error).
- Note: if output is set to “stderr†and a lot of messages are
+ Note: if output is set to "stderr" and a lot of messages are
produced in a short time (e.g. if the logging level is set to
DEBUG), you may occasionally see some messages jumbled up
together. This is due to a combination of the way that messages
are written to the screen and the unbuffered nature of the
standard error stream. If this occurs, it is recommended that
- output be set to “stdoutâ€.
+ output be set to "stdout".
- destination is “fileâ€
+ destination is "file"
The value of output is interpreted as a file name; log messages
will be appended to this file.
- destination is “syslogâ€
+ destination is "syslog"
The value of output is interpreted as the syslog facility (e.g.
local0) that should be used for log messages.
The other options for output_options are:
- 16.1.2.2.1. flush (true of false)
+ 16.1.2.2.1. flush (true of false)
Flush buffers after each log message. Doing this will reduce performance
but will ensure that if the program terminates abnormally, all messages up
to the point of termination are output.
- 16.1.2.2.2. maxsize (integer)
+ 16.1.2.2.2. maxsize (integer)
Only relevant when destination is file, this is maximum file size of
output files in bytes. When the maximum size is reached, the file is
renamed and a new file opened. (For example, a ".1" is appended to the
- name — if a ".1" file exists, it is renamed ".2", etc.)
+ name -- if a ".1" file exists, it is renamed ".2", etc.)
If this is 0, no maximum file size is used.
- 16.1.2.2.3. maxver (integer)
+ 16.1.2.2.3. maxver (integer)
Maximum number of old log files to keep around when rolling the output
- file. Only relevant when destination is “fileâ€.
+ file. Only relevant when destination is "file".
- 16.1.3. Example session
+ 16.1.3. Example session
In this example we want to set the global logging to write to the file
/var/log/my_bind10.log, at severity WARN. We want the authoritative server
@@ -1813,9 +1814,9 @@ Chapter 16. Logging
> config remove Logging/loggers[1]
> config commit
- And every module will now be using the values from the logger named “*â€.
+ And every module will now be using the values from the logger named "*".
-16.2. Logging Message Format
+16.2. Logging Message Format
Each message written by BIND 10 to the configured logging destinations
comprises a number of components that identify the origin of the message
diff --git a/doc/guide/bind10-messages.html b/doc/guide/bind10-messages.html
index a0bbf77..4ac83c3 100644
--- a/doc/guide/bind10-messages.html
+++ b/doc/guide/bind10-messages.html
@@ -1,10 +1,10 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Messages Manual</title><link rel="stylesheet" href="./bind10-guide.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="BIND 10 is a Domain Name System (DNS) suite managed by Internet Systems Consortium (ISC). It includes DNS libraries and modular components for controlling authoritative and recursive DNS servers. This is the messages manual for BIND 10 version 20120405. The most up-to-date version of this document, along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Messages Manual"><div class="titlepage"><div><div><h1 class="title"><a name="id1168229451102"></a>BIND 10 Messages Manual</h1></div><div><p class="releaseinfo">This is the messages manual for BIND 10 version
- 20120405.</p></div><div><p class="copyright">Copyright © 2011-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a Domain Name System (DNS) suite managed by
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>BIND 10 Messages Manual</title><link rel="stylesheet" href="./bind10-guide.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><meta name="description" content="BIND 10 is a Domain Name System (DNS) suite managed by Internet Systems Consortium (ISC). It includes DNS libraries and modular components for controlling authoritative and recursive DNS servers. This is the messages manual for BIND 10 version 20120517. The most up-to-date version of this document, along with other documents for BIND 10, can be found at ."></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" title="BIND 10 Messages Manual"><div class="titlepage"><div><div><h1 class="title"><a name="id1168229451102"></a>BIND 10 Messages Manual</h1></div><div><p class="releaseinfo">This is the messages manual for BIND 10 version
+ 20120517.</p></div><div><p class="copyright">Copyright © 2011-2012 Internet Systems Consortium, Inc.</p></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>BIND 10 is a Domain Name System (DNS) suite managed by
Internet Systems Consortium (ISC). It includes DNS libraries
and modular components for controlling authoritative and
recursive DNS servers.
</p><p>
- This is the messages manual for BIND 10 version 20120405.
+ This is the messages manual for BIND 10 version 20120517.
The most up-to-date version of this document, along with
other documents for BIND 10, can be found at
<a class="ulink" href="http://bind10.isc.org/docs" target="_top">http://bind10.isc.org/docs</a>.
More information about the bind10-changes
mailing list