BIND 10 trac1732, updated. 724baae9fa3e9cb0e6e0835ae3dafc83fd30b84f [trac1732] add a single section id
BIND 10 source code commits
bind10-changes at lists.isc.org
Wed Mar 28 14:09:04 UTC 2012
The branch, trac1732 has been updated
via 724baae9fa3e9cb0e6e0835ae3dafc83fd30b84f (commit)
via 93e12f75baf215fdc8434461a2d5428e73f06860 (commit)
via 9d84626f72a70b3b71330c6fa31d767109a67d9b (commit)
from da214e3e13d2ee898a409df35cff9f208654503b (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 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.
-----------------------------------------------------------------------
Summary of changes:
doc/guide/bind10-guide.xml | 144 ++++++++++++++++++++++++++++++++++++++++----
1 files changed, 133 insertions(+), 11 deletions(-)
-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index c9dd566..2de28f3 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>
@@ -1320,7 +1320,61 @@ This may be a temporary setting until then.
<varlistentry>
<term>datasources</term>
<listitem>
- <simpara>TBD</simpara>
+<!-- NOTE: this was pulled in verbatim from the b10-auth.xml manual page.
+ TODO: automate this
+-->
+ <para>
+ <varname>datasources</varname> configures data sources.
+ The list items include:
+ <varname>type</varname> to optionally choose the 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>
+ </para>
+
+ </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>
@@ -1330,16 +1384,52 @@ This may be a temporary setting until then.
<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>
@@ -1373,22 +1463,54 @@ This may be a temporary setting until then.
<quote>database_file</quote> configuration.
</para>
- <section>
+ <section id="in-memory-datasource">
<title>In-memory Data Source</title>
<para>
- How to configure it.
- For example, the following command to bindctl
- will configure an in-memory data source containing the "example.com"
- zone with the zone file named "example.com.zone":
+<!-- 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>
+
</para>
+
+ <note><simpara>Note: it's currently for class IN only.</simpara></note>
+
+<!--
+ <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 it again, specify a null list
- for Auth/datasources:
+ for <varname>Auth/datasources</varname>:
- Notes: it's currently for class IN 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>
+ </para>
</section>
More information about the bind10-changes
mailing list