admresolve(1M)                 DG/UX R4.11MU05                admresolve(1M)


NAME
       admresolve - manage DNS resolver's domain name and nameservers
       database

SYNOPSIS
       admresolve -o set domain-name

       admresolve -o get [ -qv ]

       admresolve -o add nameserver

       admresolve -o delete nameserver ...

       admresolve -o modify -n new-nameserver nameserver

       admresolve -o list [ -qv ] nameserver ...

DESCRIPTION
       admresolve manages parameters for the resolver(3C) including the
       domain name and the nameservers database.  The nameservers database
       consists of up to a maximum of three nameservers.  Each nameserver
       entry consists of the hostname or Internet address of the nameserver.

   Operations
       set       Set the DNS domain name for the resolver.

       get       Get the DNS domain name for the resolver.

       add       Add a new nameserver to the resolver's DNS nameservers
                 database.

       delete    Delete one or more nameservers from the resolver's DNS
                 nameservers database.

       modify    Modify a nameserver from the resolver's DNS nameservers
                 database.

       list      List one or more nameservers from the resolver's DNS
                 nameservers database.

   Options
       -n new-nameserver
                 new-nameserver is the new nameserver that replaces
                 nameserver in the modify operation.

       -q        "Quiet."  Produce an unformatted listing (i.e. no headers,
                 fields delimited by a single space).

       -v        "Verbose."  Produce a formatted listing with headers and
                 aligned columns.  This is enabled by default.

       admresolve expects all Internet addresses of the form

            a.b.c.d,

       where a is a decimal number between 0 and 224, and b, c, and d are
       decimal numbers between 0 and 255.

FILES
       /etc/resolv.conf
                 DNS resolver file.

OUTPUT
       The list operation writes its output to stdout.  The verbose form of
       the list operation outputs information in aligned columns with column
       headers.  If -q option is specified with the list operation, headers
       are suppressed and each nameserver is printed on a separate line.

DIAGNOSTICS
   Warnings
        -  The delete operation is requested,  and nameserver does not
           exist.

        -  The get operation is requested, and domain name is not set.

   Errors
        -  The add operation is requested, and the nameserver already
           exists.

        -  The add operation is requested, and the maximum number of
           nameservers already exist.

        -  The modify operation is requested, and the nameserver does not
           exist.

        -  The modify operation is requested, and the new-nameserver already
           exists.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.  does not exist.

NOTES
       Access to the set, add, delete, and modify operations is based on
       write access on the /etc/resolv.conf file.  Generally only the system
       administrator has write access.  Access to the get and  list
       operations is based on the read access on the /etc/resolv.conf file.
       Generally, all users have read access.

SEE ALSO
       resolver(3C), resolv.conf(4M).


Licensed material--property of copyright holder(s)