named(1Mtcp)
named --
Internet domain name server
Synopsis
in.named [ -d debuglevel ]
[ -p port[/local_port] ]
[ -r ]
[[-b] bootfile ]
[ -q ]
Description
named is the Internet domain name server. See
RFCs 1033, 1034 and 1035 for more information on the Internet
domain name system. Without any arguments, named
will read the default boot file /etc/inet/named.boot,
read any initial data and listen for queries.
Options are:
- -d debuglevel
-
Print debugging information. The number specified by debuglevel
determines the level of messages printed.
- -p port[/local_port]
-
Use nonstandard port numbers. The default is the standard port
number as returned by getservbyname for service "domain".
The argument can specify two port numbers separated by a slash (/)
in which case the first port is that used when contacting remote
servers.
The second, local_port, is the service port bound by the local
instance of named. This is primarily used for debugging.
- -r
-
Turns recursion off in the server. Answers can come only from local
(primary or secondary) zones. This can be used on root servers.
Note that this option is deprecated in favor of the boot file directive
options no-recursion.
- -b
-
Use an alternative boot file. This is optional and allows
you to specify a file with a leading dash.
- -q
-
Trace all incoming queries.
Note that this option is deprecated in favor of the boot file directive
options query-log.
Any additional argument is taken as the name of the boot file.
If multiple boot files are specified, only the last is used.
See
named.boot(4tcp)
for more information about the format of the boot file.
Signals
The following signals have the specified effect when sent
to the named process using the
kill(1)
command.
The process ID of the named process may
be discovered from the contents on the /etc/named.pid file.
- SIGABRT
-
Appends statistics data to /var/tmp/named.stats.
- SIGHUP
-
Causes server to read named.boot, reload the database, and
check the serial number on all secondary zones.
Normally the serial numbers are only checked at
the SOA-specified intervals.
- SIGINT
-
Dumps current database and cache to /var/tmp/named_dump.db.
- SIGSYS
-
Dumps profiling data in /var/tmp.
- SIGTERM
-
Dumps the primary and secondary database files.
Used to save modified data on shutdown if the
server is compiled with dynamic updating enabled.
- SIGUSR1
-
Turns on debugging; each SIGUSR1 increments the debug level.
- SIGUSR2
-
Turns off debugging completely.
- SIGWINCH
-
Toggles logging of all incoming queries via
syslog(3G).
Files
- /etc/inet/named.boot
-
name server configuration boot file
- /etc/named.pid
-
process ID of named
- /var/tmp/named.run
-
debug output
- /var/tmp/named_dump.db
-
dump of the name server database
- /var/tmp/named.stats
-
name server statistics data
References
gethostbyname(3N),
hostname(1bsd),
kill(1),
named.boot(4tcp),
named.hosts(4tcp),
named.local(4tcp),
named.rev(4tcp),
named.soa(4tcp),
resolver(3N),
resolv.conf(4tcp),
root.cache(4tcp),
signal(2),
RFC 974,
RFC 1032,
RFC 1033,
RFC 1034,
RFC 1035,
RFC 1123
Notices
The boot file directives domain and suffixes have
been made obsolete by a more useful resolver-based
implementation of suffixing for partially qualified domain names.
The prior mechanisms could fail under a number of
situations, especially when the local name server did not
have complete information.
The restart and start directives to ndc
do not preserve any arguments previously supplied to named.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.