adnshost improvements - now runs for at least one query.
[adns] / client / adnshost.h
1 /*
2 * adnshost.h
3 * - useful general-purpose resolver client program, header file
4 */
5 /*
6 * This file is
7 * Copyright (C) 1997-1999 Ian Jackson <ian@davenant.greenend.org.uk>
8 *
9 * It is part of adns, which is
10 * Copyright (C) 1997-1999 Ian Jackson <ian@davenant.greenend.org.uk>
11 * Copyright (C) 1999 Tony Finch <dot@dotat.at>
12 *
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2, or (at your option)
16 * any later version.
17 *
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with this program; if not, write to the Free Software Foundation,
25 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26 */
27
28 #ifndef ADNSHOST_H_INCLUDED
29 #define ADNSHOST_H_INCLUDED
30
31 #include <stdio.h>
32 #include <string.h>
33 #include <errno.h>
34 #include <signal.h>
35 #include <stdarg.h>
36 #include <stdlib.h>
37 #include <assert.h>
38
39 #include "config.h"
40 #include "adns.h"
41 #include "dlist.h"
42
43 /* declarations related to option processing */
44
45 struct optioninfo;
46 typedef void optfunc(const struct optioninfo *oi, const char *arg);
47
48 struct optioninfo {
49 enum oi_type {
50 ot_end, ot_desconly,
51 ot_flag, ot_value, ot_func, ot_funcarg
52 } type;
53 const char *desc;
54 const char *sopt, *lopt;
55 int *storep, value;
56 optfunc *func;
57 const char *argdesc;
58 };
59
60 enum ttlmode { tm_none, tm_rel, tm_abs };
61
62 struct perqueryflags_remember {
63 int show_owner, show_type, show_cname;
64 int ttl;
65 };
66
67 extern int ov_env, ov_pipe, ov_asynch;
68 extern int ov_verbose;
69 extern adns_rrtype ov_type;
70 extern int ov_search, ov_qc_query, ov_qc_anshost, ov_qc_cname;
71 extern int ov_tcp, ov_cname;
72 extern char *ov_id;
73 extern struct perqueryflags_remember ov_pqfr;
74
75 extern optfunc of_help, of_type, of_asynch_id, of_cancel_id;
76
77 const struct optioninfo *opt_findl(const char *opt);
78 const struct optioninfo *opt_finds(const char **optp);
79 void opt_do(const struct optioninfo *oip, const char *arg);
80
81 /* declarations related to query processing */
82
83 struct query_node {
84 struct query_node *next, *back;
85 struct perqueryflags_remember pqfr;
86 char *id;
87 adns_query qu;
88 };
89
90 extern adns_state ads;
91 extern struct outstanding_list { struct query_node *head, *tail; } outstanding;
92
93 void ensure_adns_init(void);
94 void query_do(const char *domain);
95 void query_done(struct query_node *qun, adns_answer *answer);
96
97 void of_asynch_id(const struct optioninfo *oi, const char *arg);
98 void of_cancel_id(const struct optioninfo *oi, const char *arg);
99
100 /* declarations related to main program and useful utility functions */
101
102 void sysfail(const char *what, int errnoval) NONRETURNING;
103 void usageerr(const char *what, ...) NONRETURNPRINTFFORMAT(1,2);
104 void outerr(void) NONRETURNING;
105 void setnonblock(int fd, int nonblock);
106
107 void *xmalloc(size_t sz);
108 char *xstrsave(const char *str);
109
110 extern int rcode;
111
112 #endif