[svn] commit: r2937 - in /branches/trac341/src/bin: auth/b10-auth.xml bind10/bind10.xml xfrin/b10-xfrin.xml xfrout/b10-xfrout.xml zonemgr/Makefile.am zonemgr/b10-zonemgr.xml

BIND 10 source code commits bind10-changes at lists.isc.org
Thu Sep 16 11:19:56 UTC 2010


Author: jreed
Date: Thu Sep 16 11:19:56 2010
New Revision: 2937

Log:
Initial zonemgr and related docs (done over a week ago).

Added:
    branches/trac341/src/bin/zonemgr/b10-zonemgr.xml
Modified:
    branches/trac341/src/bin/auth/b10-auth.xml
    branches/trac341/src/bin/bind10/bind10.xml
    branches/trac341/src/bin/xfrin/b10-xfrin.xml
    branches/trac341/src/bin/xfrout/b10-xfrout.xml
    branches/trac341/src/bin/zonemgr/Makefile.am

Modified: branches/trac341/src/bin/auth/b10-auth.xml
==============================================================================
--- branches/trac341/src/bin/auth/b10-auth.xml (original)
+++ branches/trac341/src/bin/auth/b10-auth.xml Thu Sep 16 11:19:56 2010
@@ -201,6 +201,9 @@
         <refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
+        <refentrytitle>b10-zonemgr</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
         <refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citetitle>BIND 10 Guide</citetitle>.

Modified: branches/trac341/src/bin/bind10/bind10.xml
==============================================================================
--- branches/trac341/src/bin/bind10/bind10.xml (original)
+++ branches/trac341/src/bin/bind10/bind10.xml Thu Sep 16 11:19:56 2010
@@ -189,6 +189,12 @@
       <citerefentry>
         <refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <citerefentry>
+        <refentrytitle>b10-xfrout</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>b10-zonemgr</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
       <citetitle>BIND 10 Guide</citetitle>.
     </para>
   </refsect1>

Modified: branches/trac341/src/bin/xfrin/b10-xfrin.xml
==============================================================================
--- branches/trac341/src/bin/xfrin/b10-xfrin.xml (original)
+++ branches/trac341/src/bin/xfrin/b10-xfrin.xml Thu Sep 16 11:19:56 2010
@@ -21,7 +21,7 @@
 <refentry>
 
   <refentryinfo>
-    <date>March 17, 2010</date>
+    <date>September 8, 2010</date>
   </refentryinfo>
 
   <refmeta>
@@ -68,7 +68,6 @@
     </simpara></note>
 
     <para>
-<!-- TODO: does it really use msgq? what for? -->
       This daemon communicates with BIND 10 over a
       <citerefentry><refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum></citerefentry>
       C-Channel connection.  If this connection is not established,
@@ -85,8 +84,21 @@
   <refsect1>
     <title>CONFIGURATION AND COMMANDS</title>
     <para>
-      The configurable setting is <varname>transfers-in</varname>
-      which defines the maximum number of inbound zone transfers
+      The configurable settings are:
+    </para>
+
+    <para><varname>master_addr</varname>
+<!-- TODO: how can there be a single setting for this? -->
+       The default is 127.0.0.1.
+    </para>
+
+    <para><varname>master_port</varname>
+<!-- TODO: what if custom is needed per zone? -->
+      The default is 53.
+    </para>
+
+    <para><varname>transfers-in</varname>
+      defines the maximum number of inbound zone transfers
       that can run concurrently. The default is 10.
     </para>
 
@@ -96,11 +108,22 @@
     <para>
       The configuration commands are:
     </para>
-    <para>
-      <command>shutdown</command> stops all incoming zone transfers
-      and exits <command>b10-xfrin</command>. (Note that the BIND 10
-      boss process will restart this service.)
-    </para>
+
+    <para>
+     <command>notify</command>
+TODO: what is difference from refresh_from_zonemgr ?
+    </para>
+
+    <para>
+      <command>refresh</command>
+Same as retransfer except it checks the SOA serial first.
+TODO more detail
+    </para>
+
+    <para>
+      <command>refresh_from_zonemgr</command>
+    </para>
+
     <para>
       <command>retransfer</command> triggers the transfer in for
       a single zone without checking the zone's serial number.
@@ -111,6 +134,11 @@
      </para>
 <!-- TODO: later hostname for master? -->
 
+    <para>
+      <command>shutdown</command> stops all incoming zone transfers
+      and exits <command>b10-xfrin</command>. (Note that the BIND 10
+      boss process will restart this service.)
+    </para>
 <!-- TODO:
 add a usage example of xfrin -->
 
@@ -182,6 +210,9 @@
         <refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
+        <refentrytitle>b10-zonemgr</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
         <refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citetitle>BIND 10 Guide</citetitle>.

Modified: branches/trac341/src/bin/xfrout/b10-xfrout.xml
==============================================================================
--- branches/trac341/src/bin/xfrout/b10-xfrout.xml (original)
+++ branches/trac341/src/bin/xfrout/b10-xfrout.xml Thu Sep 16 11:19:56 2010
@@ -21,7 +21,7 @@
 <refentry>
 
   <refentryinfo>
-    <date>April 20, 2010</date>
+    <date>September 8, 2010</date>
   </refentryinfo>
 
   <refmeta>
@@ -112,13 +112,22 @@
 
 <!-- TODO: formating -->
     <para>
-      The configuration command is:
+      The configuration commands are:
     </para>
     <para>
       <command>shutdown</command> stops all outbound zone transfers
       and exits <command>b10-xfrout</command>. (Note that the BIND 10
       boss process will restart this service.)
     </para>
+
+    <para>
+      <command>zone_new_data_ready</command> is sent from
+      <command>b10-xfrin</command> to indicate that the zone transferred
+      in successfully.
+      This triggers <command>b10-xfrout</command> to send NOTIFY
+      message(s).
+    </para>
+
 
   </refsect1>
 
@@ -161,6 +170,9 @@
         <refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
+        <refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
         <refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citetitle>BIND 10 Guide</citetitle>.

Modified: branches/trac341/src/bin/zonemgr/Makefile.am
==============================================================================
--- branches/trac341/src/bin/zonemgr/Makefile.am (original)
+++ branches/trac341/src/bin/zonemgr/Makefile.am Thu Sep 16 11:19:56 2010
@@ -9,6 +9,16 @@
 
 CLEANFILES = b10-zonemgr zonemgr.pyc zonemgr.spec
 
+man_MANS = b10-zonemgr.8
+EXTRA_DIST = $(man_MANS) b10-zonemgr.xml
+
+if ENABLE_MAN
+
+b10-zonemgr.8: b10-zonemgr.xml
+	xsltproc --novalid --xinclude --nonet -o $@ http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $(srcdir)/b10-zonemgr.xml
+
+endif
+
 zonemgr.spec: zonemgr.spec.pre
 	$(SED) -e "s|@@LOCALSTATEDIR@@|$(localstatedir)|" zonemgr.spec.pre >$@
 




More information about the bind10-changes mailing list