bind9/doc
Michał Kępień d6f9785ac6
Enable extraction of exact local socket addresses
Extracting the exact address that each wildcard/TCP socket is bound to
locally requires issuing the getsockname() system call, which libuv
exposes via its uv_*_getsockname() functions.  This is only required for
detailed logging and comes at a noticeable performance cost, so it
should not happen by default.  However, it is useful for debugging
certain problems (e.g. cryptic system test failures), so a convenient
way of enabling that behavior should exist.

Update isc_nmhandle_localaddr() so that it calls uv_*_getsockname() when
the ISC_SOCKET_DETAILS preprocessor macro is set at compile time.
Ensure proper handling of sockets that wrap other sockets.

Set the new ISC_SOCKET_DETAILS macro by default when --enable-developer
is passed to ./configure.  This enables detailed logging in the system
tests run in GitLab CI without affecting performance in non-development
BIND 9 builds.

Note that setting the ISC_SOCKET_DETAILS preprocessor macro at compile
time enables all callers of isc_nmhandle_localaddr() to extract the
exact address of a given local socket, which results e.g. in dnstap
captures containing more accurate information.

Mention the new preprocessor macro in the section of the ARM that
discusses why exact socket addresses may not be logged by default.
2024-12-29 12:32:05 +01:00
..
arm Enable extraction of exact local socket addresses 2024-12-29 12:32:05 +01:00
changelog Fix Sphinx build failures on generated changelog for BIND 9.21.3 2024-12-02 15:15:53 +01:00
design Remove DLV remnants 2024-12-13 11:24:47 +01:00
dev Remove C++ support from the public header 2024-12-18 13:10:39 +01:00
dnssec-guide Unify parental-agents, primaries to remote-servers 2024-12-13 08:50:02 +01:00
doxygen Remove trailing whitespace from all text files 2023-06-13 15:05:40 +02:00
man Update documentation for 9.20.0 2024-07-08 14:53:01 +02:00
misc Rename remote-servers standard term to server-list 2024-12-13 08:50:02 +01:00
notes Add missing copyright header to Release Notes 2024-12-03 10:43:11 +01:00
Makefile.am Remove pregenerated manpages from the repo 2023-02-10 11:24:03 +01:00