named(1M)                                               named(1M)



NAME
     named - provides Internet domain name service

SYNOPSIS
     named [-d debuglevel] [-p port#] [bootfile]

ARGUMENTS
     bootfile
          Specifies the boot file to be read.

     -d debuglevel
          Prints debugging information.  A number after the ``d''
          determines the level of messages printed.

     -p port#
          Uses a different port number.  The default is the
          standard port number as listed in /etc/services.

DESCRIPTION
     named is the Internet domain name server.  Without any
     arguments, named will read the default boot file
     /etc/named.boot, read any initial data, and listen for
     queries.

     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.

EXAMPLES
     The following is a small example:

        ;   boot file for name server
        ;
        ; type       domain      source file or host
        ;
        domain       berkeley.edu
        primary      berkeley.edu    named.db
        secondary  cc.berkeley.edu 10.2.0.78 128.32.0.10
        cache      .               named.ca

     The first line specifies that berkeley.edu is the domain for
     which the server is authoritative.  The second line states
     that the file named.db contains authoritative data for the
     domain berkeley.edu.  The file named.db contains data in the
     master file format described in RFC1034 except that all
     domain names are relative to the origin; in this case,
     berkeley.edu (see below for a more detailed description).
     The second line specifies that all authoritative data under
     cc.berkeley.edu is to be transferred from the name server at
     10.2.0.78.  If the transfer fails it will try 128.32.0.10
     and continue trying the address, up to 10, listed on this
     line.  The secondary copy is also authoritative for the



January 1992                                                    1

named(1M)                                               named(1M)



     specified domain.  The fourth line specifies data in
     named.ca is to be placed in the cache (like 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 consists of entries of the form:

        $INCLUDE <filename>
        $ORIGIN <domain>
        <domain> <opt_ttl> <opt_class> <type> <resource_record_data>

     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)

          CNAME
               the canonical name for an alias (domain)

          HINFO
               host information (cpu_type OS_type)

          MB   a mailbox domain name (domain)

          MG   a mail group member (domain)

          MINFO
               mailbox or mail list information (request_domain
               error_domain)

          MR   a mail rename domain name (domain)

          MX   a mail exchanger (domain)

          NS   an authoritative name server (domain)

          NULL a null resource record (no format or data)

          PTR  a domain name pointer (domain)

          SOA  marks the start of a zone of authority (5 numbers)

          WKS  a well-known service description (not implemented



2                                                    January 1992

named(1M)                                               named(1M)



               yet)

NOTES
     The following signals have the specified effect when sent to
     the server process using the kill(1) command.

     SIGHUP
          Causes server to read named.boot and reload database.

     SIGINT
          Dumps current data base and cache to
          /usr/tmp/named_dump.db

     SIGUSR1
          Turns on debugging; each SIGUSR1 increments debug
          level.

     SIGUSR2
          Turns off debugging completely.

FILES
     /etc/bind/doc
          Directory containing printable versions of RFCs 920,
          974, 1033, 1034, and 1035
     /etc/bind/doc/BOG
          Directory containing sample configuration files
     /etc/named
          Executable file
     /etc/named.boot
          Name server configuration boot file
     /etc/named.pid
          File containing the process ID
     /usr/tmp/named.run
          File containing debug output
     /usr/tmp/named_dump.db
          File containing a dump of the name servers database

SEE ALSO
     kill(1) in A/UX Command Reference

     gethostbyname(3N), signal(3), resolver(3N), resolver(4) in
     A/UX Programmer's Reference













January 1992                                                    3