BIND 10 master, updated. 434d8db8dfcd23a87b8e798e5702e91f0bbbdcf6 [trac1732] add changelog entry
BIND 10 source code commits
bind10-changes at lists.isc.org
Wed Mar 28 15:32:18 UTC 2012
The branch, master has been updated
via 434d8db8dfcd23a87b8e798e5702e91f0bbbdcf6 (commit)
via 8a3564c8893c5b9df451ff29d58f65604740b310 (commit)
via 435436f1402c345fec712d923848f934999f3107 (commit)
via 98483c34555c48143e6bfcdab63a9ec68a6fb86a (commit)
via 99afc8ab28a7748f9dda301da98e64a2b0b5e04c (commit)
via 724baae9fa3e9cb0e6e0835ae3dafc83fd30b84f (commit)
via 93e12f75baf215fdc8434461a2d5428e73f06860 (commit)
via 9d84626f72a70b3b71330c6fa31d767109a67d9b (commit)
via da214e3e13d2ee898a409df35cff9f208654503b (commit)
from 418a6dc9ee0369d13d14bfa825229c0e35a694e4 (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 434d8db8dfcd23a87b8e798e5702e91f0bbbdcf6
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 10:30:25 2012 -0500
[trac1732] add changelog entry
commit 8a3564c8893c5b9df451ff29d58f65604740b310
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 10:12:14 2012 -0500
[trac1732] datasource type is required
This was copied from manpage so fix there.
Noticed by jelte. And I confirmed:
2012-03-28 11:07:43.931 ERROR [b10-auth.auth] AUTH_CONFIG_UPDATE_FAIL update of configuration failed: Missing data source type
commit 435436f1402c345fec712d923848f934999f3107
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 09:55:14 2012 -0500
[trac1732] more doc work for loading zones
Add more examples and explanations about in-memory.
Be clear again that b10-loadzone is sqlite3.
commit 98483c34555c48143e6bfcdab63a9ec68a6fb86a
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 09:15:11 2012 -0500
[trac1732] remove redundant note about IN class
commit 99afc8ab28a7748f9dda301da98e64a2b0b5e04c
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 09:12:04 2012 -0500
[trac1732] minor docbook tags formatting changes
commit 724baae9fa3e9cb0e6e0835ae3dafc83fd30b84f
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 09:08:38 2012 -0500
[trac1732] add a single section id
TODO: add them for all sections in table of contents for linking
commit 93e12f75baf215fdc8434461a2d5428e73f06860
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 09:05:46 2012 -0500
[trac1732] more in-memory datasource docs
Some cleanup, formatting tags added.
Change example from single configuration step (in JSON) to multiple
configuration commands.
More examples.
commit 9d84626f72a70b3b71330c6fa31d767109a67d9b
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 08:27:45 2012 -0500
[trac1732] add auth configurations and commands
This was pulled in verbatim from the b10-auth.xml manual page.
TODO: automate this or rewrite this.
Also this lacks formatting.
commit da214e3e13d2ee898a409df35cff9f208654503b
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Mar 28 08:09:39 2012 -0500
[trac1732] start of the documenting in-memory data source use
from jinmei's guide.diff from ticket #1732
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 5 +
doc/guide/bind10-guide.xml | 180 ++++++++++++++++++++++++++++++++++++++++++--
src/bin/auth/b10-auth.xml | 4 +-
3 files changed, 180 insertions(+), 9 deletions(-)
-----------------------------------------------------------------------
diff --git a/ChangeLog b/ChangeLog
index 197d9ea..a162b73 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+415. [doc] jinmei, jreed
+ BIND 10 Guide updated to now describe the in-memory data source
+ configurations for b10-auth.
+ (Trac #1732, git TBD)
+
414. [bug] jinmei
b10-auth now correctly handles delegation from an unsigned zone
(defined in the in-memory data source) when the query has DNSSEC
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 3599e25..dcf7cd8 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -1301,7 +1301,7 @@ since we used bind10 -->
<command>b10-auth</command> is configured via the
<command>b10-cfgmgr</command> configuration manager.
The module name is <quote>Auth</quote>.
- The configuration data item is:
+ The configuration data items are:
<variablelist>
@@ -1317,22 +1317,119 @@ This may be a temporary setting until then.
</listitem>
</varlistentry>
+<!-- NOTE: docs pulled in verbatim from the b10-auth.xml manual page.
+ TODO: automate this if want this or rewrite
+-->
+ <varlistentry>
+ <term>datasources</term>
+ <listitem>
+ <simpara>
+ <varname>datasources</varname> configures data sources.
+ The list items include:
+ <varname>type</varname> to define the required data source type
+ (such as <quote>memory</quote>);
+ <varname>class</varname> to optionally select the class
+ (it defaults to <quote>IN</quote>);
+ and
+ <varname>zones</varname> to define the
+ <varname>file</varname> path name and the
+ <varname>origin</varname> (default domain).
+
+ By default, this is empty.
+
+ <note><simpara>
+ In this development version, currently this is only used for the
+ memory data source.
+ Only the IN class is supported at this time.
+ By default, the memory data source is disabled.
+ Also, currently the zone file must be canonical such as
+ generated by <command>named-compilezone -D</command>.
+ </simpara></note>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>listen_on</term>
+ <listitem>
+ <simpara>
+ <varname>listen_on</varname> is a list of addresses and ports for
+ <command>b10-auth</command> to listen on.
+ The list items are the <varname>address</varname> string
+ and <varname>port</varname> number.
+ By default, <command>b10-auth</command> listens on port 53
+ on the IPv6 (::) and IPv4 (0.0.0.0) wildcard addresses.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>statistics-interval</term>
+ <listitem>
+ <simpara>
+ <varname>statistics-interval</varname> is the timer interval
+ in seconds for <command>b10-auth</command> to share its
+ statistics information to
+ <citerefentry><refentrytitle>b10-stats</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
+ Statistics updates can be disabled by setting this to 0.
+ The default is 60.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</para>
<para>
- The configuration command is:
+ The configuration commands are:
<variablelist>
<varlistentry>
+ <term>loadzone</term>
+ <listitem>
+ <simpara>
+ <command>loadzone</command> tells <command>b10-auth</command>
+ to load or reload a zone file. The arguments include:
+ <varname>class</varname> which optionally defines the class
+ (it defaults to <quote>IN</quote>);
+ <varname>origin</varname> is the domain name of the zone;
+ and
+ <varname>datasrc</varname> optionally defines the type of datasource
+ (it defaults to <quote>memory</quote>).
+
+ <note><simpara>
+ In this development version, currently this only supports the
+ IN class and the memory data source.
+ </simpara></note>
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>sendstats</term>
+ <listitem>
+ <simpara>
+ <command>sendstats</command> tells <command>b10-auth</command>
+ to send its statistics data to
+ <citerefentry><refentrytitle>b10-stats</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ immediately.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>shutdown</term>
<listitem>
<simpara>Stop the authoritative DNS server.
+ This has an optional <varname>pid</varname> argument to
+ select the process ID to stop.
+ (Note that the BIND 10 boss process may restart this service
+ if configured.)
</simpara>
-<!-- TODO: what happens when this is sent, will bind10 restart? -->
</listitem>
</varlistentry>
@@ -1362,10 +1459,79 @@ This may be a temporary setting until then.
(The full path is what was defined at build configure time for
<option>--localstatedir</option>.
The default is <filename>/usr/local/var/</filename>.)
- This data file location may be changed by defining the
- <quote>database_file</quote> configuration.
+ This data file location may be changed by defining the
+ <quote>database_file</quote> configuration.
</para>
+ <section id="in-memory-datasource">
+ <title>In-memory Data Source</title>
+
+ <para>
+<!-- How to configure it. -->
+ The following commands to <command>bindctl</command>
+ provide an example of configuring an in-memory data
+ source containing the <quote>example.com</quote> zone
+ with the zone file named <quote>example.com.zone</quote>:
+
+<!--
+ <screen>> <userinput> config set Auth/datasources/ [{"type": "memory", "zones": [{"origin": "example.com", "file": "example.com.zone"}]}]</userinput></screen>
+-->
+
+ <screen>> <userinput>config add Auth/datasources</userinput>
+> <userinput>config set Auth/datasources[0]/type "<option>memory</option>"</userinput>
+> <userinput>config add Auth/datasources[0]/zones</userinput>
+> <userinput>config set Auth/datasources[0]/zones[0]/origin "<option>example.com</option>"</userinput>
+> <userinput>config set Auth/datasources[0]/zones[0]/file "<option>example.com.zone</option>"</userinput>
+> <userinput>config commit</userinput></screen>
+
+ The authoritative server will begin serving it immediately
+ after it is loaded.
+ </para>
+
+ <para>
+ Use the <command>Auth loadzone</command> command in
+ <command>bindctl</command> to reload a changed master
+ file into memory; for example:
+
+ <screen>> <userinput>Auth loadzone origin="example.com"</userinput>
+</screen>
+
+ </para>
+
+<!--
+ <para>
+ The <varname>file</varname> may be an absolute path to the
+ master zone file or it is relative to the directory BIND 10 is
+ started from.
+ </para>
+-->
+
+ <para>
+ 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 <varname>Auth/datasources</varname>:
+
+<!-- TODO: this assumes that Auth/datasources is for memory only -->
+
+ <screen>> <userinput>config set Auth/datasources/ []</userinput>
+> <userinput>config commit</userinput></screen>
+ </para>
+
+ <para>
+ The following example stops serving a specific zone:
+
+ <screen>> <userinput>config remove Auth/datasources[<option>0</option>]/zones[<option>0</option>]</userinput>
+> <userinput>config commit</userinput></screen>
+
+ (Replace the list number(s) in
+ <varname>datasources[<replaceable>0</replaceable>]</varname>
+ and/or <varname>zones[<replaceable>0</replaceable>]</varname>
+ for the relevant zone as needed.)
+
+ </para>
+
+ </section>
+
</section>
<section>
@@ -1373,7 +1539,7 @@ This may be a temporary setting until then.
<para>
RFC 1035 style DNS master zone files may imported
- into a BIND 10 data source by using the
+ into a BIND 10 SQLite3 data source by using the
<command>b10-loadzone</command> utility.
</para>
@@ -1420,7 +1586,7 @@ This may be a temporary setting until then.
<note>
<para>
In the development prototype release, only the SQLite3 back
- end is used.
+ end is used by <command>b10-loadzone</command>.
By default, it stores the zone data in
<filename>/usr/local/var/bind10-devel/zone.sqlite3</filename>
unless the <option>-d</option> switch is used to set the
diff --git a/src/bin/auth/b10-auth.xml b/src/bin/auth/b10-auth.xml
index 7575217..7f3a492 100644
--- a/src/bin/auth/b10-auth.xml
+++ b/src/bin/auth/b10-auth.xml
@@ -20,7 +20,7 @@
<refentry>
<refentryinfo>
- <date>March 1, 2012</date>
+ <date>March 28, 2012</date>
</refentryinfo>
<refmeta>
@@ -119,7 +119,7 @@
<para>
<varname>datasources</varname> configures data sources.
The list items include:
- <varname>type</varname> to optionally choose the data source type
+ <varname>type</varname> to define the required data source type
(such as <quote>memory</quote>);
<varname>class</varname> to optionally select the class
(it defaults to <quote>IN</quote>);
More information about the bind10-changes
mailing list