diff options
| author | Vladimír Čunát <vladimir.cunat@nic.cz> | 2022-07-14 11:31:25 +0200 |
|---|---|---|
| committer | Vladimír Čunát <vladimir.cunat@nic.cz> | 2022-12-13 10:58:33 +0100 |
| commit | bc0cf66ba2493b86d0adb4375f3ae0aeca6039ed (patch) | |
| tree | 906cbad8b3450744e95919c77346645dd8739a8c /daemon/bindings | |
| parent | TTL bounds: improve the logic (diff) | |
| download | knot-resolver-bc0cf66ba2493b86d0adb4375f3ae0aeca6039ed.tar.xz knot-resolver-bc0cf66ba2493b86d0adb4375f3ae0aeca6039ed.zip | |
NEWS + doc about TTL: apply changes from previous commits
(and minor other changes)
Diffstat (limited to 'daemon/bindings')
| -rw-r--r-- | daemon/bindings/cache.rst | 16 |
1 files changed, 7 insertions, 9 deletions
diff --git a/daemon/bindings/cache.rst b/daemon/bindings/cache.rst index 6cab9930..fe614bf9 100644 --- a/daemon/bindings/cache.rst +++ b/daemon/bindings/cache.rst @@ -221,17 +221,15 @@ Configuration reference .. function:: cache.max_ttl([ttl]) - :param number ttl: maximum cache TTL in seconds (default: 1 day) + :param number ttl: maximum TTL in seconds (default: 1 day) .. KR_CACHE_DEFAULT_TTL_MAX ^^ :return: current maximum TTL - Get or set maximum cache TTL. + Get or set maximum TTL bound applied to all received records. - .. note:: The `ttl` value must be in range `(min_ttl, 4294967295)`. - - .. warning:: This settings applies only to currently open cache, it will not persist if the cache is closed or reopened. + .. note:: The `ttl` value must be in range `(min_ttl, 2147483647)`. .. code-block:: lua @@ -244,18 +242,18 @@ Configuration reference .. function:: cache.min_ttl([ttl]) - :param number ttl: minimum cache TTL in seconds (default: 5 seconds) + :param number ttl: minimum TTL in seconds (default: 5 seconds) .. KR_CACHE_DEFAULT_TTL_MIN ^^ :return: current maximum TTL - Get or set minimum cache TTL. Any entry inserted into cache with TTL lower than minimal will be overridden to minimum TTL. Forcing TTL higher than specified violates DNS standards, use with care. + Get or set minimum TTL bound applied to all received records. + Forcing TTL higher than specified violates DNS standards, so use it with care. + TTL still won't be extended beyond expiration of the corresponding DNSSEC signature. .. note:: The `ttl` value must be in range `<0, max_ttl)`. - .. warning:: This settings applies only to currently open cache, it will not persist if the cache is closed or reopened. - .. code-block:: lua -- Get minimum TTL |