Mercurial > repos > rliterman > csp2

comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/man/man1/adig.1 @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 68:5028fdace37b
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).