Commands Reference, Volume 4

named Daemon

Purpose

Provides the server function for the Domain Name Protocol.

Syntax

/usr/sbin/named [ -d DebugLevel ] [ -p PortNumber ] [ -b BootFile ]

Description

The /usr/sbin/named daemon is the server for the Domain Name Protocol (DOMAIN). The named daemon runs on name-server hosts and controls the domain-name resolution function.

Note: The named daemon can be controlled using the System Resource Controller (SRC) or the System Management Interface Tool (SMIT). Use the rc.tcpip file to start the daemon with each system startup.

The named daemon listens for name-server requests generated by resolver routines running on foreign hosts. The daemon listens to the socket defined in the /etc/services file; the entry in the /etc/services file begins with domain. However, this socket assignment can be overridden using the -p flag on the command line.

Note: The /etc/resolv.conf file tells the local kernel and resolver routines to use the DOMAIN protocol. The /etc/resolv.conf file must exist and contain either the local host's address or the loopback address (127.0.0.1), or be empty to use the named daemon on the DOMAIN name server host. If the /etc/resolv.conf file does not exist, the local kernel and resolver routines use the /etc/hosts database. When this occurs, the named daemon does not function properly.

Manipulating the named Daemon with the System Resource Controller

The named daemon is a subsystem controlled by the System Resource Controller (SRC). The named daemon is a member of the tcpip system group. This daemon is disabled by default and can be manipulated by the following SRC commands:

startsrc	Starts a subsystem, group of subsystems, or a subserver.
stopsrc	Stops a subsystem, group of subsystems, or a subserver.
refresh	Causes the named daemon to reread the /etc./named.boot file. Depending on the contents of the file, the refresh command may or may not reload the database.
traceson	Enables tracing of a subsystem, group of subsystems, or a subserver.
tracesoff	Disables tracing of a subsystem, group of subsystems, or a subserver.
lssrc	Gets the status of a subsystem, group of subsystems, or a subserver.

Flags

-b BootFile	Specifies an alternate boot file.
-d DebugLevel	Provides a debugging option. The -d flag causes the named daemon to write debugging information to a file named /var/tmp/named.run. The DebugLevel variable determines the level of messages printed, with valid levels from 1 to 11, where level 11 supplies the most information.
-p PortNumber	Reassigns the Internet socket where the named daemon listens for DOMAIN requests. If this variable is not specified, the named daemon listens to the socket defined in the /etc/services file; the entry in the /etc/services file begins with `domain`.

Signals

The following signals have the specified effect when sent to the named daemon process using the kill command:

SIGHUP	The named daemon rereads the /etc/named.boot file. Depending on the contents of the file, the SIGHUP signal may or may not reload the database.
SIGINT	The named daemon dumps the current database to a file named /var/tmp/named_dump.db. In the dump file, names with the label name error indicate negative cache entries. This happens when a server responds that the specified domain name does not exist. Names labeled as data error also indicate negative cache entries. This happens when a server responds that there are no records of the specified type for the (valid) domain name.
SIGUSR1	The named daemon turns on debugging; each subsequent SIGUSR1 signal increments the debugging level. The debugging information is written to the /var/tmp/named.run file.
SIGUSR2	The named daemon turns off debugging.
SIGABRT/SIGIOT	The named daemon dumps the current statistics to the /var/tmp/named.stat file.

Examples

To start the named daemon normally, enter the following:
```
startsrc -s named
```
This command starts the daemon. You can use this command in the rc.tcpip file or on the command line. The -s flag specifies that the subsystem that follows is to be started. The process ID of the named daemon is stored in the /etc/named.pid file upon startup.
To stop the named daemon normally, enter:
```
stopsrc -s named
```
This command stops the daemon. The -s flag specifies that the subsystem that follows is to be stopped.
To get short status from the named daemon, enter:
```
lssrc -s named
```
This command returns the name of the daemon, the process ID of the daemon, and the state of the daemon (active or inactive).
To enable debugging for the named daemon, enter:
```
traceson -s named
```
OR
```
kill -30 'cat /etc/named.pid'
```
The named daemon turns on debugging in response to either of these commands; each subsequent command increments the debugging level. The debugging information is written to the /var/tmp/named.run file.
To turn off debugging for the named daemon, enter:
```
tracesoff
```
OR
```
kill -35 'cat /etc/named.pid'
```
Either of these commands immediately turns off all debugging.
To start the named daemon at the highest debugging level using the startsrc command, enter the following:
```
startsrc -s named -a "-d 11"
```
This command writes debugging messages to the /var/tmp/named.run file.
To view the contents of the DHCP Server database files /etc/dhcpsd.ar and /etc/dhcpsd.cr, enter:
```
lssrc -l -s dhcpsd
```

Files

/usr/sbin/named	Contains the named daemon.
/etc/resolv.conf	Specifies the use of domain name services.
/etc/rc.tcpip	Initializes daemons at each system restart.
/etc/named.pid	Stores process IDs.
/etc/services	Defines socket service assignments.
/usr/samples/tcpip/named.boot	Contains the sample named.boot file with directions for its use.
/usr/samples/tcpip/named.data	Contains the sample DOMAIN data file with directions for its use.
/usr/samples/tcpip/hosts.awk	Contains the sample awk script for converting an /etc/hosts file to an /etc/named.data file. This file also contains directions for its use.
/usr/samples/tcpip/addrs.awk	Contains the sample awk script for converting an /etc/hosts file to an /etc/named.rev file. This file also contains directions for its use.
/usr/samples/tcpip/named.dynamic	Contains a dynamic database setup.

Related Information

The nslookup command, traceroute command, kill command.

The named.conf file format, DOMAIN Cache file format, DOMAIN Data file format, DOMAIN Reverse Data file format, DOMAIN Local Data file format, resolv.conf file format.

TCP/IP Name Resolution and TCP/IP Daemons in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

Configuring Name Servers and Planning for DOMAIN Name Resolution in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.