bind9/doc/arm
Evan Hunt 3704cf42eb Don't use dns_db_findzonecut() in query_addbestns()
Previously, when answering from the cache, and when minimal-responses
was not set, we added the best known zone cut to the authority section
of the response message, using dns_db_findzonecut() to look it up in
the DNS cache.  Since the DNS cache will no longer be used to store
parent-side NS RRsets, it will now be possible for an ancestor node
to be used as the zone cut, leading to the wrong NS record being
included.

There are various ways we could correct this:

1. Use dns_deleg_lookup() instead of dns_db_findzonecut() to find the
   zone cut. But currently, the deleg database stores only the server
   addresses for the delegation, not the full NS RRset; this would need
   to be changed.
2. Look up <name>/NS whenever we cache a referral; that way we'll get
   the child-side NS RRset and cache that, and we can retrieve it when
   building the response.

But the solution chosen here is simply not to look up the NS record
when answering from the cache, effectively making "minimal-responses
yes;" mandatory for queries answered from the cache.

System tests have been updated as needed, so they no longer expect
NS RRsets in the authority section of recursive responses.
2026-03-30 20:41:13 +02:00
..
_ext Automatically sort imports in Python code 2026-02-20 15:17:32 +01:00
_static ARM style change: render literals in black color 2022-06-02 17:13:19 +02:00
.gitignore Convert the documentation to Sphinx documentation format 2020-05-07 16:02:56 +02:00
advanced.inc.rst Deprecate the "tkey-gssapi-credential" statement 2025-09-01 21:23:30 +02:00
build.inc.rst pkcs11-provider project has new home 2026-03-25 10:47:42 +01:00
catz.inc.rst Review and update ARM documentation 2024-09-11 16:23:30 +02:00
changelog.rst Generate changelog for BIND 9.21.20 2026-03-13 15:51:19 +01:00
chapter1.rst Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
chapter2.rst Remove build from chapter 2 and move it to the end of ARM 2022-05-11 10:51:26 +02:00
chapter3.rst Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
chapter4.rst Split Configuration chapter in the ARM into chapters 3 and 4 2022-05-11 10:51:26 +02:00
chapter5.rst Move "DNSSEC" chapter before "Advanced" and "Security" 2022-06-22 13:37:18 +02:00
chapter6.rst Move "DNSSEC" chapter before "Advanced" and "Security" 2022-06-22 13:37:18 +02:00
chapter7.rst further cleanup after removing diffie-hellman TKEY mode 2023-03-08 08:36:25 +01:00
chapter9.rst Restructure includes for chapter 9 Troubleshooting 2022-05-11 10:51:26 +02:00
chapter10.rst Remove build from chapter 2 and move it to the end of ARM 2022-05-11 10:51:26 +02:00
conf.py Set User-Agent for Sphinx to fix gitlab.gnome.org 2026-03-25 10:39:15 +01:00
config-auth.inc.rst Document the new unreachable cache behavior 2025-06-04 09:16:35 +00:00
config-intro.inc.rst Update example.com zone SOA expire value 2024-10-01 06:32:28 +00:00
config-resolve.inc.rst Remove stub chapter about load balancing from ARM 2025-10-21 09:41:54 +00:00
dlz.inc.rst Fix broken markup in doc/arm/dlz.inc.rst 2025-07-17 07:17:12 +02:00
dns-ops.inc.rst Document that SIGUSR1 closes log files 2024-07-31 17:36:39 +10:00
dns-security-overview.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-security-overview.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-servers.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-servers.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-tree.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-tree.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dnssec-guide.rst Minor DNSSEC guide tweaks 2022-05-11 10:51:26 +02:00
dnssec.inc.rst Add a note about pregenarating keys for key rolls 2025-04-14 14:27:25 +00:00
dyndb.inc.rst Add tag and short description for dyndb statement 2022-07-29 18:56:04 +02:00
general.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
history.rst Update the copyright information in all files in the repository 2022-01-11 09:05:02 +01:00
index.rst Reorder appendices in ARM 2025-09-11 11:04:10 +00:00
intro-dns-bind.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
intro-security.inc.rst Review and update ARM documentation 2024-09-11 16:23:30 +02:00
introduction.inc.rst Remove trailing whitespace from all text files 2023-06-13 15:05:40 +02:00
isc-logo.pdf Update ISC logo 2020-07-08 02:00:11 +00:00
logging-categories.inc.rst Add option request-zoneversion 2025-03-24 22:16:09 +00:00
managed-keys.inc.rst Grammar fixes and assorted text edits in the ARM 2022-07-04 15:50:51 +02:00
manpages.rst add synthrecord plugin documentation 2025-10-01 12:16:05 +02:00
meson.build replace the build system with meson 2025-06-11 10:30:12 +03:00
name-resolution.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
name-resolution.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
notes.rst Prepare release notes for BIND 9.21.20 2026-03-13 15:51:19 +01:00
pkcs11.inc.rst pkcs11-provider project has new home 2026-03-25 10:47:42 +01:00
platforms.inc.rst Add FreeBSD 15.0 2026-01-06 21:17:48 +01:00
plugins.inc.rst add synthrecord plugin documentation 2025-10-01 12:16:05 +02:00
primary-secondary.dia Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
primary-secondary.png Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
recursive-query.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
recursive-query.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
reference.rst Don't use dns_db_findzonecut() in query_addbestns() 2026-03-30 20:41:13 +02:00
requirements.inc.rst Deduplicate link anchors in the ARM 2022-10-05 11:36:19 +02:00
requirements.txt Update Sphinx-related Python packages 2026-02-27 14:10:26 +01:00
resolver-forward.dia Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
resolver-forward.png Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
rpz.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
security.inc.rst Review and update ARM documentation 2024-10-21 12:55:14 +02:00
sig0.inc.rst Split chapter Advanced DNS Features in the ARM into chapters 5, 6, 7 2022-05-11 10:51:26 +02:00
troubleshooting.inc.rst Update wiki.wireshark.org link in doc/arm 2025-11-26 14:30:26 +01:00
tsig.inc.rst further cleanup after removing diffie-hellman TKEY mode 2023-03-08 08:36:25 +01:00
zones.inc.rst remove "sortlist" 2024-12-11 15:09:24 -08:00