]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#2422] add limits to the list of hook libraries in the ARM
authorAndrei Pavel <andrei@isc.org>
Tue, 31 May 2022 12:33:57 +0000 (15:33 +0300)
committerAndrei Pavel <andrei@isc.org>
Wed, 8 Jun 2022 11:40:58 +0000 (11:40 +0000)
doc/sphinx/arm/hooks-limits.rst
doc/sphinx/arm/hooks.rst

index 67816b91c0f8032859b73b8daf27823d5d59bacc..b720777295f6f9b8b20b3ba571bef2ed903dc4d7 100644 (file)
@@ -28,9 +28,17 @@ it or the hook library configuration.
 There are two ways to configure which packets get limited. One is through the client classes that are
 initially assigned to the packet.  In this case, the limit is configured in the user context
 in the client class definition.  Class rate limits are checked early in packet processing cycle
-and is thus limited to those classes which are assigned to the packet via test expression and that
-do not depend on host reservations, the special "BOOTP" or "KNOWN" classes, and is not marked with
-"only-if-required".
+and are thus limited to those classes which are assigned to the packet via test expression, that do
+not depend on host reservations, the special "BOOTP" or "KNOWN" classes, and that are not marked
+with "only-if-required".
+
+.. note::
+
+    The limits hook library uses the name to identify a client class and the ID to identify a subnet.
+    Changing a test expression in a client class or the network range of a subnet while leaving the
+    name, or the ID respectively, unchanged will not reset the limit for the respective client class
+    or subnet and what counted towards the limit prior to the change, will continue to take effect.
+    To start over, consider changing the client class name or the subnet ID.
 
 .. note::
 
index 3a8a15155ea9653fd397e524486171f101f16ccb..5bd28a5ae5bccba78a90594cd5ce0d69d1c0f6bd 100644 (file)
@@ -466,6 +466,11 @@ loaded by the correct process per the table below.
    |                 | customers     |update aspects such as generating hostnames via expressions |
    |                 |               |and skipping DDNS updates for select clients.               |
    +-----------------+---------------+------------------------------------------------------------+
+   | Limits          | ISC support   | Kea servers ``kea-dhcp4`` and ``kea-dhcp6`` can use this   |
+   |                 | customers     | hook library to apply a limit to the rate at which packets |
+   |                 |               | receive a response. The limit can be applied               |
+   |                 |               | per client class or per subnet.                            |
+   +-----------------+---------------+------------------------------------------------------------+
 
 ISC hopes to see more hook libraries become available as time
 progresses, developed both internally and externally. Since this list