diff --git a/bin/named/named.8 b/bin/named/named.8 index d6eef1d892..51d464e943 100644 --- a/bin/named/named.8 +++ b/bin/named/named.8 @@ -14,7 +14,7 @@ .\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named.8,v 1.2 2000/06/28 02:51:46 jim Exp $ +.\" $Id: named.8,v 1.3 2000/07/12 02:07:32 gson Exp $ .\" .Dd Jun 30, 2000 .Dt NAMED 8 @@ -39,7 +39,7 @@ is the ISC implementation of an Internet domain name server. See RFCs 1033, 1034, and 1035 for more information on the Internet domain name system. For historical reasons, the ISC's DNS software is known as BIND - -Berkeley Internet Nameserver Distribution - because it was originally +Berkeley Internet Name Daemon - because it was originally supplied with BSD .Ux releases. @@ -61,7 +61,7 @@ More information can be found in .Pp Although some command-line options can be used with .Nm named , -the name server's behaviour is controlled by its configuration file, +the name server's behaviour is mainly controlled by its configuration file, .Pa /etc/named.conf . Refer to the BIND9 Administrator Reference Manual for further details. .Pp @@ -73,7 +73,7 @@ are as follows: use .Ar config-file as the configuration file instead of the default, -.Pa /etc/resolv.conf . +.Pa /etc/named.conf . .It Fl d set the daemon's debug level to .Ar debuglevel . @@ -85,19 +85,21 @@ run .Nm named in the foreground. .It Fl g -also runs the name server in the foreground, but -logs to +run +.Nm named +in the foreground and force all logging to .Dv stderr . .It Fl n -create threads that use +create .Ar #cpus -CPUs if the hardware and software permits this. -When -.Ar #cpus -is set to zero, +worker threads to take advantage of multiple CPUs. +If no option is given, .Nm named -will try to determine the number of CPUs present and use 1 if this -attempt fails. +will try to determine the number of CPUs present and create +one thread per CPU. If +.Nm named +is unable to determine the number of CPUs, a single worker thread +is created. .It Fl p listen for queries on port .Ar port# @@ -106,7 +108,7 @@ instead of the default port number, 53. write memory usage statistics to .Dv stdout on exit. -This option is only of interest +This option is mainly of interest to BIND9 developers and may be removed or changed in a future release. .It Fl t tells @@ -121,11 +123,12 @@ as UID .Ar user-id . .Nm named will change its UID after it has -carried out any privileged operations, such as writing the PID file -or creating a socket that listens on port number 53. +carried out any privileged operations, such as +creating sockets that listen on privileged ports. .It Fl x -load DNS data from +load data from .Ar cache-file . +into the cache of the default view. This option must not be used. It is only of interest to BIND9 developers and may be removed or changed in a future release. @@ -143,15 +146,8 @@ A or .Dv SIGTERM signal can be used to gracefully shut down the server. -With the exception of -.Dv SIGPIPE -which -.Nm named -uses internally, sending any other signals to the name server +Sending any other signals to the name server will have an undefined outcome. -The most likely result will be for the name server to terminate. -It could hang because an internal deadlock was created when the name -server took delivery of the signal. .\".Sh CONFIGURATION FILE FORMAT .\".Nm named 's .\"configuration file is too complex to describe in detail here. diff --git a/doc/man/bin/named.8 b/doc/man/bin/named.8 index d6eef1d892..51d464e943 100644 --- a/doc/man/bin/named.8 +++ b/doc/man/bin/named.8 @@ -14,7 +14,7 @@ .\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named.8,v 1.2 2000/06/28 02:51:46 jim Exp $ +.\" $Id: named.8,v 1.3 2000/07/12 02:07:32 gson Exp $ .\" .Dd Jun 30, 2000 .Dt NAMED 8 @@ -39,7 +39,7 @@ is the ISC implementation of an Internet domain name server. See RFCs 1033, 1034, and 1035 for more information on the Internet domain name system. For historical reasons, the ISC's DNS software is known as BIND - -Berkeley Internet Nameserver Distribution - because it was originally +Berkeley Internet Name Daemon - because it was originally supplied with BSD .Ux releases. @@ -61,7 +61,7 @@ More information can be found in .Pp Although some command-line options can be used with .Nm named , -the name server's behaviour is controlled by its configuration file, +the name server's behaviour is mainly controlled by its configuration file, .Pa /etc/named.conf . Refer to the BIND9 Administrator Reference Manual for further details. .Pp @@ -73,7 +73,7 @@ are as follows: use .Ar config-file as the configuration file instead of the default, -.Pa /etc/resolv.conf . +.Pa /etc/named.conf . .It Fl d set the daemon's debug level to .Ar debuglevel . @@ -85,19 +85,21 @@ run .Nm named in the foreground. .It Fl g -also runs the name server in the foreground, but -logs to +run +.Nm named +in the foreground and force all logging to .Dv stderr . .It Fl n -create threads that use +create .Ar #cpus -CPUs if the hardware and software permits this. -When -.Ar #cpus -is set to zero, +worker threads to take advantage of multiple CPUs. +If no option is given, .Nm named -will try to determine the number of CPUs present and use 1 if this -attempt fails. +will try to determine the number of CPUs present and create +one thread per CPU. If +.Nm named +is unable to determine the number of CPUs, a single worker thread +is created. .It Fl p listen for queries on port .Ar port# @@ -106,7 +108,7 @@ instead of the default port number, 53. write memory usage statistics to .Dv stdout on exit. -This option is only of interest +This option is mainly of interest to BIND9 developers and may be removed or changed in a future release. .It Fl t tells @@ -121,11 +123,12 @@ as UID .Ar user-id . .Nm named will change its UID after it has -carried out any privileged operations, such as writing the PID file -or creating a socket that listens on port number 53. +carried out any privileged operations, such as +creating sockets that listen on privileged ports. .It Fl x -load DNS data from +load data from .Ar cache-file . +into the cache of the default view. This option must not be used. It is only of interest to BIND9 developers and may be removed or changed in a future release. @@ -143,15 +146,8 @@ A or .Dv SIGTERM signal can be used to gracefully shut down the server. -With the exception of -.Dv SIGPIPE -which -.Nm named -uses internally, sending any other signals to the name server +Sending any other signals to the name server will have an undefined outcome. -The most likely result will be for the name server to terminate. -It could hang because an internal deadlock was created when the name -server took delivery of the signal. .\".Sh CONFIGURATION FILE FORMAT .\".Nm named 's .\"configuration file is too complex to describe in detail here.