From bc0cf66ba2493b86d0adb4375f3ae0aeca6039ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vladim=C3=ADr=20=C4=8Cun=C3=A1t?= <vladimir.cunat@nic.cz>
Date: Thu, 14 Jul 2022 11:31:25 +0200
Subject: [PATCH] NEWS + doc about TTL: apply changes from previous commits
(and minor other changes)
---
NEWS | 2 ++
daemon/bindings/cache.rst | 16 +++++++---------
2 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/NEWS b/NEWS
index 53b11e6ee..f93929e40 100644
--- a/NEWS
+++ b/NEWS
@@ -3,6 +3,8 @@ Knot Resolver 5.x.y (202y-mm-dd)
Improvements
------------
+- cache.max_ttl(): lower the default from six days to one day (!1323)
+ and apply both limits to the first uncached answer already
- depend on jemalloc, preferably, to improve memory usage (!1353)
- no longer accept DNS messages with trailing data (!1365)
- policy.STUB: avoid applying aggressive DNSSEC denial proofs (!1364)
diff --git a/daemon/bindings/cache.rst b/daemon/bindings/cache.rst
index 6cab99305..fe614bf96 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
--
GitLab