xref: /minix/external/bsd/bind/include/lwres/netdb.h (revision bb9622b5)
1 /*
2  * Copyright (C) 2004, 2005, 2007, 2009, 2014  Internet Systems Consortium, Inc. ("ISC")
3  * Copyright (C) 2000, 2001  Internet Software Consortium.
4  *
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.
8  *
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.
16  */
17 
18 /* Id: netdb.h.in,v 1.41 2009/01/18 23:48:14 tbox Exp  */
19 
20 /*! \file */
21 
22 #ifndef LWRES_NETDB_H
23 #define LWRES_NETDB_H 1
24 
25 #include <stddef.h>	/* Required on FreeBSD (and  others?) for size_t. */
26 #include <netdb.h>	/* Contractual provision. */
27 
28 #include <lwres/lang.h>
29 
30 /*
31  * Define if <netdb.h> does not declare struct addrinfo.
32  */
33 #undef ISC_LWRES_NEEDADDRINFO
34 
35 #ifdef ISC_LWRES_NEEDADDRINFO
36 struct addrinfo {
37 	int		ai_flags;      /* AI_PASSIVE, AI_CANONNAME */
38 	int		ai_family;     /* PF_xxx */
39 	int		ai_socktype;   /* SOCK_xxx */
40 	int		ai_protocol;   /* 0 or IPPROTO_xxx for IPv4 and IPv6 */
41 	size_t		ai_addrlen;    /* Length of ai_addr */
42 	char		*ai_canonname; /* Canonical name for hostname */
43 	struct sockaddr	*ai_addr;      /* Binary address */
44 	struct addrinfo	*ai_next;      /* Next structure in linked list */
45 };
46 #endif
47 
48 /*
49  * Undefine all #defines we are interested in as <netdb.h> may or may not have
50  * defined them.
51  */
52 
53 /*
54  * Error return codes from gethostbyname() and gethostbyaddr()
55  * (left in extern int h_errno).
56  */
57 
58 #undef	NETDB_INTERNAL
59 #undef	NETDB_SUCCESS
60 #undef	HOST_NOT_FOUND
61 #undef	TRY_AGAIN
62 #undef	NO_RECOVERY
63 #undef	NO_DATA
64 #undef	NO_ADDRESS
65 
66 #define	NETDB_INTERNAL	-1	/* see errno */
67 #define	NETDB_SUCCESS	0	/* no problem */
68 #define	HOST_NOT_FOUND	1 /* Authoritative Answer Host not found */
69 #define	TRY_AGAIN	2 /* Non-Authoritative Host not found, or SERVERFAIL */
70 #define	NO_RECOVERY	3 /* Non recoverable errors, FORMERR, REFUSED, NOTIMP */
71 #define	NO_DATA		4 /* Valid name, no data record of requested type */
72 #define	NO_ADDRESS	NO_DATA		/* no address, look for MX record */
73 
74 /*
75  * Error return codes from getaddrinfo()
76  */
77 
78 #undef	EAI_ADDRFAMILY
79 #undef	EAI_AGAIN
80 #undef	EAI_BADFLAGS
81 #undef	EAI_FAIL
82 #undef	EAI_FAMILY
83 #undef	EAI_MEMORY
84 #undef	EAI_NODATA
85 #undef	EAI_NONAME
86 #undef	EAI_SERVICE
87 #undef	EAI_SOCKTYPE
88 #undef	EAI_SYSTEM
89 #undef	EAI_BADHINTS
90 #undef	EAI_PROTOCOL
91 #undef	EAI_OVERFLOW
92 #undef	EAI_MAX
93 
94 #define	EAI_ADDRFAMILY	 1	/* address family for hostname not supported */
95 #define	EAI_AGAIN	 2	/* temporary failure in name resolution */
96 #define	EAI_BADFLAGS	 3	/* invalid value for ai_flags */
97 #define	EAI_FAIL	 4	/* non-recoverable failure in name resolution */
98 #define	EAI_FAMILY	 5	/* ai_family not supported */
99 #define	EAI_MEMORY	 6	/* memory allocation failure */
100 #define	EAI_NODATA	 7	/* no address associated with hostname */
101 #define	EAI_NONAME	 8	/* hostname nor servname provided, or not known */
102 #define	EAI_SERVICE	 9	/* servname not supported for ai_socktype */
103 #define	EAI_SOCKTYPE	10	/* ai_socktype not supported */
104 #define	EAI_SYSTEM	11	/* system error returned in errno */
105 #define EAI_BADHINTS	12
106 #define EAI_PROTOCOL	13
107 #define EAI_OVERFLOW	14
108 #define EAI_MAX		15
109 
110 /*
111  * Flag values for getaddrinfo()
112  */
113 #undef	AI_PASSIVE
114 #undef	AI_CANONNAME
115 #undef	AI_NUMERICHOST
116 
117 #define	AI_PASSIVE	0x00000001
118 #define	AI_CANONNAME	0x00000002
119 #define AI_NUMERICHOST	0x00000004
120 
121 /*
122  * Flag values for getipnodebyname()
123  */
124 #undef AI_V4MAPPED
125 #undef AI_ALL
126 #undef AI_ADDRCONFIG
127 #undef AI_DEFAULT
128 
129 #define AI_V4MAPPED	0x00000008
130 #define AI_ALL		0x00000010
131 #define AI_ADDRCONFIG	0x00000020
132 #define AI_DEFAULT	(AI_V4MAPPED|AI_ADDRCONFIG)
133 
134 /*
135  * Constants for lwres_getnameinfo()
136  */
137 #undef	NI_MAXHOST
138 #undef	NI_MAXSERV
139 
140 #define	NI_MAXHOST	1025
141 #define	NI_MAXSERV	32
142 
143 /*
144  * Flag values for lwres_getnameinfo()
145  */
146 #undef	NI_NOFQDN
147 #undef	NI_NUMERICHOST
148 #undef	NI_NAMEREQD
149 #undef	NI_NUMERICSERV
150 #undef	NI_DGRAM
151 #undef	NI_NUMERICSCOPE
152 
153 #define	NI_NOFQDN	0x00000001
154 #define	NI_NUMERICHOST	0x00000002
155 #define	NI_NAMEREQD	0x00000004
156 #define	NI_NUMERICSERV	0x00000008
157 #define	NI_DGRAM	0x00000010
158 #define	NI_NUMERICSCOPE	0x00000020	/*2553bis-00*/
159 
160 /*
161  * Define if <netdb.h> does not declare struct rrsetinfo.
162  */
163 #define ISC_LWRES_NEEDRRSETINFO 1
164 
165 #ifdef ISC_LWRES_NEEDRRSETINFO
166 /*
167  * Structures for getrrsetbyname()
168  */
169 struct rdatainfo {
170 	unsigned int		rdi_length;
171 	unsigned char		*rdi_data;
172 };
173 
174 struct rrsetinfo {
175 	unsigned int		rri_flags;
176 	int			rri_rdclass;
177 	int			rri_rdtype;
178 	unsigned int		rri_ttl;
179 	unsigned int		rri_nrdatas;
180 	unsigned int		rri_nsigs;
181 	char			*rri_name;
182 	struct rdatainfo	*rri_rdatas;
183 	struct rdatainfo	*rri_sigs;
184 };
185 
186 /*
187  * Flags for getrrsetbyname()
188  */
189 #define RRSET_VALIDATED		0x00000001
190 	/* Set was dnssec validated */
191 
192 /*
193  * Return codes for getrrsetbyname()
194  */
195 #define ERRSET_SUCCESS		0
196 #define ERRSET_NOMEMORY		1
197 #define ERRSET_FAIL		2
198 #define ERRSET_INVAL		3
199 #define	ERRSET_NONAME	 	4
200 #define	ERRSET_NODATA	 	5
201 #endif
202 
203 /*
204  * Define to map into lwres_ namespace.
205  */
206 
207 #define LWRES_NAMESPACE
208 
209 #ifdef LWRES_NAMESPACE
210 
211 /*
212  * Use our versions not the ones from the C library.
213  */
214 
215 #ifdef getnameinfo
216 #undef getnameinfo
217 #endif
218 #define getnameinfo lwres_getnameinfo
219 
220 #ifdef getaddrinfo
221 #undef getaddrinfo
222 #endif
223 #define getaddrinfo lwres_getaddrinfo
224 
225 #ifdef freeaddrinfo
226 #undef freeaddrinfo
227 #endif
228 #define freeaddrinfo lwres_freeaddrinfo
229 
230 #ifdef gai_strerror
231 #undef gai_strerror
232 #endif
233 #define gai_strerror lwres_gai_strerror
234 
235 #ifdef herror
236 #undef herror
237 #endif
238 #define herror lwres_herror
239 
240 #ifdef hstrerror
241 #undef hstrerror
242 #endif
243 #define hstrerror lwres_hstrerror
244 
245 #ifdef getipnodebyname
246 #undef getipnodebyname
247 #endif
248 #define getipnodebyname lwres_getipnodebyname
249 
250 #ifdef getipnodebyaddr
251 #undef getipnodebyaddr
252 #endif
253 #define getipnodebyaddr lwres_getipnodebyaddr
254 
255 #ifdef freehostent
256 #undef freehostent
257 #endif
258 #define freehostent lwres_freehostent
259 
260 #ifdef gethostbyname
261 #undef gethostbyname
262 #endif
263 #define gethostbyname lwres_gethostbyname
264 
265 #ifdef gethostbyname2
266 #undef gethostbyname2
267 #endif
268 #define gethostbyname2 lwres_gethostbyname2
269 
270 #ifdef gethostbyaddr
271 #undef gethostbyaddr
272 #endif
273 #define gethostbyaddr lwres_gethostbyaddr
274 
275 #ifdef gethostent
276 #undef gethostent
277 #endif
278 #define gethostent lwres_gethostent
279 
280 #ifdef sethostent
281 #undef sethostent
282 #endif
283 #define sethostent lwres_sethostent
284 
285 #ifdef endhostent
286 #undef endhostent
287 #endif
288 #define endhostent lwres_endhostent
289 
290 /* #define sethostfile lwres_sethostfile */
291 
292 #ifdef gethostbyname_r
293 #undef gethostbyname_r
294 #endif
295 #define gethostbyname_r lwres_gethostbyname_r
296 
297 #ifdef gethostbyaddr_r
298 #undef gethostbyaddr_r
299 #endif
300 #define gethostbyaddr_r lwres_gethostbyaddr_r
301 
302 #ifdef gethostent_r
303 #undef gethostent_r
304 #endif
305 #define gethostent_r lwres_gethostent_r
306 
307 #ifdef sethostent_r
308 #undef sethostent_r
309 #endif
310 #define sethostent_r lwres_sethostent_r
311 
312 #ifdef endhostent_r
313 #undef endhostent_r
314 #endif
315 #define endhostent_r lwres_endhostent_r
316 
317 #ifdef getrrsetbyname
318 #undef getrrsetbyname
319 #endif
320 #define getrrsetbyname lwres_getrrsetbyname
321 
322 #ifdef freerrset
323 #undef freerrset
324 #endif
325 #define freerrset lwres_freerrset
326 
327 #ifdef notyet
328 #define getservbyname lwres_getservbyname
329 #define getservbyport lwres_getservbyport
330 #define getservent lwres_getservent
331 #define setservent lwres_setservent
332 #define endservent lwres_endservent
333 
334 #define getservbyname_r lwres_getservbyname_r
335 #define getservbyport_r lwres_getservbyport_r
336 #define getservent_r lwres_getservent_r
337 #define setservent_r lwres_setservent_r
338 #define endservent_r lwres_endservent_r
339 
340 #define getprotobyname lwres_getprotobyname
341 #define getprotobynumber lwres_getprotobynumber
342 #define getprotoent lwres_getprotoent
343 #define setprotoent lwres_setprotoent
344 #define endprotoent lwres_endprotoent
345 
346 #define getprotobyname_r lwres_getprotobyname_r
347 #define getprotobynumber_r lwres_getprotobynumber_r
348 #define getprotoent_r lwres_getprotoent_r
349 #define setprotoent_r lwres_setprotoent_r
350 #define endprotoent_r lwres_endprotoent_r
351 
352 #ifdef getnetbyname
353 #undef getnetbyname
354 #endif
355 #define getnetbyname lwres_getnetbyname
356 
357 #ifdef getnetbyaddr
358 #undef getnetbyaddr
359 #endif
360 #define getnetbyaddr lwres_getnetbyaddr
361 
362 #ifdef getnetent
363 #undef getnetent
364 #endif
365 #define getnetent lwres_getnetent
366 
367 #ifdef setnetent
368 #undef setnetent
369 #endif
370 #define setnetent lwres_setnetent
371 
372 #ifdef endnetent
373 #undef endnetent
374 #endif
375 #define endnetent lwres_endnetent
376 
377 
378 #ifdef getnetbyname_r
379 #undef getnetbyname_r
380 #endif
381 #define getnetbyname_r lwres_getnetbyname_r
382 
383 #ifdef getnetbyaddr_r
384 #undef getnetbyaddr_r
385 #endif
386 #define getnetbyaddr_r lwres_getnetbyaddr_r
387 
388 #ifdef getnetent_r
389 #undef getnetent_r
390 #endif
391 #define getnetent_r lwres_getnetent_r
392 
393 #ifdef setnetent_r
394 #undef setnetent_r
395 #endif
396 #define setnetent_r lwres_setnetent_r
397 
398 #ifdef endnetent_r
399 #undef endnetent_r
400 #endif
401 #define endnetent_r lwres_endnetent_r
402 #endif	/* notyet */
403 
404 #ifdef h_errno
405 #undef h_errno
406 #endif
407 #define h_errno lwres_h_errno
408 
409 #endif	/* LWRES_NAMESPACE */
410 
411 LWRES_LANG_BEGINDECLS
412 
413 extern int lwres_h_errno;
414 
415 int		lwres_getaddrinfo(const char *, const char *,
416 				 const struct addrinfo *, struct addrinfo **);
417 int		lwres_getnameinfo(const struct sockaddr *, size_t, char *,
418 				 size_t, char *, size_t, int);
419 void		lwres_freeaddrinfo(struct addrinfo *);
420 char		*lwres_gai_strerror(int);
421 
422 struct hostent	*lwres_gethostbyaddr(const char *, int, int);
423 struct hostent	*lwres_gethostbyname(const char *);
424 struct hostent	*lwres_gethostbyname2(const char *, int);
425 struct hostent	*lwres_gethostent(void);
426 struct hostent	*lwres_getipnodebyname(const char *, int, int, int *);
427 struct hostent	*lwres_getipnodebyaddr(const void *, size_t, int, int *);
428 void		lwres_endhostent(void);
429 void		lwres_sethostent(int);
430 /* void		lwres_sethostfile(const char *); */
431 void		lwres_freehostent(struct hostent *);
432 
433 int		lwres_getrrsetbyname(const char *, unsigned int, unsigned int,
434 				     unsigned int, struct rrsetinfo **);
435 void		lwres_freerrset(struct rrsetinfo *);
436 
437 #ifdef notyet
438 struct netent	*lwres_getnetbyaddr(unsigned long, int);
439 struct netent	*lwres_getnetbyname(const char *);
440 struct netent	*lwres_getnetent(void);
441 void		lwres_endnetent(void);
442 void		lwres_setnetent(int);
443 
444 struct protoent	*lwres_getprotobyname(const char *);
445 struct protoent	*lwres_getprotobynumber(int);
446 struct protoent	*lwres_getprotoent(void);
447 void		lwres_endprotoent(void);
448 void		lwres_setprotoent(int);
449 
450 struct servent	*lwres_getservbyname(const char *, const char *);
451 struct servent	*lwres_getservbyport(int, const char *);
452 struct servent	*lwres_getservent(void);
453 void		lwres_endservent(void);
454 void		lwres_setservent(int);
455 #endif /* notyet */
456 
457 void		lwres_herror(const char *);
458 const char	*lwres_hstrerror(int);
459 
460 
461 struct hostent	*lwres_gethostbyaddr_r(const char *, int, int, struct hostent *,
462 					char *, int, int *);
463 struct hostent	*lwres_gethostbyname_r(const char *, struct hostent *,
464 					char *, int, int *);
465 struct hostent	*lwres_gethostent_r(struct hostent *, char *, int, int *);
466 void		lwres_sethostent_r(int);
467 void		lwres_endhostent_r(void);
468 
469 #ifdef notyet
470 struct netent	*lwres_getnetbyname_r(const char *, struct netent *,
471 					char *, int);
472 struct netent	*lwres_getnetbyaddr_r(long, int, struct netent *,
473 					char *, int);
474 struct netent	*lwres_getnetent_r(struct netent *, char *, int);
475 void		lwres_setnetent_r(int);
476 void		lwres_endnetent_r(void);
477 
478 struct protoent	*lwres_getprotobyname_r(const char *,
479 				struct protoent *, char *, int);
480 struct protoent	*lwres_getprotobynumber_r(int,
481 				struct protoent *, char *, int);
482 struct protoent	*lwres_getprotoent_r(struct protoent *, char *, int);
483 void		lwres_setprotoent_r(int);
484 void		lwres_endprotoent_r(void);
485 
486 struct servent	*lwres_getservbyname_r(const char *name, const char *,
487 					struct servent *, char *, int);
488 struct servent	*lwres_getservbyport_r(int port, const char *,
489 					struct servent *, char *, int);
490 struct servent	*lwres_getservent_r(struct servent *, char *, int);
491 void		lwres_setservent_r(int);
492 void		lwres_endservent_r(void);
493 #endif	/* notyet */
494 
495 LWRES_LANG_ENDDECLS
496 
497 #ifdef notyet
498 /* This is nec'y to make this include file properly replace the sun version. */
499 #ifdef sun
500 #ifdef __GNU_LIBRARY__
501 #include <rpc/netdb.h>		/* Required. */
502 #else /* !__GNU_LIBRARY__ */
503 struct rpcent {
504 	char	*r_name;	/* name of server for this rpc program */
505 	char	**r_aliases;	/* alias list */
506 	int	r_number;	/* rpc program number */
507 };
508 struct rpcent	*lwres_getrpcbyname();
509 struct rpcent	*lwres_getrpcbynumber(),
510 struct rpcent	*lwres_getrpcent();
511 #endif /* __GNU_LIBRARY__ */
512 #endif /* sun */
513 #endif /* notyet */
514 
515 /*
516  * Tell Emacs to use C mode on this file.
517  * Local variables:
518  * mode: c
519  * End:
520  */
521 
522 #endif /* LWRES_NETDB_H */
523