BIND 10 master, updated. 8eb7bcd370b766d260cd69001f119e4dea1e87cd [master] minor documentation change and example added
BIND 10 source code commits
bind10-changes at lists.isc.org
Wed Dec 14 12:41:13 UTC 2011
The branch, master has been updated
via 8eb7bcd370b766d260cd69001f119e4dea1e87cd (commit)
via a5dbe4197bf7fc362784fd2d8227fd108d08602c (commit)
via e20572f93d2db7db1bfb3efaf08a068ca4416dc9 (commit)
from 7ad41d91b28fa38bfa5dc07458da24b8459fdc2a (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 8eb7bcd370b766d260cd69001f119e4dea1e87cd
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Dec 14 06:39:41 2011 -0600
[master] minor documentation change and example added
Change Secondary Manager chapter to a section in the
existing Incoming Zone Transfers chapter.
Small content addition and add a bindctl example for Zonemgr.
commit a5dbe4197bf7fc362784fd2d8227fd108d08602c
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Dec 14 06:35:58 2011 -0600
[master] man page clarification
TODO: this still needs reload_jitter documented
commit e20572f93d2db7db1bfb3efaf08a068ca4416dc9
Author: Jeremy C. Reed <jreed at ISC.org>
Date: Wed Dec 14 06:34:13 2011 -0600
[master] remove commented out section and wrong entry from SEE ALSO
-----------------------------------------------------------------------
Summary of changes:
doc/guide/bind10-guide.xml | 69 ++++++++++++++++++++++++--------------
src/bin/zonemgr/b10-zonemgr.xml | 26 ++++++---------
2 files changed, 53 insertions(+), 42 deletions(-)
-----------------------------------------------------------------------
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index e61725f..b186111 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -1502,6 +1502,49 @@ what if a NOTIFY is sent?
-->
+ <section id="zonemgr">
+ <title>Secondary Manager</title>
+
+ <para>
+ The <command>b10-zonemgr</command> process is started by
+ <command>bind10</command>.
+ It keeps track of SOA refresh, retry, and expire timers
+ and other details for BIND 10 to perform as a slave.
+ When the <command>b10-auth</command> authoritative DNS server
+ receives a NOTIFY message, <command>b10-zonemgr</command>
+ may tell <command>b10-xfrin</command> to do a refresh
+ to start an inbound zone transfer.
+ The secondary manager resets its counters when a new zone is
+ transferred in.
+ </para>
+
+ <note><simpara>
+ Access control (such as allowing notifies) is not yet provided.
+ The primary/secondary service is not yet complete.
+ </simpara></note>
+
+ <para>
+ The following example shows using <command>bindctl</command>
+ to configure the server to be a secondary for the example zone:
+
+ <screen>> <userinput>config add Zonemgr/secondary_zones</userinput>
+> <userinput>config set Zonemgr/secondary_zones[0]/name "<option>example.com</option>"</userinput>
+> <userinput>config set Zonemgr/secondary_zones[0]/class "<option>IN</option>"</userinput>
+> <userinput>config commit</userinput></screen>
+
+<!-- TODO: remove the IN class example above when it is the default -->
+
+ </para>
+
+ <para>
+ If the zone does not exist in the data source already
+ (i.e. no SOA record for it), <command>b10-zonemgr</command>
+ will automatically tell <command>b10-xfrin</command>
+ to transfer the zone in.
+ </para>
+
+ </section>
+
<section>
<title>Trigger an Incoming Zone Transfer Manually</title>
@@ -1514,7 +1557,6 @@ what if a NOTIFY is sent?
</para>
</section>
-
<!-- TODO: can that retransfer be used to identify a new zone? -->
<!-- TODO: what if doesn't exist at that master IP? -->
@@ -1606,31 +1648,6 @@ what is XfroutClient xfr_client??
</chapter>
- <chapter id="zonemgr">
- <title>Secondary Manager</title>
-
- <para>
- The <command>b10-zonemgr</command> process is started by
- <command>bind10</command>.
- It keeps track of SOA refresh, retry, and expire timers
- and other details for BIND 10 to perform as a slave.
- When the <command>b10-auth</command> authoritative DNS server
- receives a NOTIFY message, <command>b10-zonemgr</command>
- may tell <command>b10-xfrin</command> to do a refresh
- to start an inbound zone transfer.
- The secondary manager resets its counters when a new zone is
- transferred in.
- </para>
-
- <note><simpara>
- Access control (such as allowing notifies) is not yet provided.
- The primary/secondary service is not yet complete.
- </simpara></note>
-
-<!-- TODO: lots to describe for zonemgr -->
-
- </chapter>
-
<chapter id="resolverserver">
<title>Recursive Name Server</title>
diff --git a/src/bin/zonemgr/b10-zonemgr.xml b/src/bin/zonemgr/b10-zonemgr.xml
index 00f5d04..5ea6041 100644
--- a/src/bin/zonemgr/b10-zonemgr.xml
+++ b/src/bin/zonemgr/b10-zonemgr.xml
@@ -20,7 +20,7 @@
<refentry>
<refentryinfo>
- <date>May 19, 2011</date>
+ <date>December 8, 2011</date>
</refentryinfo>
<refmeta>
@@ -107,15 +107,20 @@
<para>
<varname>refresh_jitter</varname>
+ is used to provide a time range for randomizing the refresh
+ and retry timers to help avoid many zones needing to do a refresh
+ or retry at the same time.
This value is a real number.
- The maximum amount is 0.5.
- The default is 0.25.
+ The maximum amount is 0.5 (the new timer will be within
+ half the original time).
+ The default is 0.25 (up to a quarter sooner).
+ Set to 0 to disable this jitter.
</para>
-<!-- TODO: needs to be documented -->
-<!-- TODO: Set to 0 to disable the jitter. -->
<para>
<varname>reload_jitter</varname>
+<!-- is used to provide a slight random variation -->
+<!-- TODO: ask what the purpose of this is and why 0.75. -->
This value is a real number.
The default is 0.75.
</para>
@@ -224,14 +229,6 @@
</refsect1>
-->
-<!--
- <refsect1>
- <title>FILES</title>
- <para>
- <filename>/tmp/auth_xfrout_conn</filename>
- </para>
- </refsect1>
--->
<refsect1>
<title>SEE ALSO</title>
@@ -249,9 +246,6 @@
<refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
- <refentrytitle>b10-xfrout</refentrytitle><manvolnum>8</manvolnum>
- </citerefentry>,
- <citerefentry>
<refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citetitle>BIND 10 Guide</citetitle>.
More information about the bind10-changes
mailing list