Fix the description of named's -n option

Since the advent of netmgr, named no longer creates a single thread per
CPU, but rather a set of two threads per CPU.  Update the man page for
named accordingly to prevent confusion.

diff --git a/bin/named/named.rst b/bin/named/named.rst
index 818a896c8dcf98efcb6f49b78d153df1a934d160..934e5726ed83240f793d3361c944dd33d2b6d26c 100644 (file)
--- a/bin/named/named.rst
+++ b/bin/named/named.rst
@@ -111,10 +111,15 @@ Options
    ``ISC_MEM_DEBUGXXXX`` flags described in ``<isc/mem.h>``.
 
 ``-n #cpus``
-   This option creates ``#cpus`` worker threads to take advantage of multiple CPUs. If
-   not specified, ``named`` tries to determine the number of CPUs
-   present and creates one thread per CPU. If it is unable to determine
-   the number of CPUs, a single worker thread is created.
+   This option controls the number of CPUs that ``named`` assumes the
+   presence of. If not specified, ``named`` tries to determine the
+   number of CPUs present automatically; if it fails, a single CPU is
+   assumed to be present.
+
+   ``named`` creates two threads per each CPU present (one thread for
+   receiving and sending client traffic and another thread for sending
+   and receiving resolver traffic) and then on top of that a single
+   thread for handling time-based events.
 
 ``-p port``
    This option listens for queries on ``port``. If not specified, the default is

diff --git a/doc/man/named.8in b/doc/man/named.8in
index 51e121bd8161655cb43c3e0ef6761cc1c469cfbe..b3e2ea679d3da7b0b19fbbda35dbd507528f5fdf 100644 (file)
--- a/doc/man/named.8in
+++ b/doc/man/named.8in
@@ -133,10 +133,15 @@ This option turns on memory usage debugging flags. Possible flags are \fBusage\f
 \fBISC_MEM_DEBUGXXXX\fP flags described in \fB<isc/mem.h>\fP\&.
 .TP
 .B \fB\-n #cpus\fP
-This option creates \fB#cpus\fP worker threads to take advantage of multiple CPUs. If
-not specified, \fBnamed\fP tries to determine the number of CPUs
-present and creates one thread per CPU. If it is unable to determine
-the number of CPUs, a single worker thread is created.
+This option controls the number of CPUs that \fBnamed\fP assumes the
+presence of. If not specified, \fBnamed\fP tries to determine the
+number of CPUs present automatically; if it fails, a single CPU is
+assumed to be present.
+.sp
+\fBnamed\fP creates two threads per each CPU present (one thread for
+receiving and sending client traffic and another thread for sending
+and receiving resolver traffic) and then on top of that a single
+thread for handling time\-based events.
 .TP
 .B \fB\-p port\fP
 This option listens for queries on \fBport\fP\&. If not specified, the default is