2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-29 13:38:26 +00:00

Update documentation for 9.20.0

This commit is contained in:
Nicki Křížek 2024-07-08 13:51:31 +02:00
parent 890ebd3fd3
commit 3489840948
No known key found for this signature in database
GPG Key ID: 01623B9B652A20A7
11 changed files with 19 additions and 19 deletions

View File

@ -55,13 +55,14 @@ Required Libraries
To build BIND 9, the following packages must be installed: To build BIND 9, the following packages must be installed:
- a C11-compliant compiler
- ``libcrypto``, ``libssl`` - ``libcrypto``, ``libssl``
- ``liburcu`` - ``liburcu``
- ``libuv`` - ``libuv``
- ``perl`` - ``perl``
- ``pkg-config`` / ``pkgconfig`` / ``pkgconf`` - ``pkg-config`` / ``pkgconfig`` / ``pkgconf``
BIND 9.19 requires ``libuv`` 1.34.0 or higher, using ``libuv`` >= 1.40.0 BIND 9.20 requires ``libuv`` 1.34.0 or higher, using ``libuv`` >= 1.40.0
is recommended. Compiling or running with ``libuv`` 1.35.0 or 1.36.0 is is recommended. Compiling or running with ``libuv`` 1.35.0 or 1.36.0 is
not supported, as this could lead to an assertion failure in the UDP not supported, as this could lead to an assertion failure in the UDP
receive code. On older systems, an updated ``libuv`` package needs to be receive code. On older systems, an updated ``libuv`` package needs to be
@ -96,7 +97,8 @@ Optional Features
To see a full list of configuration options, run ``configure --help``. To see a full list of configuration options, run ``configure --help``.
To improve performance, use of the ``jemalloc`` library To improve performance, use of the ``jemalloc`` library
(http://jemalloc.net/) is strongly recommended. (https://jemalloc.net/) is strongly recommended. Version 4.0.0 or newer is
required when in use.
To support :rfc:`DNS over HTTPS (DoH) <8484>`, the server must be linked To support :rfc:`DNS over HTTPS (DoH) <8484>`, the server must be linked
with ``libnghttp2`` (https://nghttp2.org/). If the library is with ``libnghttp2`` (https://nghttp2.org/). If the library is

View File

@ -132,7 +132,7 @@ def setup(app):
# #
# This file only contains a selection of the most common options. For a full # This file only contains a selection of the most common options. For a full
# list see the documentation: # list see the documentation:
# http://www.sphinx-doc.org/en/master/config # https://www.sphinx-doc.org/en/master/config
# -- Path setup -------------------------------------------------------------- # -- Path setup --------------------------------------------------------------

View File

@ -444,7 +444,7 @@ Notes
.. [#rfc4294] Section 5.1 - DNAME records are fully supported. .. [#rfc4294] Section 5.1 - DNAME records are fully supported.
.. [#rfc7050] RFC 7050 is updated by RFC 8880. .. [#rfc7050] :rfc:`7050` is updated by :rfc:`8880`.
.. [#noencryptedfwd] Forwarding DNS queries over encrypted transports is not .. [#noencryptedfwd] Forwarding DNS queries over encrypted transports is not
supported yet. supported yet.

View File

@ -270,9 +270,7 @@ You'll need to provide the OpenSSL engine name (``pkcs11``) if using the engine
the algorithm (``RSASHA256``). The key is referenced with the PKCS#11 URI scheme and it the algorithm (``RSASHA256``). The key is referenced with the PKCS#11 URI scheme and it
can contain the PKCS#11 token label (we asume that it has been initialized as bind9), can contain the PKCS#11 token label (we asume that it has been initialized as bind9),
and the PKCS#11 object label (called label when generating the keys using ``pkcs11-tool``) and the PKCS#11 object label (called label when generating the keys using ``pkcs11-tool``)
and the HSM PIN. Refer to `RFC7512`_ for the full PKCS#11 URI specification. and the HSM PIN. Refer to :rfc:`7512` for the full PKCS#11 URI specification.
.. _`RFC7512`: https://www.rfc-editor.org/rfc/rfc7512.html
Convert the KSK: Convert the KSK:

View File

@ -102,7 +102,7 @@ These are platforms on which current versions of BIND 9 are known *not* to build
- Platforms without at least OpenSSL 1.0.2 - Platforms without at least OpenSSL 1.0.2
- Windows - Windows
- Solaris 10 and older - Solaris 10 and older
- Platforms that do not support IPv6 Advanced Socket API (RFC 3542) - Platforms that do not support IPv6 Advanced Socket API (:rfc:`3542`)
- Platforms that do not support atomic operations (via compiler or - Platforms that do not support atomic operations (via compiler or
library) library)
- Linux without NPTL (Native POSIX Thread Library) - Linux without NPTL (Native POSIX Thread Library)

View File

@ -1242,7 +1242,7 @@ default is used.
Logged :any:`dnstap` messages can be parsed using the :iscman:`dnstap-read` Logged :any:`dnstap` messages can be parsed using the :iscman:`dnstap-read`
utility (see :ref:`man_dnstap-read` for details). utility (see :ref:`man_dnstap-read` for details).
For more information on :any:`dnstap`, see http://dnstap.info. For more information on :any:`dnstap`, see https://dnstap.info.
The fstrm library has a number of tunables that are exposed in The fstrm library has a number of tunables that are exposed in
:iscman:`named.conf`, and can be modified if necessary to improve :iscman:`named.conf`, and can be modified if necessary to improve
@ -5998,7 +5998,7 @@ The following options can be specified in a :any:`tls` statement:
:short: Enables or disables session resumption through TLS session tickets. :short: Enables or disables session resumption through TLS session tickets.
Enables or disables session resumption through TLS session tickets, Enables or disables session resumption through TLS session tickets,
as defined in RFC5077. Disabling the stateless session tickets as defined in :rfc:`5077`. Disabling the stateless session tickets
might be required in the cases when forward secrecy is needed, might be required in the cases when forward secrecy is needed,
or the TLS certificate and key pair is planned to be used across or the TLS certificate and key pair is planned to be used across
multiple BIND instances. multiple BIND instances.
@ -6068,7 +6068,7 @@ good example of when reconfiguration is necessary is when TLS keys and
certificates are updated on the disk. certificates are updated on the disk.
BIND supports the following TLS authentication mechanisms described in BIND supports the following TLS authentication mechanisms described in
the RFC 9103, Section 9.3: Opportunistic TLS, Strict TLS, and Mutual the :rfc:`9103`, Section 9.3: Opportunistic TLS, Strict TLS, and Mutual
TLS. TLS.
.. _opportunistic-tls: .. _opportunistic-tls:
@ -6076,7 +6076,7 @@ TLS.
Opportunistic TLS provides encryption for data but does not provide Opportunistic TLS provides encryption for data but does not provide
any authentication for the channel. This mode is the default one and any authentication for the channel. This mode is the default one and
it is used whenever :any:`remote-hostname` and :any:`ca-file` options are not set it is used whenever :any:`remote-hostname` and :any:`ca-file` options are not set
in :any:`tls` statements in use. RFC 9103 allows optional fallback to in :any:`tls` statements in use. :rfc:`9103` allows optional fallback to
clear-text DNS in the cases when TLS is not available. Still, BIND clear-text DNS in the cases when TLS is not available. Still, BIND
intentionally does not support that in order to protect from intentionally does not support that in order to protect from
unexpected data leaks due to misconfiguration. Both BIND and its unexpected data leaks due to misconfiguration. Both BIND and its

View File

@ -257,7 +257,7 @@ rely on these name servers. Here is an example that achieves this result:
The ``*`` at the beginning of these CNAME target names is special, and it The ``*`` at the beginning of these CNAME target names is special, and it
causes the original query name to be prepended to the CNAME target. So if a causes the original query name to be prepended to the CNAME target. So if a
user tries to visit the Conficker command and control domain user tries to visit the Conficker command and control domain
http://racaldftn.com.ai/ (which was a valid Conficker command and control `racaldftn.com.ai` (which was a valid Conficker command and control
domain name on 19-October-2011), the RPZ-configured recursive name server domain name on 19-October-2011), the RPZ-configured recursive name server
will send back this answer: will send back this answer:

View File

@ -202,7 +202,7 @@ the packed vector is the popcount of the bits preceding `b`.
} }
See "Hacker's Delight" by Hank Warren, section 5-1 "Counting 1 See "Hacker's Delight" by Hank Warren, section 5-1 "Counting 1
bits", subsection "applications". http://www.hackersdelight.org bits", subsection "applications". https://www.hackersdelight.org
See under _"bitmap popcount shenanigans"_ in `lib/dns/qp.c` for how See under _"bitmap popcount shenanigans"_ in `lib/dns/qp.c` for how
this is implemented in BIND. this is implemented in BIND.
@ -214,8 +214,8 @@ popcount for trie nodes
Phil Bagwell's hashed array-mapped tries (HAMT) use popcount for Phil Bagwell's hashed array-mapped tries (HAMT) use popcount for
compact trie nodes. In a HAMT, string keys are hashed, and the hash is compact trie nodes. In a HAMT, string keys are hashed, and the hash is
used as the index to the trie, with radix 2^32 or 2^64. used as the index to the trie, with radix 2^32 or 2^64.
http://infoscience.epfl.ch/record/64394/files/triesearches.pdf https://infoscience.epfl.ch/record/64394/files/triesearches.pdf
http://infoscience.epfl.ch/record/64398/files/idealhashtrees.pdf https://infoscience.epfl.ch/record/64398/files/idealhashtrees.pdf
As discussed above, increasing the radix makes the tree shallower, so As discussed above, increasing the radix makes the tree shallower, so
it should be faster. The downside is usually much greater memory it should be faster. The downside is usually much greater memory

View File

@ -1231,7 +1231,7 @@ implement a method.
Type values range from 0 to 65536. These have been further divided into Type values range from 0 to 65536. These have been further divided into
reserved values, values that have global definition and values that have reserved values, values that have global definition and values that have
local definition as defined in [RFC 6895](http://tools.ietf.org/html/rfc6895). local definition as defined in [RFC 6895](https://tools.ietf.org/html/rfc6895).
Please use an appropriate value. You can use a private value Please use an appropriate value. You can use a private value
(65280 - 65534) while waiting for a type assignment to be made, then (65280 - 65534) while waiting for a type assignment to be made, then
rename the file and update the type values when the assignment has been rename the file and update the type values when the assignment has been

View File

@ -18,7 +18,7 @@ This document describes various notes related to the using of the libuv library.
### Queueing Events onto the ``uv_loop_t`` ### Queueing Events onto the ``uv_loop_t``
The upstream documentation on [the I/O The upstream documentation on [the I/O
loop](http://docs.libuv.org/en/v1.x/design.html#the-i-o-loop) describes the loop](https://docs.libuv.org/en/v1.x/design.html#the-i-o-loop) describes the
order in which are the various handles processed. However, it does not describe order in which are the various handles processed. However, it does not describe
the order in which the loop processes the events in the same buckets, and the order in which the loop processes the events in the same buckets, and
because it is counterintuitive, it is described here. because it is counterintuitive, it is described here.

View File

@ -16,7 +16,7 @@
# #
# This file only contains a selection of the most common options. For a full # This file only contains a selection of the most common options. For a full
# list see the documentation: # list see the documentation:
# http://www.sphinx-doc.org/en/master/config # https://www.sphinx-doc.org/en/master/config
# -- Path setup -------------------------------------------------------------- # -- Path setup --------------------------------------------------------------