BIND 10 master, updated. bd3cc66c7c3ea7877dc83dc9685c9c45bf16cf12 [master]Merge branch 'master' of ssh://git.bind10.isc.org/var/bind10/git/bind10
BIND 10 source code commits
bind10-changes at lists.isc.org
Mon Jun 25 13:40:34 UTC 2012
The branch, master has been updated
via bd3cc66c7c3ea7877dc83dc9685c9c45bf16cf12 (commit)
via 1daf03e96d531f64f88dde217b28594cd788ca7a (commit)
via 864995c3389e8eb670e32dd2f659be105012608c (commit)
via a1b7836d0accceff101d44219adf2a3d289d1eaf (commit)
via c2aec2257ed1b9104cf6dcb0656e39d0374e3a87 (commit)
via 4089f1e72ac389b05f536eabd8cf4aa57bccbf3a (commit)
via df58f3d2bf08d1213073cf555dea1993f19cf6f6 (commit)
from 61fdb18f0f253800c86e4a952b7194f26b3d4aee (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 bd3cc66c7c3ea7877dc83dc9685c9c45bf16cf12
Merge: 1daf03e 61fdb18
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Mon Jun 25 07:43:49 2012 -0500
[master]Merge branch 'master' of ssh://git.bind10.isc.org/var/bind10/git/bind10
commit 1daf03e96d531f64f88dde217b28594cd788ca7a
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 12:55:37 2012 -0500
[master] various minor documentation changes
commit 864995c3389e8eb670e32dd2f659be105012608c
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 12:41:39 2012 -0500
[master] add information about packages
start of section about binary packages
clarify about Hierarchy
commit a1b7836d0accceff101d44219adf2a3d289d1eaf
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 12:36:11 2012 -0500
[master] move the "Install Hierarchy" section earlier in the install chapter
commit c2aec2257ed1b9104cf6dcb0656e39d0374e3a87
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 12:32:05 2012 -0500
[master] mention new share/doc/bind10-devel/ installation
commit 4089f1e72ac389b05f536eabd8cf4aa57bccbf3a
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 12:18:34 2012 -0500
[master] various minor edits
Some capitalization, clarifications, add XML tag, etc.
I didn't get this reviewed; it is many minor edits.
commit df58f3d2bf08d1213073cf555dea1993f19cf6f6
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Fri Jun 22 11:21:49 2012 -0500
[master] pyexpat is not required
pyexpat is only required for unittest not for running
stats-httpd. (see ticket http://bind10.isc.org/ticket/2048)
-----------------------------------------------------------------------
Summary of changes:
doc/guide/bind10-guide.xml | 218 +++++++++++++++++++++++++-------------------
1 file changed, 126 insertions(+), 92 deletions(-)
-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 1bdc005..1463284 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -36,8 +36,8 @@
<abstract>
<para>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
+ servers with development 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.
</para>
@@ -59,6 +59,8 @@
<section id="acknowledgements">
<title>Acknowledgements</title>
+<!-- TODO: acknowledge all sponsors and CNNIC and CZNIC too -->
+
<para>ISC would like to acknowledge generous support for
BIND 10 development of DHCPv4 and DHCPv6 components provided
by <ulink url="http://www.comcast.com/">Comcast</ulink>.</para>
@@ -72,11 +74,13 @@
<para>
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
- and provides a modular environment for serving and maintaining DNS.
+ BIND 10 is a rewrite of BIND 9 and ISC DHCP.
+ BIND 10 is written in C++ and Python and provides a modular
+ environment for serving, maintaining, and developing DNS and DHCP.
BIND 10 provides a EDNS0- and DNSSEC-capable authoritative
DNS server and a caching recursive name server which also
provides forwarding.
+ It also provides experimental DHCPv4 and DHCPv6 servers.
</para>
<para>
@@ -105,7 +109,7 @@
<para>
BIND 10 requires at least Python 3.1
(<ulink url="http://www.python.org/"/>).
- It has also been tested with Python 3.2.
+ It also works with Python 3.2.
</para>
<para>
@@ -118,6 +122,7 @@
BIND 10 uses the log4cplus C++ logging library
(<ulink url="http://log4cplus.sourceforge.net/"/>).
It requires at least log4cplus version 1.0.3.
+<!-- TODO: It is recommended to use at least version .... -->
</para>
<para>
@@ -132,9 +137,7 @@
<command>b10-xfrout</command>, and <command>b10-zonemgr</command>
components require the libpython3 library and the Python
_sqlite3.so module (which is included with Python).
- The <command>b10-stats-httpd</command> component uses the
- Python pyexpat.so module.
- The Python modules need to be built for the corresponding Python 3.
+ Python modules need to be built for the corresponding Python 3.
</para>
<!-- TODO: this will change ... -->
@@ -220,8 +223,8 @@
<simpara>
<command>b10-resolver</command> —
Recursive name server.
- This process handles incoming queries.
-<!-- TODO: -->
+ This process handles incoming DNS queries and provides
+ answers from its cache or by recursively doing remote lookups.
</simpara>
</listitem>
@@ -264,15 +267,14 @@
<command>b10-xfrout</command> —
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.
+ send a local zone to a remote secondary server.
</simpara>
</listitem>
<listitem>
<simpara>
<command>b10-zonemgr</command> —
- Secondary manager.
+ Secondary zone manager.
This process keeps track of timers and other
necessary information for BIND 10 to act as a slave server.
</simpara>
@@ -282,8 +284,8 @@
</para>
<para>
- These are ran automatically by <command>bind10</command>
- and do not need to be run manually.
+ These are ran by <command>bind10</command>
+ and do not need to be manually started independently.
</para>
</section>
@@ -298,7 +300,7 @@
<listitem>
<simpara>
<command>bindctl</command> —
- interactive administration interface.
+ Interactive administration interface.
This is a low-level command-line tool which allows
a developer or an experienced administrator to control
BIND 10.
@@ -307,7 +309,7 @@
<listitem>
<simpara>
<command>b10-loadzone</command> —
- zone file loader.
+ Zone file loader.
This tool will load standard masterfile-format zone files into
BIND 10.
</simpara>
@@ -315,7 +317,7 @@
<listitem>
<simpara>
<command>b10-cmdctl-usermgr</command> —
- user access control.
+ User access control.
This tool allows an administrator to authorize additional users
to manage BIND 10.
</simpara>
@@ -358,6 +360,7 @@ var/
for C++ and Python for the message bus, configuration backend,
and, of course, DNS. These include detailed developer
documentation and code examples.
+<!-- TODO: DHCP also but no Python yet. -->
<!-- TODO point to this -->
</para>
@@ -366,12 +369,100 @@ var/
<chapter id="installation">
<title>Installation</title>
+ <section id="packages">
+ <title>Packages</title>
+
+ <para>
+ Some operating systems or softare package vendors may
+ provide ready-to-use, pre-built software packages for
+ the BIND 10 suite.
+ Installing a pre-built package means you do not need to
+ install build-only prerequisites and do not need to
+ <emphasis>make</emphasis> the software.
+ </para>
+
+ <para>
+ FreeBSD ports, NetBSD pkgsrc, and Debian
+ <emphasis>testing</emphasis> package collections provide
+ all the prerequisite packages.
+ </para>
+ </section>
+
+ <section id="install-hierarchy">
+ <title>Install Hierarchy</title>
+ <para>
+ The following is the standard, common layout of the
+ complete BIND 10 installation:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <filename>bin/</filename> —
+ general tools and diagnostic clients.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>etc/bind10-devel/</filename> —
+ configuration files.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>lib/</filename> —
+ libraries and python modules.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>libexec/bind10-devel/</filename> —
+ 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 <command>bind10</command> tool.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>sbin/</filename> —
+ commands used by the system administrator.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>share/bind10-devel/</filename> —
+ configuration specifications.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>share/doc/bind10-devel/</filename> —
+ this guide and other supplementary documentation.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>share/man/</filename> —
+ manual pages (online documentation).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <filename>var/bind10-devel/</filename> —
+ data source and configuration databases.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
<section id="build-requirements">
<title>Building Requirements</title>
<para>
- In addition to the run-time requirements, building BIND 10
- from source code requires various development include headers.
+ In addition to the run-time requirements (listed in
+ <xref linkend="required-software"/>), building BIND 10
+ from source code requires various development include headers and
+ program development tools.
</para>
<note>
@@ -415,7 +506,7 @@ as a dependency earlier -->
</para>
<para>
- Visit the wiki at <ulink
+ Visit the user-contributed wiki at <ulink
url="http://bind10.isc.org/wiki/SystemSpecificNotes" />
for system-specific installation tips.
</para>
@@ -484,7 +575,7 @@ as a dependency earlier -->
</listitem>
<listitem>
-
+<!-- TODO: this is wrong; b10-auth is not started by default any more -->
<para>Test it; for example:
<screen>$ <userinput>dig @127.0.0.1 -c CH -t TXT authors.bind</userinput></screen>
</para>
@@ -510,10 +601,10 @@ as a dependency earlier -->
<title>Installation from source</title>
<para>
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.
+ It is freely available in source code form from ISC as a
+ downloadable tar file or via BIND 10's Git code revision control
+ service. (It may also be available in pre-compiled ready-to-use
+ packages from operating system vendors.)
</para>
<section>
@@ -541,7 +632,7 @@ as a dependency earlier -->
<note>
<para>
- When using source code retrieved via Git additional
+ When using source code retrieved via Git, additional
software will be required: automake (v1.11 or newer),
libtoolize, and autoconf (2.59 or newer).
These may need to be installed.
@@ -549,11 +640,12 @@ as a dependency earlier -->
</note>
<para>
- The latest development code, including temporary experiments
- and un-reviewed code, is available via the BIND 10 code revision
+ The latest development code (and 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 <quote>master</quote>.
+ The leading development is done in the <quote>master</quote>
+ branch.
</para>
<para>
The code can be checked out from
@@ -566,8 +658,8 @@ as a dependency earlier -->
<para>
When checking out the code from
the code version control system, it doesn't include the
- generated configure script, Makefile.in files, nor the
- related configure files.
+ generated configure script, Makefile.in files, nor their
+ related build files.
They can be created by running <command>autoreconf</command>
with the <option>--install</option> switch.
This will run <command>autoconf</command>,
@@ -591,7 +683,7 @@ as a dependency earlier -->
</para>
<para>
Run <command>./configure</command> with the <option>--help</option>
- switch to view the different options. The commonly-used options are:
+ switch to view the different options. Some commonly-used options are:
<variablelist>
@@ -679,65 +771,6 @@ as a dependency earlier -->
<!-- TODO: tests -->
- <section>
- <title>Install Hierarchy</title>
- <para>
- The following is the layout of the complete BIND 10 installation:
- <itemizedlist>
- <listitem>
- <simpara>
- <filename>bin/</filename> —
- general tools and diagnostic clients.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>etc/bind10-devel/</filename> —
- configuration files.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>lib/</filename> —
- libraries and python modules.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>libexec/bind10-devel/</filename> —
- 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 <command>bind10</command> tool.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>sbin/</filename> —
- commands used by the system administrator.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>share/bind10-devel/</filename> —
- configuration specifications.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>share/man/</filename> —
- manual pages (online documentation).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <filename>var/bind10-devel/</filename> —
- data source and configuration databases.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- </section>
</section>
<!--
@@ -843,6 +876,7 @@ as a dependency earlier -->
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:
<table>
+ <title>Special startup components</title>
<tgroup cols='3' align='left'>
<colspec colname='component'/>
<colspec colname='special'/>
More information about the bind10-changes
mailing list