| .TH ADIG "1" "April 2011" "c-ares utilities" |
| .SH NAME |
| adig \- print information collected from Domain Name System (DNS) servers |
| .SH SYNOPSIS |
| .B adig |
| [\fIOPTION\fR]... \fINAME\fR... |
| .SH DESCRIPTION |
| .PP |
| .\" Add any additional description here |
| .PP |
| Send queries to DNS servers about \fINAME\fR and print received |
| information, where \fINAME\fR is a valid DNS name (e.g. www.example.com, |
| 1.2.3.10.in-addr.arpa). |
| .PP |
| This utility comes with the \fBc\-ares\fR asynchronous resolver library. |
| .SH OPTIONS |
| .TP |
| \fB\-c\fR class |
| Set the query class. |
| Possible values for class are |
| ANY, CHAOS, HS and IN (default). |
| .TP |
| \fB\-d\fR |
| Print some extra debugging output. |
| .TP |
| \fB\-f\fR flag |
| Add a behavior control flag. |
| Possible values for flag are |
| igntc - ignore to query in TCP to get truncated UDP answer, |
| noaliases - don't honor the HOSTALIASES environment variable, |
| norecurse - don't query upstream servers recursively, |
| primary - use the first server, |
| stayopen - don't close the communication sockets, and |
| usevc - always use TCP. |
| .TP |
| \fB\-h\fR, \fB\-?\fR |
| Display this help and exit. |
| .TP |
| \fB\-s\fR server |
| Connect to specified DNS server, instead of the system's default one(s). |
| Servers are tried in round-robin, if the previous one failed. |
| .TP |
| \fB\-t\fR type |
| Query records of specified type. |
| Possible values for type are |
| A (default), AAAA, AFSDB, ANY, AXFR, CNAME, GPOS, HINFO, ISDN, KEY, LOC, MAILA, |
| MAILB, MB, MD, MF, MG, MINFO, MR, MX, NAPTR, NS, NSAP, NSAP_PTR, NULL, |
| PTR, PX, RP, RT, SIG, SOA, SRV, TXT, URI, WKS and X25. |
| .TP |
| \fB\-T\fR port |
| Connect to the specified TCP port of DNS server. |
| .TP |
| \fB\-U\fR port |
| Connect to the specified UDP port of DNS server. |
| .TP |
| \fB\-x\fR |
| For an IPv4 \fB-t PTR a.b.c.d\fR lookup, query for |
| .br |
| \fBd.c.b.a.in-addr.arpa.\fR |
| This more often gives correct names in the \fBANSWER\fR. |
| .br |
| For an IPv6 \fB-t PTR addr\fR lookup, query for \fBa.b.c....z.IP6.ARPA.\fR |
| .TP |
| \fB\-xx\fR |
| As for \fB-x\fR and an IPv6 address, compact \fBa.b.c....z.IP6.ARPA.\fR into a RFC-2673 bit-string. |
| This compacted \fBbit-string\fR form is not supported by many DNS-servers. |
| |
| .SH "REPORTING BUGS" |
| Report bugs to the c-ares mailing list: |
| .br |
| \fBhttps://lists.haxx.se/listinfo/c-ares\fR |
| .SH "SEE ALSO" |
| .PP |
| acountry(1), ahost(1). |
| .SH COPYRIGHT |
| This utility is based on code/ideas contained in sofware written by Greg Hudson (ares) |
| carrying the following notice: |
| .br |
| Copyright 1998 by the Massachusetts Institute of Technology. |
| .br |
| Permission to use, copy, modify, and distribute this software and its |
| documentation for any purpose and without fee is hereby granted, |
| provided that the above copyright notice appear in all copies and that |
| both that copyright notice and this permission notice appear in |
| supporting documentation, and that the name of M.I.T. not be used in |
| advertising or publicity pertaining to distribution of the software |
| without specific, written prior permission. M.I.T. makes no |
| representations about the suitability of this software for any |
| purpose. It is provided "as is" without express or implied warranty. |
| .br |
| No further copyright claims are being made by the author(s) of this utility. |
