From: Colin Vidal <colin@isc.org>
Date: Wed, 19 Nov 2025 11:34:31 +0000 (+0100)
Subject: update doc for strict boundaries check
X-Git-Tag: v9.21.17~4^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7bf04a9a4cb6aabadcc1f9f48bc773edd386e4fb;p=thirdparty%2Fbind9.git

update doc for strict boundaries check

Update documentation, removing the mention of statements being
implicitely "fixed" if they are defined out of range (for
`edns-version`, `edns-udp-size`, `max-udp-size`, `no-cookie-udp-size`
and `padding`) as the ranges are now enforced.
---

diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index f3255078903..d9061215c5b 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -2359,11 +2359,10 @@ Boolean Options
    :tags: query
    :short: Sets the maximum size of UDP responses that are sent to queries without a valid server COOKIE.
 
-   This sets the maximum size of UDP responses that are sent to queries
-   without a valid server COOKIE. A value below 128 is silently
-   raised to 128. The default value is 4096, but the :any:`max-udp-size`
-   option may further limit the response size as the default for
-   :any:`max-udp-size` is 1232.
+   This sets the maximum size of UDP responses that are sent to queries without
+   a valid server COOKIE. A minimum value is 128. The default value is 4096,
+   but the :any:`max-udp-size` option may further limit the response size as
+   the default for :any:`max-udp-size` is 1232.
 
 .. namedconf:statement:: cookie-algorithm
    :tags: server
@@ -4331,10 +4330,8 @@ Tuning
    :short: Sets the maximum advertised EDNS UDP buffer size to control the size of packets received from authoritative servers in response to recursive queries.
 
    This sets the maximum advertised EDNS UDP buffer size, in bytes, to control
-   the size of packets received from authoritative servers in response
-   to recursive queries. Valid values are 512 to 4096; values outside
-   this range are silently adjusted to the nearest value within it.
-   The default value is 1232.
+   the size of packets received from authoritative servers in response to
+   recursive queries. Valid values are 512 to 4096. The default value is 1232.
 
    The usual reason for setting :any:`edns-udp-size` to a non-default value
    is to get UDP answers to pass through broken firewalls that block
@@ -4367,9 +4364,7 @@ Tuning
    :short: Sets the maximum EDNS UDP message size sent by :iscman:`named`.
 
    This sets the maximum EDNS UDP message size that :iscman:`named` sends, in bytes.
-   Valid values are 512 to 4096; values outside this range are
-   silently adjusted to the nearest value within it. The default value
-   is 1232.
+   Valid values are 512 to 4096. The default value is 1232.
 
    This value applies to responses sent by a server; to set the
    advertised buffer size in queries, see :any:`edns-udp-size`.
@@ -4515,9 +4510,8 @@ Tuning
    :any:`prefetch` specifies the "trigger" TTL value at which prefetch
    of the current query takes place; when a cache record with an
    equal or lower TTL value is encountered during query processing, it is
-   refreshed. Valid trigger TTL values are 1 to 10 seconds. Values
-   larger than 10 seconds are silently reduced to 10. Setting a
-   trigger TTL to zero causes prefetch to be disabled. The default
+   refreshed. Valid trigger TTL values are 1 to 10 seconds.  Setting a trigger
+   TTL to zero causes prefetch to be disabled. The default
    trigger TTL is ``2``.
 
    An optional second argument specifies the "eligibility" TTL: the
@@ -5605,9 +5599,8 @@ any top-level :namedconf:ref:`server` statements are used as defaults.
    heuristics that indicate that a lower version should be sent. This
    option is intended to be used when a remote server reacts badly to a
    given EDNS version or higher; it should be set to the highest version
-   the remote server is known to support. Valid values are 0 to 255; higher
-   values are silently adjusted. This option is not needed until
-   higher EDNS versions than 0 are in use.
+   the remote server is known to support. Valid values are 0 to 255. This
+   option is not needed until higher EDNS versions than 0 are in use.
 
 .. namedconf:statement:: padding
    :tags: server