mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-08-29 05:28:00 +00:00
reviewed and edited
This commit is contained in:
Andreas Gustafsson
parent
a6f31a3fd0
commit
52eae74966
@ -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.
|
||||
|
||||
@ -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.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user