1 /*	$NetBSD: dns.h,v 1.1.1.2 2010/06/17 18:06:44 tron Exp $	*/
2 
3 #ifndef _DNS_H_INCLUDED_
4 #define _DNS_H_INCLUDED_
5 
6 /*++
7 /* NAME
8 /*	dns 3h
9 /* SUMMARY
10 /*	domain name service lookup
11 /* SYNOPSIS
12 /*	#include <dns.h>
13 /* DESCRIPTION
14 /* .nf
15 
16  /*
17   * System library.
18   */
19 #include <netinet/in.h>
20 #include <arpa/nameser.h>
21 #ifdef RESOLVE_H_NEEDS_STDIO_H
22 #include <stdio.h>
23 #endif
24 #ifdef RESOLVE_H_NEEDS_NAMESER8_COMPAT_H
25 #include <nameser8_compat.h>
26 #endif
27 #ifdef RESOLVE_H_NEEDS_ARPA_NAMESER_COMPAT_H
28 #include <arpa/nameser_compat.h>
29 #endif
30 #include <resolv.h>
31 
32  /*
33   * Name server compatibility. These undocumented macros appear in the file
34   * <arpa/nameser.h>, but since they are undocumented we should not count on
35   * their presence, and so they are included here just in case.
36   */
37 #ifndef GETSHORT
38 
39 #define GETSHORT(s, cp) { \
40 	unsigned char *t_cp = (u_char *)(cp); \
41 	(s) = ((unsigned)t_cp[0] << 8) \
42 	    | ((unsigned)t_cp[1]) \
43 	    ; \
44 	(cp) += 2; \
45 }
46 
47 #define GETLONG(l, cp) { \
48 	unsigned char *t_cp = (u_char *)(cp); \
49 	(l) = ((unsigned)t_cp[0] << 24) \
50 	    | ((unsigned)t_cp[1] << 16) \
51 	    | ((unsigned)t_cp[2] << 8) \
52 	    | ((unsigned)t_cp[3]) \
53 	    ; \
54 	(cp) += 4; \
55 }
56 
57 #endif
58 
59  /*
60   * SunOS 4 needs this.
61   */
62 #ifndef T_TXT
63 #define T_TXT	16
64 #endif
65 
66  /*
67   * Utility library.
68   */
69 #include <vstring.h>
70 #include <sock_addr.h>
71 #include <myaddrinfo.h>
72 
73  /*
74   * Structure for fixed resource record data.
75   */
76 typedef struct DNS_FIXED {
77     unsigned short type;		/* T_A, T_CNAME, etc. */
78     unsigned short class;		/* C_IN, etc. */
79     unsigned int ttl;			/* always */
80     unsigned length;			/* record length */
81 } DNS_FIXED;
82 
83  /*
84   * Structure of a DNS resource record after expansion. The components are
85   * named after the things one can expect to find in a DNS resource record.
86   */
87 typedef struct DNS_RR {
88     char   *qname;			/* query name, mystrdup()ed */
89     char   *rname;			/* reply name, mystrdup()ed */
90     unsigned short type;		/* T_A, T_CNAME, etc. */
91     unsigned short class;		/* C_IN, etc. */
92     unsigned int ttl;			/* always */
93     unsigned short pref;		/* T_MX only */
94     struct DNS_RR *next;		/* linkage */
95     size_t  data_len;			/* actual data size */
96     char    data[1];			/* actually a bunch of data */
97 } DNS_RR;
98 
99  /*
100   * dns_strerror.c
101   */
102 extern const char *dns_strerror(unsigned);
103 
104  /*
105   * dns_strtype.c
106   */
107 extern const char *dns_strtype(unsigned);
108 extern unsigned dns_type(const char *);
109 
110  /*
111   * dns_rr.c
112   */
113 extern DNS_RR *dns_rr_create(const char *, const char *,
114 			             ushort, ushort,
115 			             unsigned, unsigned,
116 			             const char *, size_t);
117 extern void dns_rr_free(DNS_RR *);
118 extern DNS_RR *dns_rr_copy(DNS_RR *);
119 extern DNS_RR *dns_rr_append(DNS_RR *, DNS_RR *);
120 extern DNS_RR *dns_rr_sort(DNS_RR *, int (*) (DNS_RR *, DNS_RR *));
121 extern int dns_rr_compare_pref(DNS_RR *, DNS_RR *);
122 extern DNS_RR *dns_rr_shuffle(DNS_RR *);
123 extern DNS_RR *dns_rr_remove(DNS_RR *, DNS_RR *);
124 
125  /*
126   * dns_rr_to_pa.c
127   */
128 extern const char *dns_rr_to_pa(DNS_RR *, MAI_HOSTADDR_STR *);
129 
130  /*
131   * dns_sa_to_rr.c
132   */
133 extern DNS_RR *dns_sa_to_rr(const char *, unsigned, struct sockaddr *);
134 
135  /*
136   * dns_rr_to_sa.c
137   */
138 extern int dns_rr_to_sa(DNS_RR *, unsigned, struct sockaddr *, SOCKADDR_SIZE *);
139 
140  /*
141   * dns_rr_eq_sa.c
142   */
143 extern int dns_rr_eq_sa(DNS_RR *, struct sockaddr *);
144 
145 #ifdef HAS_IPV6
146 #define DNS_RR_EQ_SA(rr, sa) \
147     ((SOCK_ADDR_IN_FAMILY(sa) == AF_INET && (rr)->type == T_A \
148      && SOCK_ADDR_IN_ADDR(sa).s_addr == IN_ADDR((rr)->data).s_addr) \
149     || (SOCK_ADDR_IN_FAMILY(sa) == AF_INET6 && (rr)->type == T_AAAA \
150 	&& memcmp((char *) &(SOCK_ADDR_IN6_ADDR(sa)), \
151 		  (rr)->data, (rr)->data_len) == 0))
152 #else
153 #define DNS_RR_EQ_SA(rr, sa) \
154     (SOCK_ADDR_IN_FAMILY(sa) == AF_INET && (rr)->type == T_A \
155      && SOCK_ADDR_IN_ADDR(sa).s_addr == IN_ADDR((rr)->data).s_addr)
156 #endif
157 
158  /*
159   * dns_lookup.c
160   */
161 extern int dns_lookup(const char *, unsigned, unsigned, DNS_RR **,
162 		              VSTRING *, VSTRING *);
163 extern int dns_lookup_l(const char *, unsigned, DNS_RR **, VSTRING *,
164 			        VSTRING *, int,...);
165 extern int dns_lookup_v(const char *, unsigned, DNS_RR **, VSTRING *,
166 			        VSTRING *, int, unsigned *);
167 
168  /*
169   * Request flags.
170   */
171 #define DNS_REQ_FLAG_STOP_OK	(1<<0)
172 #define DNS_REQ_FLAG_STOP_INVAL	(1<<1)
173 #define DNS_REQ_FLAG_NONE	(0)
174 
175  /*
176   * Status codes. Failures must have negative codes so they will not collide
177   * with valid counts of answer records etc.
178   */
179 #define DNS_INVAL	(-5)		/* query ok, malformed reply */
180 #define DNS_FAIL	(-4)		/* query failed, don't retry */
181 #define DNS_NOTFOUND	(-3)		/* query ok, data not found */
182 #define DNS_RETRY	(-2)		/* query failed, try again */
183 #define DNS_RECURSE	(-1)		/* recursion needed */
184 #define DNS_OK		0		/* query succeeded */
185 
186  /*
187   * How long can a DNS name or single text value be?
188   */
189 #define DNS_NAME_LEN	1024
190 
191 /* LICENSE
192 /* .ad
193 /* .fi
194 /*	The Secure Mailer license must be distributed with this software.
195 /* AUTHOR(S)
196 /*	Wietse Venema
197 /*	IBM T.J. Watson Research
198 /*	P.O. Box 704
199 /*	Yorktown Heights, NY 10598, USA
200 /*--*/
201 
202 #endif
203