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.