mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-30 13:37:55 +00:00
Code Issues Releases Wiki Activity

[#1842] document overlapping pools and subnets

Browse Source
This commit is contained in:
Andrei Pavel
2022-04-04 16:34:14 +03:00
committed by Tomek Mrugalski
parent 9e62cc59e6
commit 4a035f60cf
3 changed files with 51 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/sphinx/arm/dhcp4-srv.rst
View File

@@ -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)

28
doc/sphinx/arm/dhcp6-srv.rst
View File

@@ -1142,6 +1142,34 @@ and which is delegated a prefix from this pool.
]
}
.. 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 address pools in one subnet | Startup error | DHCP6_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. |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Address pools that are outside the subnet they are configured under | Startup error | DHCP6_PARSER_FAIL |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping prefix delegation pools in one subnet | Startup error | DHCP6_PARSER_FAIL |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping prefix delegation 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. |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Prefix delegation pools that are outside the subnet they are configured under | Allowed | |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
.. _dhcp6-std-options:
Standard DHCPv6 Options

7
src/lib/dhcpsrv/subnet.h
View File

@@ -146,10 +146,9 @@ public:
///
/// @param pool pool to be added
///
/// @throw isc::BadValue if the pool type is invalid, the pool
/// is not an IA_PD pool and the address range of this pool does not
/// match the subnet prefix, or the pool overlaps with an existing pool
/// within the subnet.
/// @throw isc::BadValue if the pool type is invalid, in the case of address
/// pools if the address range of the pool does not match the subnet prefix,
/// or if the pool overlaps with an existing pool within the subnet.
void addPool(const PoolPtr& pool);
/// @brief Deletes all pools of specified type.