]> git.ipfire.org Git - thirdparty/pdns.git/commitdiff
Refer to new root hint handling info from settings docs 11381/head
authorOtto Moerbeek <otto.moerbeek@open-xchange.com>
Thu, 14 Apr 2022 12:24:27 +0000 (14:24 +0200)
committerOtto Moerbeek <otto.moerbeek@open-xchange.com>
Thu, 14 Apr 2022 12:44:08 +0000 (14:44 +0200)
pdns/recursordist/docs/appendices/FAQ.rst
pdns/recursordist/docs/settings.rst

index 7fd916ae7d87a3f300800ecf30da8eece942b428..d063998332983b6c13e46b7aeefbe6a338439597 100644 (file)
@@ -57,6 +57,9 @@ Or, in a diagram::
       client bufsize (stub => recursor)
      bufsize reported to client (recursor => stub [always 512])
 
+.. _handling-of-root-hints:
+
+
 Handling of root hints
 ----------------------
 
@@ -75,7 +78,7 @@ If that does not succeed, it wil fall back to using the root hints to fill the c
 Prior to version 4.7.0, the period for re-fetching root data was :ref:`setting-max-cache-ttl` divided by 12, with a minimum of 10 seconds.
 Starting with version 4.7.0, the period is adaptive, starting at 80% of :ref:`setting-max-cache-ttl`, reducing the interval on failure.
 
-There is another detail: after refreshing rhe root records, the :program:`Recursor` will resolve the ``NS`` records for the top level domain of the root servers.
+There is another detail: after refreshing the root records, the :program:`Recursor` will resolve the ``NS`` records for the top level domain of the root servers.
 For example, in the default setup the root name servers are called ``[a-m].root-servers.net``, so the :program:`Recursor` will resolve the name servers of the ``.net`` domain.
 This is needed to correctly determine zone cuts to be able to decide if the ``.root-servers.net`` domain is DNSSEC protected.
 
index 9aa287751b98d1bdabf79593a1a5ec7c5d0a4496..d7a962a332fa654b5fa42be7324b68dc8b71b555 100644 (file)
@@ -893,6 +893,7 @@ If set, the root-hints are read from this file. If empty, the default built-in r
 
 In some special cases, processing the root hints is not needed, for example when forwarding all queries to another recursor.
 For these special cases, it is possible to disable the processing of root hints by setting the value to ``no``.
+See :ref:`handling-of-root-hints` for more information on root hints handling.
 
 .. _setting-ignore-unknown-settings:
 
@@ -1121,6 +1122,8 @@ The size of the negative cache is 10% of this number.
 -  Default: 86400
 
 Maximum number of seconds to cache an item in the DNS cache, no matter what the original TTL specified.
+This value also controls the refresh period of cached root data.
+See :ref:`handling-of-root-hints` for more information on this.
 
 .. versionchanged:: 4.1.0