Update ARM and other documents

diff --git a/bin/named/named.conf.rst b/bin/named/named.conf.rst
index 2f7c6a9854c6e2f4903b169de37be379b3fea2e5..42f6f80063c4e08ec8a316a0490c4ab4d5b40860 100644 (file)
--- 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 47485165fb02333e698ae85fdf98edf32463e88c..15ad929a90621cfccc04c1b2f5a0ecd055e51249 100644 (file)
--- 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 36a770977b1b3ca22bd31ccef6703348ad399097..356a0d122bbc7a53f2c8c3dcaef1745df4a4c7d4 100644 (file)
--- 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 620407c12f85ca8085ef51a4fe2e52465e9d6e95..b49cf127970e8160f131d784fd75da18dee14d76 100644 (file)
--- 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 99adabde9c8e9d2a79c2796ef10a038f490e4c34..da43db123a3ed1ea7bd5c08ee4739218f4f308df 100644 (file)
--- 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 1725a6e458ac3d6cb7723f1a5763d5b69c213759..ace29b5704fdf39760dddb1d7b7243c54e020c41 100644 (file)
--- 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>;