dnsquery(1M) — Reliant UNIX 5.44c4

dnsquery(1M)                                                   dnsquery(1M)

NAME
     dnsquery - query domain name servers using resolver(3N)

SYNOPSIS
     dnsquery [-n nameserver] [-t type] [-c class] [-r retry]
              [-p retryperiod] [-d] [-s] [-v] host

DESCRIPTION
     The dnsquery program is a general interface to name servers via BIND
     resolver(3N) library calls. The program supports queries to the name
     server. All arguments except for host and nameserver are treated
     without case-sensitivity.

OPTIONS
     -n   The name server to be used in the query. Name servers can appear
          as either Internet addresses of the form w.x.y.z or can appear as
          domain names (default: as specified in /etc/resolv.conf).

     -t   The type of resource record of interest. Types include:

          A         address
          NS        name server
          CNAME     canonical name
          PTR       domain name pointer
          SOA       start of authority
          WKS       well-known service
          HINFO     host information
          MINFO     mailbox information
          MX        mail exchange
          RP        responsible person
          MG        mail group member
          AFSDB     DCE or AFS server
          ANY       wildcard

          Note that any case may be used (default: ANY).

     -c   The class of resource records of interest. Classes include:

          IN        Internet
          HS        Hesiod
          CHAOS     Chaos
          ANY       wildcard

          Note that any case may be used (default: IN).

     -r   The number of times to retry if the name server is not responding
          (default: 4).

     -p   Period to wait before timing out (default: RESTIMEOUT).

     -d   Turn on debugging. This sets the RESDEBUG bit of the resolver's
          options field (default: no debugging).



Page 1                       Reliant UNIX 5.44                Printed 11/98

dnsquery(1M)                                                   dnsquery(1M)

     -s   Use a stream rather than a packet. This uses a TCP stream connec-
          tion with the name server rather than a UDP datagram. This sets
          the RESUSEVC bit of the resolver's options field (default: UDP).

     -v   Synonym for the -s flag.

     host The name of the host (or domain) of interest.

DIAGNOSTICS
     If the resolver fails to answer the query and debugging has not been
     turned on, dnsquery will simply print a message like:

          Query failed (rc = 1) : Unknown host

     The value of the return code is supplied by herrno.

NOTES
     Queries of a class other than IN can have unexpected results since
     ordinarily a name server only has a list of root name servers for
     class IN resource records.

FILES
     /etc/resolv.conf
          to get the default name server and search lists

     /usr/include/arpa/nameser.h
          list of usable resource records types and classes

     /usr/include/resolv.h
          list of resolver flags

     /usr/lib/named/bog.ascii
     /usr/lib/named/bog.ps
          Name Server Operations Guide for BIND ("BOG"); ASCII and
          PostScript format

SEE ALSO
     named(1M), resolver(3N), resolv.conf(4).
















Page 2                       Reliant UNIX 5.44                Printed 11/98

Museum

Related Articles