BIND 10 trac2597, updated. 695d9fc3bc135de080369b0b7213aca3c264216c [2597] Documentation updated.

[BIND 10 source code commits]

The branch, trac2597 has been updated
       via  695d9fc3bc135de080369b0b7213aca3c264216c (commit)
      from  5f6ae1f6c5c0f484c1e2f3073d713784cf3c5373 (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 695d9fc3bc135de080369b0b7213aca3c264216c
Author: Tomek Mrugalski <tomasz at isc.org>
Date:   Mon Jan 14 18:14:19 2013 +0100

    [2597] Documentation updated.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog                  |    7 +++++++
 doc/guide/bind10-guide.xml |   48 +++++++++++++++++++++++++++++++++++++++-----
 2 files changed, 50 insertions(+), 5 deletions(-)

-----------------------------------------------------------------------
diff --git a/ChangeLog b/ChangeLog
index a103a7a..c9efcb4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+5XX.	[func]		tomek
+	b10-dhcp4: Server identifier is now generated automatically and
+	stored to a file. It is also read during server start.
+	b10-dhcp6: Server identifier is now stores to a file and read
+	during server start.
+	(Trac #2597, git TBD)
+
 545.	[func]		jinmei
 	libdns++: the SOA Rdata class now uses the generic lexer in
 	constructors from text.  This means that the MNAME and RNAME of an
diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index f1f5859..bb57211 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -3485,18 +3485,33 @@ Dhcp4/subnet4	         []     list    (default)</screen>
         src/bin/dhcp6/dhcp4_srv.cc file, modify the following parameters and
         recompile:
         <screen>
-const std::string HARDCODED_LEASE = "192.0.2.222"; // assigned lease
-const std::string HARDCODED_NETMASK = "255.255.255.0";
-const uint32_t    HARDCODED_LEASE_TIME = 60; // in seconds
 const std::string HARDCODED_GATEWAY = "192.0.2.1";
 const std::string HARDCODED_DNS_SERVER = "192.0.2.2";
-const std::string HARDCODED_DOMAIN_NAME = "isc.example.com";
-const std::string HARDCODED_SERVER_ID = "192.0.2.1";</screen>
+const std::string HARDCODED_DOMAIN_NAME = "isc.example.com";</screen>
 
         Lease database and configuration support is planned for end of 2012.
       </para>
     </section>
 
+    <section id="dhcp4-serverid">
+      <title>Server Identifier in DHCPv4</title>
+      <para>DHCPv4 protocol uses server identifier for clients to be able
+      to discriminate between several servers present on the same link.
+      This value is an IPv4 address of the server. Server will automatically
+      use one of its IPv4 address as its server-id and will store it to
+      a b10-dhcp4-serverid file. Location of that file is dependant on the
+      parameters specified during source configuration (see --localstatedir
+      parameter passed to configure). This file will be created during first
+      server run and will be read from that file during consecutive starts.
+      </para>
+      <para>
+        It is unlikely that this parameter needs to be changed. If such a need
+        arises, please stop the server, edit the file and start the server
+        again. It is a text file that should contain an IPv4 address. Spaces are
+        ignored.  No extra characters are allowed in this file.
+      </para>
+    </section>
+
     <section id="dhcp4-std">
       <title>Supported standards</title>
       <para>The following standards and draft standards are currently
@@ -3841,6 +3856,29 @@ Dhcp6/subnet6	         []     list    (default)</screen>
       </note>
     </section>
 
+    <section id="dhcp6-serverid">
+      <title>Server Identifier in DHCPv6</title>
+      <para>DHCPv6 protocol uses server identifier (DUID) for clients to be able
+      to discriminate between several servers present on the same link.  There
+      are several types of DUIDs currently defined, but RFC3315 instructs the
+      servers to use DUID-LLT if possible. This format consists of a link-layer
+      (MAC) address and a timestamp. Server will generate automatically such a
+      DUID and will store it to a b10-dhcp6-serverid file. Location of that file
+      is dependant on the parameters specified during source configuration (see
+      --localstatedir parameter passed to configure). This file will be created
+      during first server run and will be read from that file during consecutive
+      starts.
+      </para>
+      <para>
+        It is unlikely that this parameter needs to be changed. If such a need
+        arises, please stop the server, edit the file and start the server
+        again. It is a text file that contains double digit hexadecimal values
+        separated by colons. This format is similar to typical MAC address
+        format. Spaces are ignored. No extra characters are allowed in this
+        file.
+      </para>
+    </section>
+
     <section id="dhcp6-std">
       <title>Supported DHCPv6 Standards</title>
       <para>The following standards and draft standards are currently