NAMED(8,C) AIX TCP/IP User's Guide NAMED(8,C) ------------------------------------------------------------------------------- named PURPOSE Provides the server function for the Domain Name Protocol. SYNTAX +--------------+ +---------------------+ /etc/named ---| +----------+ |---| +------+ |---| +-| -d level |-+ +-| |- bootfile -+ ^| -p port || +- -b -+ |+----------+| +------------+ DESCRIPTION The named command is the Internet domain name server (refer to Domain Names - Implementation and Specification, RFC883, for more details.) Without any arguments, the named command reads the default boot file /etc/named.boot, reads any initial data and listens for queries. FLAGS The named command options are: -b Specifies that the next argument is the name of the boot file. If the boot file name is the last argument on the command line, the -b may be omitted. -d Prints debugging information. A number after the -d determines the level of messages printed. -p Uses a different port number. The default is the standard port number as listed in /etc/services (see "rc.tcpip, rc.tcpip.local"). EXAMPLES Any additional argument is taken as the name of the boot file. The boot file contains information about where the name server is to get its initial data. The following is a short example: Processed October 29, 1990 NAMED(8,C) 1 NAMED(8,C) AIX TCP/IP User's Guide NAMED(8,C) ; ; boot file for name server ; ; type domain source file or host ; domain server1 primary server1 named.db secondary cc.server1 10.2.0.78 128.32.0.10 cache named.ca Processed October 29, 1990 NAMED(8,C) 2 NAMED(8,C) AIX TCP/IP User's Guide NAMED(8,C) o The first line specifies that "server1" is the domain for which the server is authoritative. o The second line states that the file "named.db" contains authoritative data for the domain "server1". The file "named.db" contains data in the master file format described in RFC883 except that all domain names are relative to the origin. In this case, "server1" (see below for a more detailed description). o The third line specifies that all authoritative data under "cc.server1" is to be transferred from the name server at 10.2.0.78. If the transfer fails, it tries 128.32.0.10 and continues trying the addresses, up to 10, listed on this line. The secondary copy is also authoritative for the specified domain. o The fourth line specifies data in "named.ca" is to be placed in the cache (well known data such as locations of root domain servers). The file named.ca is in the same format as "named.db". The master file, "named.db" in the example above, consists of entries such as: $INCLUDE $ORIGIN where domain is . for root, @ for the current origin, or a standard domain name. If domain is a standard domain name that does not end with ., the current origin is appended to the domain. Domain names ending with . are unmodified. The opt_ttl field is an optional integer number for the time-to-live field. It defaults to zero. The opt_class field is the object address type; currently only one type is supported, IN, for objects connected to the DARPA Internet. The type field is one of the following tokens; the data expected in the resource_record_data field is in parentheses. A A host address (dotted quad) NS An authoritative name server (domain) MX A mail exchanger (domain) CNAME The canonical name for an alias (domain) SOA Marks the start of a zone of authority (5 numbers (see RFC883)) MB A mailbox domain name (domain) MG A mail group member (domain) MR A mail rename domain name (domain) NULL A null resource record (no format or data) WKS A well know service description (not implemented yet) PTR A domain name pointer (domain) HINFO Host information (cpu_type OS_type) MINFO Mailbox or mail list information (request_domain error_domain) Note: The following signals have the specified effect when sent to the server process using the kill command. Processed October 29, 1990 NAMED(8,C) 3 NAMED(8,C) AIX TCP/IP User's Guide NAMED(8,C) SIGHUP Causes server to read /etc/named.boot and reload database. SIGINT Dumps current data base and cache to /tmp/named_dump.db SIGUSR1 Turns on debugging; each SIGUSR1 increments debug level. SIGUSR2 Turns off debugging completely. FILES /etc/named.boot Name server configuration boot file /etc/named.pid The process ID /tmp/named.run Debug output /tmp/named_dump.db Dump of the name servers database RELATED INFORMATION In this book: "resolv.conf" kill, gethostbyname, refer to AIX Operating System Technical Reference signal, refer to AIX Operating System Technical Reference Processed October 29, 1990 NAMED(8,C) 4