Merge branch '2784-improve-descriptions-of-buffering-related-options' into 'main'

Improve descriptions of buffering-related options

Closes #2784

See merge request isc-projects/bind9!5215
This commit is contained in:
Michał Kępień
2021-06-22 20:31:59 +00:00

View File

@@ -3610,27 +3610,29 @@ Tuning
milliseconds to prefer IPv6 name servers. The default is ``50``
milliseconds.
``tcp-recv-buffer``; ``udp-recv-buffer``
``tcp-receive-buffer``; ``udp-receive-buffer``
These options control the operating system's receive buffer sizes
(``SO_RCVBUF``) for TCP and UDP sockets respectively. Buffering at
(``SO_RCVBUF``) for TCP and UDP sockets, respectively. Buffering at
the operating system level can prevent packet drops during brief load
spikes, but if the value is set too high, it could clog a running server
with outstanding queries that have already timed out. The default is
``0``, which means the operating system's default value should be used.
The minimum configurable value is ``4096``; any nonzero value lower than
that will be silently raised. The maximum value is determined by the
kernel, and values exceeding the maximum will be silently reduced.
spikes, but if the buffer size is set too high, a running server
could get clogged with outstanding queries that have already timed
out. The default is ``0``, which means the operating system's default
value should be used. The minimum configurable value is ``4096``; any
nonzero value lower than that is silently raised. The maximum value
is determined by the kernel, and values exceeding the maximum are
silently reduced.
``tcp-send-buffer``; ``udp-send-buffer``
These options control the operating system's send buffer sizes
(``SO_SNDBUF``) for TCP and UDP sockets respectively. Buffering at the
operating system level can prevent packet drops during brief load
spikes, but if the value is set too high, it could clog a running server
with outstanding queries that have already timed out. The default is
``0``, which means the operating system's default value should be used.
The minimum configurable value is ``4096``; any nonzero value lower than
that will be silently raised. The maximum value is determined by the
kernel, and values exceeding the maximum will be silently reduced.
(``SO_SNDBUF``) for TCP and UDP sockets, respectively. Buffering at
the operating system level can prevent packet drops during brief load
spikes, but if the buffer size is set too high, a running server
could get clogged with outstanding queries that have already timed
out. The default is ``0``, which means the operating system's default
value should be used. The minimum configurable value is ``4096``; any
nonzero value lower than that is silently raised. The maximum value
is determined by the kernel, and values exceeding the maximum are
silently reduced.
.. _builtin: