Provided by: udns-utils_0.4-1build1_amd64 bug

NAME

       dnsget - DNS lookup utility

SYNOPSYS

       dnsget [-v|-q] [-c class] [-t type] [-o opt,opt,...]  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 opt,opt,...
              (may be specified several times).  Set resolver options (in a form option:value) as
              if they were set in $RES_OPTIONS environment variable, or set query flags:

              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).

              aa     set AA (auth only) query bit.

              nord   do not set RD (recursion desired) query bit (set by default).

              dnssec or do
                     set DNSSEC OK (DO) query flag (dnsget does  not  verify  DNSSEC  signatures,
                     only displays them; this is set in EDNS RR).

              cd     set CD (checking disabled) query bit.

       -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).