From: Thomas Markwalder <tmark@isc.org>
Date: Thu, 8 May 2014 13:32:19 +0000 (-0400)
Subject: [3268] Updated bind10 guide with new D2 global parameters
X-Git-Tag: trac3434_base~26^2~4
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=83cbea18e3ca4eb2e12fecfe7af78dc854302285;p=thirdparty%2Fkea.git

[3268] Updated bind10 guide with new D2 global parameters
---

diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index 44d804c7c1..7eaef3e44f 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -5221,9 +5221,11 @@ Dhcp6/renew-timer	1000	integer	(default)
         configuration will be available. It will look similar to this:
 <screen>
 &gt; <userinput>config show DhcpDdns</userinput>
-DhcpDdns/interface  "eth0"  string  (default)
 DhcpDdns/ip_address "127.0.0.1" string  (default)
 DhcpDdns/port   53001   integer (default)
+DhcpDdns/dns_server_timeout   100   integer (default)
+DhcpDdns/ncr-protocol	"UDP"	string (default)
+DhcpDdns/ncr-format	"JSON"	string (default)
 DhcpDdns/tsig_keys  []  list    (default)
 DhcpDdns/forward_ddns/ddns_domains  []  list    (default)
 DhcpDdns/reverse_ddns/ddns_domains  []  list    (default)
@@ -5240,7 +5242,7 @@ DhcpDdns/reverse_ddns/ddns_domains  []  list    (default)
         <itemizedlist>
           <listitem>
             <simpara>
-              <command>General Server Parameters</command> &mdash;
+              <command>Global Server Parameters</command> &mdash;
               values which control connectivity and global server behavior
             </simpara>
           </listitem>
@@ -5264,13 +5266,37 @@ DhcpDdns/reverse_ddns/ddns_domains  []  list    (default)
           </listitem>
         </itemizedlist>
       <section id="d2-server-parameter-config">
-        <title>General Server Parameters</title>
+        <title>Global Server Parameters</title>
+      <orderedlist>
+      <listitem><para>
+      ip_address - IP address on which D2 listens for requests. The default is
+      the local loopback interface at address 127.0.0.1. You may specify
+      either an IPv4 or IPv6 address.
+      </para></listitem>
+      <listitem><para>
+      port - Port on which D2 listens for requests.  The default value
+      is 53001.
+      </para></listitem>
+      <listitem><para>
+      ncr-format - Socket protocol use when sending requests to D2.  Currently
+      only UDP is supported.  TCP may be available in an upcoming release.
+      </para></listitem>
+      <listitem><para>
+      ncr-protocol - Packet format to use when sending requests to D2.
+      Currently only JSON format is supported.  Other formats may be available
+      in future releases.
+      </para></listitem>
+      <listitem><para>
+      dns_server_timeout - The maximum amount of time in milliseconds, that
+      D2 will wait for a response from a DNS server to a single DDNS update
+      message.
+      </para></listitem>
+      </orderedlist>
         <para>
-        The DHCP-DDNS server must listen for requests on a known address and
-        port. By default, it will listen at 127.0.0.1 on port 53001.  This is
-        governed by the parameters, "ip-address" and "port".  Either value
-        may be changed using config set/commit. For example to change the
-        server to listen at 192.168.1.10 port 900:
+        D2 must listen for change requests on a known address and port.  By
+        default it listens at 127.0.0.1 on port 53001. The following example
+        illustrates how to change D2's global parameters so it will listen
+        at 192.168.1.10 port 900:
 <screen>
 &gt; <userinput>config set DhcpDdns/ip_address "192.168.1.10"</userinput>
 &gt; <userinput>config set DhcpDdns/port 900</userinput>
@@ -5290,7 +5316,6 @@ DhcpDdns/reverse_ddns/ddns_domains  []  list    (default)
             authentication to guard against such attacks.
           </simpara>
         </warning>
-
 <note>
 <simpara>
 If the ip_address and port are changed, it will be necessary to change the