From: Diego Fronza <diego@isc.org>
Date: Wed, 4 Nov 2020 23:02:58 +0000 (-0300)
Subject: Update ARM and other documents
X-Git-Tag: v9.17.7~5^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1ba2215c29dfe693343b86cb607f313bad3337e3;p=thirdparty%2Fbind9.git

Update ARM and other documents
---

diff --git a/bin/named/named.conf.rst b/bin/named/named.conf.rst
index 2f7c6a9854c..42f6f80063c 100644
--- a/bin/named/named.conf.rst
+++ b/bin/named/named.conf.rst
@@ -401,6 +401,7 @@ OPTIONS
   	stale-answer-enable boolean;
   	stale-answer-ttl duration;
   	stale-cache-enable boolean;
+  	stale-refresh-time duration;
   	startup-notify-rate integer;
   	statistics-file quoted_string;
   	synth-from-dnssec boolean;
@@ -797,6 +798,7 @@ VIEW
   	stale-answer-enable boolean;
   	stale-answer-ttl duration;
   	stale-cache-enable boolean;
+  	stale-refresh-time duration;
   	synth-from-dnssec boolean;
   	transfer-format ( many-answers | one-answer );
   	transfer-source ( ipv4_address | * ) [ port ( integer | * ) ] [
diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst
index 47485165fb0..15ad929a906 100644
--- a/doc/arm/reference.rst
+++ b/doc/arm/reference.rst
@@ -1839,6 +1839,19 @@ Boolean Options
 ``stale-cache-enable``
    If ``yes``, enable the retaining of "stale" cached answers.  Default ``no``.
 
+``stale-refresh-time``
+   If the name servers for a given zone are not answering, this sets the time
+   window for which ``named`` will promptly return "stale" cached answers for
+   that RRSet being requested before a new attempt in contacting the servers
+   is made. For convenience, TTL-style time-unit suffixes may be used to
+   specify the value. It also accepts ISO 8601 duration formats.
+
+   The default ``stale-refresh-time`` is 30 seconds, as RFC 8767 recommends
+   that attempts to refresh to be done no more frequently than every 30
+   seconds. A value of zero disables the feature, meaning that normal
+   resolution will take place first, if that fails only then ``named`` will
+   return "stale" cached answers.
+
 ``nocookie-udp-size``
    This sets the maximum size of UDP responses that are sent to queries
    without a valid server COOKIE. A value below 128 is silently
diff --git a/doc/man/named.conf.5in b/doc/man/named.conf.5in
index 36a770977b1..356a0d122bb 100644
--- a/doc/man/named.conf.5in
+++ b/doc/man/named.conf.5in
@@ -464,6 +464,7 @@ options {
       stale\-answer\-enable boolean;
       stale\-answer\-ttl duration;
       stale\-cache\-enable boolean;
+      stale\-refresh\-time duration;
       startup\-notify\-rate integer;
       statistics\-file quoted_string;
       synth\-from\-dnssec boolean;
@@ -892,6 +893,7 @@ view string [ class ] {
       stale\-answer\-enable boolean;
       stale\-answer\-ttl duration;
       stale\-cache\-enable boolean;
+      stale\-refresh\-time duration;
       synth\-from\-dnssec boolean;
       transfer\-format ( many\-answers | one\-answer );
       transfer\-source ( ipv4_address | * ) [ port ( integer | * ) ] [
diff --git a/doc/misc/options b/doc/misc/options
index 620407c12f8..b49cf127970 100644
--- a/doc/misc/options
+++ b/doc/misc/options
@@ -366,6 +366,7 @@ options {
         stale-answer-enable <boolean>;
         stale-answer-ttl <duration>;
         stale-cache-enable <boolean>;
+        stale-refresh-time <duration>;
         startup-notify-rate <integer>;
         statistics-file <quoted_string>;
         statistics-interval <integer>; // ancient
@@ -758,6 +759,7 @@ view <string> [ <class> ] {
         stale-answer-enable <boolean>;
         stale-answer-ttl <duration>;
         stale-cache-enable <boolean>;
+        stale-refresh-time <duration>;
         suppress-initial-notify <boolean>; // not yet implemented
         synth-from-dnssec <boolean>;
         topology { <address_match_element>; ... }; // ancient
diff --git a/doc/misc/options.active b/doc/misc/options.active
index 99adabde9c8..da43db123a3 100644
--- a/doc/misc/options.active
+++ b/doc/misc/options.active
@@ -329,6 +329,7 @@ options {
         stale-answer-enable <boolean>;
         stale-answer-ttl <duration>;
         stale-cache-enable <boolean>;
+        stale-refresh-time <duration>;
         startup-notify-rate <integer>;
         statistics-file <quoted_string>;
         synth-from-dnssec <boolean>;
@@ -686,6 +687,7 @@ view <string> [ <class> ] {
         stale-answer-enable <boolean>;
         stale-answer-ttl <duration>;
         stale-cache-enable <boolean>;
+        stale-refresh-time <duration>;
         synth-from-dnssec <boolean>;
         transfer-format ( many-answers | one-answer );
         transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] [
diff --git a/doc/misc/options.grammar.rst b/doc/misc/options.grammar.rst
index 1725a6e458a..ace29b5704f 100644
--- a/doc/misc/options.grammar.rst
+++ b/doc/misc/options.grammar.rst
@@ -259,6 +259,7 @@
   	stale-answer-enable <boolean>;
   	stale-answer-ttl <duration>;
   	stale-cache-enable <boolean>;
+  	stale-refresh-time <duration>;
   	startup-notify-rate <integer>;
   	statistics-file <quoted_string>;
   	synth-from-dnssec <boolean>;