Browse Source

Grammar fix.

Add some details about zonemgr.
Mention xfrout does NOTIFY out also.


git-svn-id: svn://bind10.isc.org/svn/bind10/branches/trac341@2946 e5f2f494-b856-4b98-b285-d166d9295462
Jeremy C. Reed 14 years ago
parent
commit
deb0efecb3
1 changed files with 45 additions and 9 deletions
  1. 45 9
      doc/guide/bind10-guide.xml

+ 45 - 9
doc/guide/bind10-guide.xml

@@ -42,7 +42,7 @@
 
 
     <note>
     <note>
       <para>
       <para>
-        BIND 10, at this time, does not provide an recursive
+        BIND 10, at this time, does not provide a recursive
         DNS server. It does provide a EDNS0- and DNSSEC-capable
         DNS server. It does provide a EDNS0- and DNSSEC-capable
         authoritative DNS server.
         authoritative DNS server.
       </para>
       </para>
@@ -74,9 +74,9 @@
 	For this development prototype release, the only supported
 	For this development prototype release, the only supported
 	data source backend is SQLite3. The authoritative server
 	data source backend is SQLite3. The authoritative server
 	requires SQLite 3.3.9 or newer.
 	requires SQLite 3.3.9 or newer.
-        The <command>b10-xfrin</command> and <command>b10-xfrout</command>
+	The <command>b10-xfrin</command>, <command>b10-xfrout</command>,
-        modules require the libpython3 library and the Python
+	and <command>b10-zonemgr</command> modules require the
-        _sqlite3.so module.
+	libpython3 library and the Python _sqlite3.so module.
       </para></note>
       </para></note>
 <!-- TODO: this will change ... -->
 <!-- TODO: this will change ... -->
 
 
@@ -165,6 +165,15 @@
             </simpara>
             </simpara>
           </listitem>
           </listitem>
 
 
+          <listitem>
+            <simpara>
+              <command>b10-zonemgr</command> &mdash;
+              Secondary manager.
+	      This process keeps track of timers and other
+              necessary information for BIND 10 to act as a slave server.
+            </simpara>
+          </listitem>
+
         </itemizedlist>
         </itemizedlist>
       </para>
       </para>
 
 
@@ -651,7 +660,8 @@ var/
       <command>b10-cmdctl</command> for admins to communicate with the
       <command>b10-cmdctl</command> for admins to communicate with the
       system, <command>b10-auth</command> for Authoritative DNS service,
       system, <command>b10-auth</command> for Authoritative DNS service,
       <command>b10-xfrin</command> for inbound DNS zone transfers.
       <command>b10-xfrin</command> for inbound DNS zone transfers.
-      and <command>b10-xfrout</command> for outbound DNS zone transfers.
+      <command>b10-xfrout</command> for outbound DNS zone transfers.
+      and <command>b10-zonemgr</command> for secondary service.
     </para>
     </para>
 
 
     <section id="start">
     <section id="start">
@@ -1173,14 +1183,14 @@ TODO
       transfer. When received, it is stored in the BIND 10
       transfer. When received, it is stored in the BIND 10
       data store, and its records can be served by
       data store, and its records can be served by
       <command>b10-auth</command>.
       <command>b10-auth</command>.
-      This allows the BIND 10 server to provide
+      In combination with <command>b10-zonemgr</command> (for
-      <quote>secondary</quote> service.
+      automated SOA checks), this allows the BIND 10 server to
+      provide <quote>secondary</quote> service.
     </para>
     </para>
 
 
     <note><simpara>
     <note><simpara>
      The current development release of BIND 10 only supports
      The current development release of BIND 10 only supports
      AXFR. (IXFR is not supported.) 
      AXFR. (IXFR is not supported.) 
-     It also does not yet support automated SOA checks.
     </simpara></note>
     </simpara></note>
 
 
     <para>
     <para>
@@ -1204,12 +1214,13 @@ TODO
       sends the zone.
       sends the zone.
       This is used to provide master DNS service to share zones
       This is used to provide master DNS service to share zones
       to secondary name servers.
       to secondary name servers.
+      The <command>b10-xfrout</command> is also used to send
+      NOTIFY messages to slaves.
     </para>
     </para>
 
 
     <note><simpara>
     <note><simpara>
      The current development release of BIND 10 only supports
      The current development release of BIND 10 only supports
      AXFR. (IXFR is not supported.) 
      AXFR. (IXFR is not supported.) 
-     It also does not yet support NOTIFY.
      Access control is not yet provided.
      Access control is not yet provided.
     </simpara></note>
     </simpara></note>
 
 
@@ -1226,6 +1237,31 @@ what is XfroutClient xfr_client??
 
 
   </chapter>
   </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>
+
 <!-- TODO: how to help: run unit tests, join lists, review trac tickets -->
 <!-- TODO: how to help: run unit tests, join lists, review trac tickets -->
 
 
   <!-- <index>    <title>Index</title> </index> -->
   <!-- <index>    <title>Index</title> </index> -->