adig.1 (4555B)
1 .\" 2 .\" Copyright (C) the Massachusetts Institute of Technology. 3 .\" Copyright (C) Daniel Stenberg 4 .\" SPDX-License-Identifier: MIT 5 .\" 6 .TH ADIG "1" "Sept 2024" "c-ares utilities" 7 .SH NAME 8 adig \- print information collected from Domain Name System (DNS) servers 9 .SH SYNOPSIS 10 \fBadig\fP [\fI@server\fR] [\fI-c class\fR] [\fI-p port#\fR] [\fI-q name\fR] 11 [\fI-t type\fR] [\fI-x addr\fR] [\fIname\fR] [\fItype\fR] [\fIclass\fR] 12 [\fIqueryopt\fR...] 13 14 .SH DESCRIPTION 15 .PP 16 Send queries to DNS servers about \fUname\fR and print received 17 information, where \fIname\fR is a valid DNS name (e.g. www.example.com, 18 1.2.3.10.in-addr.arpa). 19 .PP 20 This utility comes with the \fBc\-ares\fR asynchronous resolver library. 21 .PP 22 It is possible to specify default arguments for \fBadig\fR via \fB${XDG_CONFIG_HOME}/adigrc\fR. 23 .SH ARGS 24 .TP 25 \fB@server\fR 26 Server ip address. May specify multiple in comma delimited format. May be 27 specified in URI format. 28 .TP 29 \fBname\fR 30 Name of the resource record that is to be looked up 31 .TP 32 \fBtype\fR 33 What type of query is required. e.g. - A, AAAA, MX, TXT, etc. If not 34 specified, A will be used. 35 .TP 36 \fBclass\fR 37 Sets the query class, defaults to IN. May also be HS or CH. 38 39 .SH FLAGS 40 .TP 41 \fB\-c\fR class 42 Sets the query class, defaults to IN. May also be HS or CH. 43 .TP 44 \fB\-h\fR 45 Prints the help. 46 .TP 47 \fB\-p\fR port 48 Sends query to a port other than 53. Often recommended to set the port using 49 \fI@server\fR instead. 50 .TP 51 \fB\-q\fR name 52 Specifies the domain name to query. Useful to distinguish name from other 53 arguments 54 .TP 55 \fB\-r\fR 56 Skip adigrc processing 57 .TP 58 \fB\-s\fR 59 Server (alias for @server syntax), compatibility with old cmdline 60 .TP 61 \fB\-t\fR type 62 Indicates resource record type to query. Useful to distinguish type from other 63 arguments 64 .TP 65 \fB\-x\fR addr 66 Simplified reverse lookups. Sets the type to PTR and forms a valid in-arpa 67 query string 68 69 .SH QUERY OPTIONS 70 .TP 71 \fB+[no]aaonly\fR 72 Sets the aa flag in the query. Default is off. 73 .TP 74 \fB+[no]aaflag\fR 75 Alias for +[no]aaonly 76 .TP 77 \fB+[no]additional\fR 78 Toggles printing the additional section. On by default. 79 .TP 80 \fB+[no]adflag\fR 81 Sets the ad (authentic data) bit in the query. Default is off. 82 .TP 83 \fB+[no]aliases\fR 84 Whether or not to honor the HOSTALIASES file. Default is on. 85 .TP 86 \fB+[no]all\fR 87 Toggles all of +[no]cmd, +[no]stats, +[no]question, +[no]answer, 88 +[no]authority, +[no]additional, +[no]comments 89 .TP 90 \fB+[no]answer\fR 91 Toggles printing the answer. On by default. 92 .TP 93 \fB+[no]authority\fR 94 Toggles printing the authority. On by default. 95 .TP 96 \fB+bufsize=\fR# 97 UDP EDNS 0 packet size allowed. Defaults to 1232. 98 .TP 99 \fB+[no]cdflag\fR 100 Sets the CD (checking disabled) bit in the query. Default is off. 101 .TP 102 \fB+[no]class\fR 103 Display the class when printing the record. On by default. 104 .TP 105 \fB+[no]cmd\fR 106 Toggles printing the command requested. On by default. 107 .TP 108 \fB+[no]comments\fR 109 Toggles printing the comments. On by default 110 .TP 111 \fB+[no]defname\fR 112 Alias for +[no]search 113 .TP 114 \fB+domain=somename\fR 115 Sets the search list to a single domain. 116 .TP 117 \fB+[no]dns0x20\fR 118 Whether or not to use DNS 0x20 case randomization when sending queries. 119 Default is off. 120 .TP 121 \fB+[no]edns\fR[=#] 122 Enable or disable EDNS. Only allows a value of 0 if specified. Default is to 123 enable EDNS. 124 .TP 125 \fB+[no]ignore\fR 126 Ignore truncation on UDP, by default retried on TCP. 127 .TP 128 \fB+[no]keepopen\fR 129 Whether or not the server connection should be persistent. Default is off. 130 .TP 131 \fB+ndots\fR=# 132 Sets the number of dots that must appear before being considered absolute. 133 Defaults to 1. 134 .TP 135 \fB+[no]primary\fR 136 Whether or not to only use a single server if more than one server is available. 137 Defaults to using all servers. 138 .TP 139 \fB+[no]qr\fR 140 Toggles printing the request query. Off by default. 141 .TP 142 \fB+[no]question\fR 143 Toggles printing the question. On by default. 144 .TP 145 \fB+[no]recurse\fR 146 Toggles the RD (Recursion Desired) bit. On by default. 147 .TP 148 \fB+retry\fR=# 149 Same as +tries but does not include the initial attempt. 150 .TP 151 \fB+[no]search\fR 152 To use or not use the search list. Search list is not used by default. 153 .TP 154 \fB+[no]stats\fR 155 Toggles printing the statistics. On by default. 156 .TP 157 \fB+[no]tcp\fR 158 Whether to use TCP when querying name servers. Default is UDP. 159 .TP 160 \fB+tries\fR=# 161 Number of query tries. Defaults to 3. 162 .TP 163 \fB+[no]ttlid\fR 164 Display the TTL when printing the record. On by default. 165 .TP 166 \fB+[no]vc\fR 167 Alias for +[no]tcp 168 169 .SH FILES 170 171 ${XDG_CONFIG_HOME}/adigrc 172 173 .SH "REPORTING BUGS" 174 Report bugs to the c-ares github issues tracker 175 .br 176 \fBhttps://github.com/c-ares/c-ares/issues\fR 177 .SH "SEE ALSO" 178 .PP 179 ahost(1).