Man Linux: Main Page and Category List

NAME

       dnsget - DNS lookup utility

SYNOPSYS

       dnsget [-v|-q] [-c class] [-t type] [-o option:value] name...

DESCRIPTION

       dnsget  is  a  simple  command-line  to perform DNS lookups, similar to
       host(1) and dig(1).   It  is  useable  for  both  interactive/debugging
       scenarious  and  in  scripts.  The program is implemented using udns(3)
       library.

       By default, dnsget produces a human-readable output, similar to
              alias.example.com. CNAME www.example.com.
              www.example.com. A 192.168.1.1
              www.example.com. MX 10 mx.example.com.
       which is just sufficient to see how  a  given  name  resolves.   Output
       format  is  controllable with -v and -q options -- the former increases
       verbosity level up to printing the whole DNS contents  of  all  packets
       sent  and received, which is suitable for debugging DNS problems, while
       the latter reduces the level, making output  more  quiet,  up  to  bare
       result with no error messages, which is good for scripts.

OPTIONS

       The following options are recognized by dnsget:

       -v     produce more detailed output.  More -v’s means more details will
              be produced.  With single -v,dnsget will print contents  of  all
              received  DNS packets (in a readable format), while with -vv, it
              will output all outgoing DNS packets too.

       -q     the opposite for -v  --  produce  less  detailed  output.   With
              single  -q,dnsget  will  only show (decoded) data from final DNS
              resource records (RR), while -qq also suppresses error messages.

       -t type
              request  record(s)  of  the given type type.  By default, dnsget
              will ask for IPv4 address (A) record, or for PTR record  if  the
              argument  in  question  is  an IPv4 or IPv6 address.  Recognized
              types include A, AAAA, MX, TXT, CNAME, PTR,  NS,  SOA,  ANY  and
              others.

       -c class
              request  DNS  record(s)  of  the  given class class.  By default
              dnsget uses IN class.  Valid classes include IN, CH, HS, ANY.

       -a     (compatibility option).  Equivalent to setting query type to ANY
              and increasing verbosity level (-v).

       -C     (planned)

       -x     (planned)

       -o option:value
              Set  resolver option option to the value value (may be specified
              several times).  The same as  setting  $RES_OPTIONS  environment
              variable.  The following options are recognized:

              timeout:sec
                     Set initial query timeout to sec.

              attempts:num
                     (re)try every query num times before failing.

              udpbuf:bytes
                     set DNS UDP buffer size to bytes bytes.  Valid values are
                     from 512 to 65535.  If bytes is greather than 512,  EDNS0
                     (RFC 2671) extensions will be used.

              port:num
                     Use given UDP port number num instead of the default port
                     53 (domain).

       -n nameserver
              Use the given nameserver(s) (may be specified  more  than  once)
              instead  of  the  default.   Using this option has the same same
              effect as $NSCACHEIP or $NAMESERVERS environment variables, with
              the  only difference that only IPv4 addresses are recognized for
              now, and it is possible to specify names (which will be resolved
              using default settings) instead of IP addresses.

       -h     print short help and exit.

RETURN VALUE

       When  all  names  where  resovled successefully, dnsget exits with zero
       exit status.  If at least one name was not found, dnsget will exit with
       return  code  100.  If some other error occured during name resolution,
       it will exit with code 99.  In case of usage or  initialization  error,
       dnsget will return 1.

SEE ALSO

       host(1) dig(1) resolv.conf(5) udns(3).