2 * Copyright (C) 2004-2009, 2011, 2012 Internet Systems Consortium, Inc. ("ISC")
3 * Copyright (C) 2000-2003 Internet Software Consortium.
5 * Permission to use, copy, modify, and/or distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
9 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 * PERFORMANCE OF THIS SOFTWARE.
18 /* $Id: dig.h,v 1.111.306.3 2011/12/07 17:23:55 each Exp $ */
25 #include <dns/rdatalist.h>
29 #include <isc/boolean.h>
30 #include <isc/buffer.h>
31 #include <isc/bufferlist.h>
32 #include <isc/formatcheck.h>
36 #include <isc/print.h>
37 #include <isc/sockaddr.h>
38 #include <isc/socket.h>
41 #define MXNAME (DNS_NAME_MAXTEXT+1)
45 #define COMMSIZE 0xffff
47 /*% location of resolve.conf */
48 #define RESOLV_CONF "/etc/resolv.conf"
51 #define OUTPUTBUF 32767
53 #define MAXRRLIMIT 0xffffffff
54 #define MAXTIMEOUT 0xffff
55 /*% Max number of tries */
56 #define MAXTRIES 0xffffffff
57 /*% Max number of dots */
58 #define MAXNDOTS 0xffff
59 /*% Max number of ports */
60 #define MAXPORT 0xffff
61 /*% Max serial number */
62 #define MAXSERIAL 0xffffffff
64 /*% Default TCP Timeout */
65 #define TCP_TIMEOUT 10
66 /*% Default UDP Timeout */
69 #define SERVER_TIMEOUT 1
71 #define LOOKUP_LIMIT 64
73 * Lookup_limit is just a limiter, keeping too many lookups from being
74 * created. It's job is mainly to prevent the program from running away
75 * in a tight loop of constant lookups. It's value is arbitrary.
79 * Defaults for the sigchase suboptions. Consolidated here because
80 * these control the layout of dig_lookup_t (among other things).
83 #ifndef DIG_SIGCHASE_BU
84 #define DIG_SIGCHASE_BU 1
86 #ifndef DIG_SIGCHASE_TD
87 #define DIG_SIGCHASE_TD 1
93 typedef struct dig_lookup dig_lookup_t;
94 typedef struct dig_query dig_query_t;
95 typedef struct dig_server dig_server_t;
97 typedef struct dig_message dig_message_t;
99 typedef ISC_LIST(dig_server_t) dig_serverlist_t;
100 typedef struct dig_searchlist dig_searchlist_t;
102 /*% The dig_lookup structure */
105 pending, /*%< Pending a successful answer */
108 ns_search_only, /*%< dig +nssearch, host -C */
109 identify, /*%< Append an "on server <foo>" message */
110 identify_previous_line, /*% Prepend a "Nameserver <foo>:"
111 message, with newline and tab */
117 trace, /*% dig +trace */
118 trace_root, /*% initial query for either +trace or +nssearch */
133 nsid; /*% Name Server ID (RFC 5001) */
135 isc_boolean_t sigchase;
137 isc_boolean_t do_topdown,
141 /* Name we are going to validate RRset */
142 char textnamesigchase[MXNAME];
146 char textname[MXNAME]; /*% Name we're going to be looking up */
147 char cmdline[MXNAME];
148 dns_rdatatype_t rdtype;
149 dns_rdatatype_t qrdtype;
151 dns_rdatatype_t rdtype_sigchase;
152 dns_rdatatype_t qrdtype_sigchase;
153 dns_rdataclass_t rdclass_sigchase;
155 dns_rdataclass_t rdclass;
156 isc_boolean_t rdtypeset;
157 isc_boolean_t rdclassset;
158 char namespace[BUFSIZE];
159 char onamespace[BUFSIZE];
160 isc_buffer_t namebuf;
161 isc_buffer_t onamebuf;
162 isc_buffer_t renderbuf;
166 isc_interval_t interval;
167 dns_message_t *sendmsg;
169 ISC_LINK(dig_lookup_t) link;
170 ISC_LIST(dig_query_t) q;
171 ISC_LIST(dig_query_t) connecting;
172 dig_query_t *current_query;
173 dig_serverlist_t my_server_list;
174 dig_searchlist_t *origin;
176 isc_uint32_t retries;
178 isc_uint16_t udpsize;
180 isc_uint32_t ixfr_serial;
181 isc_buffer_t rdatabuf;
182 char rdatastore[MXNAME];
183 dst_context_t *tsigctx;
184 isc_buffer_t *querysig;
185 isc_uint32_t msgcounter;
186 dns_fixedname_t fdomain;
189 /*% The dig_query structure */
191 dig_lookup_t *lookup;
192 isc_boolean_t waiting_connect,
201 isc_uint32_t first_rr_serial;
202 isc_uint32_t second_rr_serial;
203 isc_uint32_t msg_count;
204 isc_uint32_t rr_count;
207 isc_bufferlist_t sendlist,
210 isc_buffer_t recvbuf,
217 ISC_LINK(dig_query_t) link;
218 ISC_LINK(dig_query_t) clink;
219 isc_sockaddr_t sockaddr;
220 isc_time_t time_sent;
221 isc_uint64_t byte_count;
222 isc_buffer_t sendbuf;
226 char servername[MXNAME];
227 char userarg[MXNAME];
228 ISC_LINK(dig_server_t) link;
231 struct dig_searchlist {
233 ISC_LINK(dig_searchlist_t) link;
238 ISC_LINK(dig_message_t) link;
242 typedef ISC_LIST(dig_searchlist_t) dig_searchlistlist_t;
243 typedef ISC_LIST(dig_lookup_t) dig_lookuplist_t;
246 * Externals from dighost.c
249 extern dig_lookuplist_t lookup_list;
250 extern dig_serverlist_t server_list;
251 extern dig_searchlistlist_t search_list;
252 extern unsigned int extrabytes;
254 extern isc_boolean_t check_ra, have_ipv4, have_ipv6, specified_source,
255 usesearch, showsearch, qr;
256 extern in_port_t port;
257 extern unsigned int timeout;
258 extern isc_mem_t *mctx;
259 extern dns_messageid_t id;
260 extern int sendcount;
262 extern int lookup_counter;
264 extern isc_sockaddr_t bind_address;
265 extern char keynametext[MXNAME];
266 extern char keyfile[MXNAME];
267 extern char keysecret[MXNAME];
268 extern dns_name_t *hmacname;
269 extern unsigned int digestbits;
271 extern char trustedkey[MXNAME];
273 extern dns_tsigkey_t *key;
274 extern isc_boolean_t validated;
275 extern isc_taskmgr_t *taskmgr;
276 extern isc_task_t *global_task;
277 extern isc_boolean_t free_now;
278 extern isc_boolean_t debugging, memdebugging;
280 extern char *progname;
282 extern int fatalexit;
284 extern int idnoptions;
288 * Routines in dighost.c.
291 get_address(char *host, in_port_t port, isc_sockaddr_t *sockaddr);
294 getaddresses(dig_lookup_t *lookup, const char *host, isc_result_t *resultp);
297 get_reverse(char *reverse, size_t len, char *value, isc_boolean_t ip6_int,
298 isc_boolean_t strict);
300 ISC_PLATFORM_NORETURN_PRE void
301 fatal(const char *format, ...)
302 ISC_FORMAT_PRINTF(1, 2) ISC_PLATFORM_NORETURN_POST;
305 debug(const char *format, ...) ISC_FORMAT_PRINTF(1, 2);
308 check_result(isc_result_t result, const char *msg);
311 setup_lookup(dig_lookup_t *lookup);
314 destroy_lookup(dig_lookup_t *lookup);
317 do_lookup(dig_lookup_t *lookup);
323 onrun_callback(isc_task_t *task, isc_event_t *event);
326 dhmain(int argc, char **argv);
335 parse_uint(isc_uint32_t *uip, const char *value, isc_uint32_t max,
339 parse_hmac(const char *hmacstr);
342 requeue_lookup(dig_lookup_t *lookold, isc_boolean_t servers);
345 make_empty_lookup(void);
348 clone_lookup(dig_lookup_t *lookold, isc_boolean_t servers);
351 make_server(const char *servname, const char *userarg);
354 flush_server_list(void);
357 set_nameserver(char *opt);
360 clone_server_list(dig_serverlist_t src,
361 dig_serverlist_t *dest);
370 set_search_domain(char *domain);
374 clean_trustedkey(void);
378 * Routines to be defined in dig.c, host.c, and nslookup.c.
382 printrdataset(dns_name_t *owner_name, dns_rdataset_t *rdataset,
383 isc_buffer_t *target);
387 printmessage(dig_query_t *query, dns_message_t *msg, isc_boolean_t headers);
389 * Print the final result of the lookup.
393 received(int bytes, isc_sockaddr_t *from, dig_query_t *query);
395 * Print a message about where and when the response
396 * was received from, like the final comment in the
401 trying(char *frm, dig_lookup_t *lookup);
404 dighost_shutdown(void);
407 next_token(char **stringp, const char *delim);
410 /* Chasing functions */
412 chase_scanname(dns_name_t *name, dns_rdatatype_t type, dns_rdatatype_t covers);
414 chase_sig(dns_message_t *msg);