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:
@@ -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:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user