document cache.ns_tout

diff --git a/daemon/README.rst b/daemon/README.rst
index 07c8f6a9ecdf249fd67fede5966a6492af79a1c3..545e0fa18c063e0c6e1e9ef2f88cfc846811aca1 100644 (file)
--- a/daemon/README.rst
+++ b/daemon/README.rst
@@ -756,6 +756,16 @@ daemons or manipulated from other processes, making for example synchronised loa
      cache.min_ttl(5)
      5
 
+.. function:: cache.ns_tout([timeout])
+
+  :param timeout: number of milliseconds (default: :c:macro:`KR_NS_TIMEOUT_RETRY_INTERVAL`)
+  :return: current timeout
+
+  Get or set time interval for which a nameserver address will be ignored after determining that it doesn't return (useful) answers.
+  The intention is to avoid waiting if there's little hope; instead, kresd can immediately SERVFAIL or immediately use stale records (with ``serve_stale`` module).
+
+  .. warning:: This settings applies only to the current kresd process.
+
 .. function:: cache.prune([max_count])
 
   :param number max_count:  maximum number of items to be pruned at once (default: 65536)

diff --git a/lib/nsrep.h b/lib/nsrep.h
index 36dc6e8d23b702005a2ab0063eeaa8a5e5e6d2ee..36aea3a64d74ae0cd60c8674f10048e8102c0c16 100644 (file)
--- a/lib/nsrep.h
+++ b/lib/nsrep.h
@@ -45,8 +45,8 @@ enum kr_ns_score {
  */
 #define KR_NS_DEAD (((KR_NS_TIMEOUT * 4) + 3) / 3)
 
-/* If once NS was marked as "timeouted", it won't participate in NS elections
- * at least KR_NS_TIMEOUT_RETRY_INTERVAL milliseconds. */
+/** If once NS was marked as "timeouted", it won't participate in NS elections
+ * at least KR_NS_TIMEOUT_RETRY_INTERVAL milliseconds (now: one minute). */
 #define KR_NS_TIMEOUT_RETRY_INTERVAL 60000
 
 /**