2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-09-02 15:45:25 +00:00

reviewed and edited

This commit is contained in:
Andreas Gustafsson
2000-07-12 02:07:32 +00:00
parent a6f31a3fd0
commit 52eae74966
2 changed files with 42 additions and 50 deletions

View File

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

View File

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