chiark / gitweb /
+ * Do not spin if TCP connection blocks for writing (and add test case).
[adns.git] / 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-2000 Ian Jackson <ian@davenant.greenend.org.uk>
8  *
9  *  It is part of adns, which is
10  *    Copyright (C) 1997-2000 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 <stdlib.h>
32 #include <stdio.h>
33 #include <string.h>
34 #include <errno.h>
35 #include <signal.h>
36 #include <stdarg.h>
37 #include <stdlib.h>
38 #include <assert.h>
39
40 #include <sys/types.h>
41 #include <sys/socket.h>
42 #include <netinet/in.h>
43 #include <arpa/inet.h>
44
45 #include "config.h"
46 #include "adns.h"
47 #include "dlist.h"
48
49 /* declarations related to option processing */
50
51 struct optioninfo;
52 typedef void optfunc(const struct optioninfo *oi, const char *arg, const char *arg2);
53
54 struct optioninfo {
55   enum oi_type {
56     ot_end, ot_desconly,
57     ot_flag, ot_value, ot_func, ot_funcarg, ot_funcarg2
58   } type;
59   const char *desc;
60   const char *sopt, *lopt;
61   int *storep, value;
62   optfunc *func;
63   const char *argdesc, *argdesc2;
64 };
65
66 enum ttlmode { tm_none, tm_rel, tm_abs };
67 enum outputformat { fmt_default, fmt_simple, fmt_inline, fmt_asynch };
68
69 struct perqueryflags_remember {
70   int show_owner, show_type, show_cname;
71   int ttl;
72 };
73
74 extern int ov_env, ov_pipe, ov_asynch;
75 extern int ov_verbose;
76 extern adns_rrtype ov_type;
77 extern int ov_search, ov_qc_query, ov_qc_anshost, ov_qc_cname;
78 extern int ov_tcp, ov_cname, ov_format;
79 extern char *ov_id;
80 extern struct perqueryflags_remember ov_pqfr;
81
82 extern optfunc of_help, of_type, of_ptr, of_reverse, of_asynch_id, of_cancel_id;
83
84 const struct optioninfo *opt_findl(const char *opt);
85 const struct optioninfo *opt_finds(const char **optp);
86 void opt_do(const struct optioninfo *oip, int invert, const char *arg, const char *arg2);
87
88 /* declarations related to query processing */
89
90 struct query_node {
91   struct query_node *next, *back;
92   struct perqueryflags_remember pqfr;
93   char *id, *owner;
94   adns_query qu;
95 };
96
97 extern adns_state ads;
98 extern struct outstanding_list { struct query_node *head, *tail; } outstanding;
99
100 void ensure_adns_init(void);
101 void query_do(const char *domain);
102 void query_done(struct query_node *qun, adns_answer *answer);
103
104 /* declarations related to main program and useful utility functions */
105
106 void sysfail(const char *what, int errnoval) NONRETURNING;
107 void usageerr(const char *what, ...) NONRETURNPRINTFFORMAT(1,2);
108 void outerr(void) NONRETURNING;
109
110 void *xmalloc(size_t sz);
111 char *xstrsave(const char *str);
112
113 extern int rcode;
114
115 #endif