Browse Source

[master] minor man page cleanup

Change note about IXFR support. Noticed by Jelte and discussed on
jabber.

While here: mention AXFR and IXFR, remove a TODO comment, and
add some docbook formatting tags (no content change for that).
Jeremy C. Reed 13 years ago
parent
commit
11b8542e2d
1 changed files with 10 additions and 10 deletions
  1. 10 10
      src/bin/xfrout/b10-xfrout.xml

+ 10 - 10
src/bin/xfrout/b10-xfrout.xml

@@ -20,7 +20,7 @@
 <refentry>
 <refentry>
 
 
   <refentryinfo>
   <refentryinfo>
-    <date>December 1, 2010</date>
+    <date>December 15, 2011</date>
   </refentryinfo>
   </refentryinfo>
 
 
   <refmeta>
   <refmeta>
@@ -52,7 +52,7 @@
   <refsect1>
   <refsect1>
     <title>DESCRIPTION</title>
     <title>DESCRIPTION</title>
     <para>The <command>b10-xfrout</command> daemon provides the BIND 10
     <para>The <command>b10-xfrout</command> daemon provides the BIND 10
-      outgoing DNS zone transfer service.
+      outgoing DNS zone transfer service using AXFR or IXFR.
       It is also used to send outgoing NOTIFY messages.
       It is also used to send outgoing NOTIFY messages.
       Normally it is started by the
       Normally it is started by the
       <citerefentry><refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum></citerefentry>
       <citerefentry><refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum></citerefentry>
@@ -67,13 +67,13 @@
  process?, and then the socket and xfr request is sent to xfrout.
  process?, and then the socket and xfr request is sent to xfrout.
 -->
 -->
 
 
+<!-- TODO: IXFR from differences, DDNS, UDP socket passing -->
     <note><simpara>
     <note><simpara>
-      This development prototype release only supports AXFR.
-      IXFR is not implemented.
+      Currently IXFR only works if it gets the zone via
+      <command>b10-xfrin</command> and only on TCP.
     </simpara></note>
     </simpara></note>
 
 
     <para>
     <para>
-<!-- TODO: does it really use msgq? what for? -->
       This daemon communicates with BIND 10 over a
       This daemon communicates with BIND 10 over a
       <citerefentry><refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum></citerefentry>
       <citerefentry><refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum></citerefentry>
       C-Channel connection.  If this connection is not established,
       C-Channel connection.  If this connection is not established,
@@ -100,15 +100,15 @@
     <para>
     <para>
       <varname>tsig_key_ring</varname>
       <varname>tsig_key_ring</varname>
       A list of TSIG keys (each of which is in the form of
       A list of TSIG keys (each of which is in the form of
-      name:base64-key[:algorithm]) used for access control on transfer
-      requests.
+      <replaceable>name:base64-key[:algorithm]</replaceable>)
+      used for access control on transfer requests.
       The default is an empty list.
       The default is an empty list.
     </para>
     </para>
     <para>
     <para>
       <varname>transfer_acl</varname>
       <varname>transfer_acl</varname>
       A list of ACL elements that apply to all transfer requests by
       A list of ACL elements that apply to all transfer requests by
-      default (unless overridden in zone_config).  See the BIND 10
-      guide for configuration examples.
+      default (unless overridden in <varname>zone_config</varname>).
+      See the <citetitle>BIND 10 Guide</citetitle> for configuration examples.
       The default is an element that allows any transfer requests.
       The default is an element that allows any transfer requests.
     </para>
     </para>
     <para>
     <para>
@@ -119,7 +119,7 @@
       name of the zone), "class" (the RR class of the zone, optional,
       name of the zone), "class" (the RR class of the zone, optional,
       default to "IN"), and "acl_element" (ACL only applicable to
       default to "IN"), and "acl_element" (ACL only applicable to
       transfer requests for that zone).
       transfer requests for that zone).
-      See the BIND 10 guide for configuration examples.
+      See the <citetitle>BIND 10 Guide</citetitle> for configuration examples.
       The default is an empty list, that is, no zone specific configuration.
       The default is an empty list, that is, no zone specific configuration.
     </para>
     </para>
     <para>
     <para>