named.8 3.75 KB
Newer Older
1
.\" Copyright (C) 2000  Internet Software Consortium.
2
.\"
3
.\" Permission to use, copy, modify, and distribute this software for any
4
5
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
6
.\"
7
8
9
10
11
12
13
14
.\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
.\" DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
.\" INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15
.\"
16
.\" $Id: named.8,v 1.7 2000/08/15 20:19:36 gson Exp $
17
.\"
18
19
20
21
22
23
.Dd Jun 30, 2000
.Dt NAMED 8
.Os BIND9 9
.ds vT BIND9 Programmer's Manual
.Sh NAME
.Nm named
Andreas Gustafsson's avatar
Andreas Gustafsson committed
24
.Nd Internet domain name server
25
26
27
28
29
30
31
32
33
34
35
36
.Sh SYNOPSIS
.Nm named
.Op Fl c Ar config-file
.Op Fl d Ar debuglevel
.Op Fl f g s
.Op Fl n Ar #cpus
.Op Fl p Ar port#
.Op Fl t Ar directory
.Op Fl u Ar user-id
.Op Fl x Ar cache-file
.Sh DESCRIPTION
.Nm named
Andreas Gustafsson's avatar
Andreas Gustafsson committed
37
38
is a Domain Name System (DNS) server, part of the BIND 9 distribution
from ISC.  For more information on the DNS, see RFCs 1033, 1034, and 1035.
39
.Pp
Andreas Gustafsson's avatar
Andreas Gustafsson committed
40
When invoked without arguments,
41
42
43
44
45
46
47
48
49
50
51
52
53
.Nm named
will read the default configuration file
.Pa /etc/named.conf ,
read any initial data, and listen for queries.
.Pp
The options to
.Nm named
are as follows:
.Bl -tag -width Ds
.It Fl c
use
.Ar config-file
as the configuration file instead of the default,
Andreas Gustafsson's avatar
Andreas Gustafsson committed
54
.Pa /etc/named.conf .
55
56
57
58
59
60
61
62
63
64
65
.It Fl d
set the daemon's debug level to
.Ar debuglevel .
Debugging traces from
.Nm named
become more verbose as the debug level increases.
.It Fl f
run
.Nm named
in the foreground.
.It Fl g
Andreas Gustafsson's avatar
Andreas Gustafsson committed
66
67
68
run
.Nm named
in the foreground and force all logging to
69
70
.Dv stderr .
.It Fl n
71
create
72
.Ar #cpus
Andreas Gustafsson's avatar
Andreas Gustafsson committed
73
74
75
76
77
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 create
one thread per CPU.  If
78
.Nm named
Andreas Gustafsson's avatar
Andreas Gustafsson committed
79
80
is unable to determine the number of CPUs, a single worker thread
is created.
81
82
83
84
85
86
87
88
.It Fl p
listen for queries on  port
.Ar port#
instead of the default port number, 53.
.It Fl s
write memory usage statistics to
.Dv stdout
on exit.
Andreas Gustafsson's avatar
Andreas Gustafsson committed
89
This option is mainly of interest
90
91
92
93
94
95
96
97
98
99
100
101
102
103
to BIND9 developers and may be removed or changed in a future release.
.It Fl t
tells
.Nm named
to chroot() to
.Ar directory
immediately after reading its config file.
.It Fl u
run
.Nm named
as UID
.Ar user-id .
.Nm named
will change its UID after it has
104
carried out any privileged operations, such as
Andreas Gustafsson's avatar
Andreas Gustafsson committed
105
creating sockets that listen on privileged ports.
106
.It Fl x
Andreas Gustafsson's avatar
Andreas Gustafsson committed
107
load data from
108
.Ar cache-file .
Andreas Gustafsson's avatar
Andreas Gustafsson committed
109
into the cache of the default view.
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
This option must not be used.
It is only of interest
to BIND9 developers and may be removed or changed in a future release.
.El
.Sh SIGNALS
In routine operation, signals should not be used to \*qcontrol\*q the
name server.
.Nm rndc
should be used instead.
Sending the name server a
.Dv SIGHUP
signal forces a reload of the server.
A
.Dv SIGINT
or
.Dv SIGTERM
signal can be used to gracefully shut down the server.
Andreas Gustafsson's avatar
Andreas Gustafsson committed
127
Sending any other signals to the name server
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
will have an undefined outcome.
.\".Sh CONFIGURATION FILE FORMAT
.\".Nm named 's
.\"configuration file is too complex to describe in detail here.
.\"A complete description is provided in the BIND9 Administrator
.\"Reference Manual.
.Sh FILES
.Bl -tag -width  /var/run/named.pid -compact
.It Pa /etc/named.conf
default configuration file
.It Pa /var/run/named.pid
default process-id file
.El
.Sh SEE ALSO
.Xr RFC1033 ,
.Xr RFC1034 ,
.Xr RFC1035 ,
.Xr rndc 8 ,
.Xr lwresd 8 ,
BIND9 Administrator Reference Manual, June 2000.