summaryrefslogtreecommitdiffstats
path: root/doc/sphinx/arm/dhcp4-srv.rst
diff options
context:
space:
mode:
authorAndrei Pavel <andrei@isc.org>2022-04-04 15:34:14 +0200
committerTomek Mrugalski <tomek@isc.org>2022-04-25 15:00:37 +0200
commit4a035f60cf2bd4dab3a4b05effb4f28d42b258c9 (patch)
tree2698f372a547cb0ba5bf34aaf1934da2d81d12f1 /doc/sphinx/arm/dhcp4-srv.rst
parentUpdate conf.py (diff)
downloadkea-4a035f60cf2bd4dab3a4b05effb4f28d42b258c9.tar.xz
kea-4a035f60cf2bd4dab3a4b05effb4f28d42b258c9.zip
[#1842] document overlapping pools and subnets
Diffstat (limited to 'doc/sphinx/arm/dhcp4-srv.rst')
-rw-r--r--doc/sphinx/arm/dhcp4-srv.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/sphinx/arm/dhcp4-srv.rst b/doc/sphinx/arm/dhcp4-srv.rst
index 9feabe94a7..be5f90ed62 100644
--- a/doc/sphinx/arm/dhcp4-srv.rst
+++ b/doc/sphinx/arm/dhcp4-srv.rst
@@ -1231,6 +1231,26 @@ address) address from that pool. In the aforementioned example of pool
assigned as well. This may be invalid in some network configurations. To
avoid this, use the ``min-max`` notation.
+.. note::
+
+ Here are some liberties and limits to the values that subnets and pools can
+ take in Kea configurations that are out of the ordinary:
+
+ +-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
+ | Kea configuration case | Result | Comment |
+ +=============================================================+===============+================================================================================+
+ | Overlapping subnets | Allowed | Administrator consideration needs to be given to how clients are matched to |
+ | | | these subnets. |
+ +-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
+ | Overlapping pools in one subnet | Startup error | DHCP4_PARSER_FAIL |
+ +-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
+ | Overlapping address pools in different subnets | Allowed | Can act as a substitute for a global pool mechanic. When assigning leases from |
+ | | | one pool, Kea correctly excludes leases given under any pool that overlaps |
+ | | | with it such that no lease is given twice. |
+ +-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
+ | Pools that are outside the subnet they are configured under | Startup error | DHCP4_PARSER_FAIL |
+ +-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
+
.. _dhcp4-t1-t2-times:
Sending T1 (Option 58) and T2 (Option 59)