From: Francis Dupont <fdupont@isc.org>
Date: Mon, 19 Feb 2018 17:16:17 +0000 (+0100)
Subject: [master] Merged trac5390 (listen on loopback)
X-Git-Tag: trac5502_base~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e414805ce11375de09b5b70d9943eed611c18d69;p=thirdparty%2Fkea.git

[master] Merged trac5390 (listen on loopback)
---

e414805ce11375de09b5b70d9943eed611c18d69
diff --cc doc/guide/dhcp4-srv.xml
index 83de4dadb9,37be8932e6..b06324f4b1
--- a/doc/guide/dhcp4-srv.xml
+++ b/doc/guide/dhcp4-srv.xml
@@@ -773,9 -772,27 +773,27 @@@ temporarily override a list of interfac
    Note interfaces are not re-detected during <command>config-test</command>.
    </para>
  
+   <para>Usually loopback interfaces (e.g. the "lo" or "lo0" interface)
+   may not be configured but if a loopback interface is explicitely configured
+   and IP/UDP sockets are specified the loopback interface is accepted.
+   </para>
+ 
+   <para>It can be used for instance to run Kea in a FreeBSD jail having
+   only a loopback interface, servicing relayed DHCP request:
+ 
+   <screen>
+ "Dhcp4": {
+     "interfaces-config": {
+         "interfaces": [ <userinput>"lo0"</userinput> ],
+         "dhcp-socket-type": "udp"
+     },
+     ...
+ }</screen>
+   </para>
+ 
  </section>
  
 -<section id="dhcpinform-unicast-issues">
 +<section xml:id="dhcpinform-unicast-issues">
    <title>Issues with Unicast Responses to DHCPINFORM</title>
    <para>The use of UDP sockets has certain benefits in deployments
    where the server receives only relayed traffic; these benefits are
diff --cc doc/guide/dhcp6-srv.xml
index f5e1ae340e,acb58b0c4f..c974e0b3ce
--- a/doc/guide/dhcp6-srv.xml
+++ b/doc/guide/dhcp6-srv.xml
@@@ -655,9 -654,24 +655,24 @@@ temporarily override a list of interfac
  }
    </screen>
  
+   <para>The loopback interfaces (i.e. the "lo" or "lo0" interface)
+   are not configured by default, unles explicitely mentioned in
+   the configration. Note Kea requires a link-local address which does
+   not exist on all systems, or a specified unicast address as in:
+   </para>
+ 
+   <screen>
+ "Dhcp6": {
+     "interfaces-config": {
+         "interfaces": [ <userinput>"lo/::1"</userinput> ]
+     },
+     ...
+ }
+   </screen>
+ 
  </section>
  
 -    <section id="ipv6-subnet-id">
 +    <section xml:id="ipv6-subnet-id">
        <title>IPv6 Subnet Identifier</title>
        <para>
          The subnet identifier is a unique number associated with a particular subnet.