upstream/bind9
1
0
Fork 0
mirror of https://github.com/isc-projects/bind9.git synced 2026-05-28 04:34:54 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Properly document -U <n> option to named

Browse source 
In the past, before the netmgr, the `-U <n>` option to `named`
configured number of listening dispatches for UDP per-interface.

Since 9.16, it only affects the number of outgoing UDP dispatches.
Properly document that in the `named` man page.
This commit is contained in:
Ondřej Surý 2024-04-24 14:21:17 +02:00
parent 13e9655936
commit 78d92a2a93
No known key found for this signature in database
GPG key ID: 2820F37E873DEA41
1 changed files with 15 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
bin/named/named.rst
View file

@ -171,16 +171,22 @@ Options
most systems; the way ``chroot`` is defined allows a process
with root privileges to escape a chroot jail.
.. option:: -U #listeners
.. option:: -U #dispatches
This option tells :program:`named` the number of ``#listeners`` worker threads to listen on, for incoming UDP packets on
each address. If not specified, :program:`named` calculates a default
value based on the number of detected CPUs: 1 for 1 CPU, and the
number of detected CPUs minus one for machines with more than 1 CPU.
This cannot be increased to a value higher than the number of CPUs.
If :option:`-n` has been set to a higher value than the number of detected
CPUs, then :option:`-U` may be increased as high as that value, but no
higher.
This option specifies the number of per-interface UDP ``#dispatches`` that :program:`named` should use to handle the outgoing (recursive) UDP connection,
to reduce contention between the resolver threads.
If not specified, :program:`named` calculates a default value based on the
number of detected CPUs: 1 for a single CPU, and the number of detected CPUs minus
one for machines with more than 1 CPU.
This cannot be increased to a value higher than the number of CPUs
(see :option:`-n` on how to override the value).
.. warning::
This option should be unnecessary for the vast majority of users,
and will be removed in the next version of BIND 9.
.. option:: -u user