xref: /illumos-gate/usr/src/head/netdb.h (revision 9525b14b)
1 /*
2  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
3  * Use is subject to license terms.
4  */
5 
6 /*	Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T	*/
7 /*	  All Rights Reserved  	*/
8 
9 /*
10  * BIND 4.9.3:
11  *
12  * Copyright (c) 1980, 1983, 1988, 1993
13  *	The Regents of the University of California.  All rights reserved.
14  *
15  * Redistribution and use in source and binary forms, with or without
16  * modification, are permitted provided that the following conditions
17  * are met:
18  * 1. Redistributions of source code must retain the above copyright
19  *    notice, this list of conditions and the following disclaimer.
20  * 2. Redistributions in binary form must reproduce the above copyright
21  *    notice, this list of conditions and the following disclaimer in the
22  *    documentation and/or other materials provided with the distribution.
23  * 3. All advertising materials mentioning features or use of this software
24  *    must display the following acknowledgement:
25  *	This product includes software developed by the University of
26  *	California, Berkeley and its contributors.
27  * 4. Neither the name of the University nor the names of its contributors
28  *    may be used to endorse or promote products derived from this software
29  *    without specific prior written permission.
30  *
31  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
32  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
33  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
34  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
35  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
39  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
40  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
41  * SUCH DAMAGE.
42  * -
43  * Portions Copyright (c) 1993 by Digital Equipment Corporation.
44  *
45  * Permission to use, copy, modify, and distribute this software for any
46  * purpose with or without fee is hereby granted, provided that the above
47  * copyright notice and this permission notice appear in all copies, and that
48  * the name of Digital Equipment Corporation not be used in advertising or
49  * publicity pertaining to distribution of the document or software without
50  * specific, written prior permission.
51  *
52  * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
53  * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
54  * OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
55  * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
56  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
57  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
58  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
59  * SOFTWARE.
60  * --Copyright--
61  *
62  * End BIND 4.9.3
63  */
64 
65 /*
66  * Structures returned by network data base library.
67  * All addresses are supplied in host order, and
68  * returned in network order (suitable for use in system calls).
69  */
70 
71 #ifndef _NETDB_H
72 #define	_NETDB_H
73 
74 #include <sys/types.h>
75 #include <netinet/in.h>
76 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
77 #include <sys/socket.h>
78 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
79 #include <sys/feature_tests.h>
80 
81 #ifdef	__cplusplus
82 extern "C" {
83 #endif
84 
85 #define	_PATH_HEQUIV	"/etc/hosts.equiv"
86 #define	_PATH_HOSTS	"/etc/hosts"
87 #define	_PATH_IPNODES	"/etc/inet/ipnodes"
88 #define	_PATH_IPSECALGS	"/etc/inet/ipsecalgs"
89 #define	_PATH_NETMASKS	"/etc/netmasks"
90 #define	_PATH_NETWORKS	"/etc/networks"
91 #define	_PATH_PROTOCOLS	"/etc/protocols"
92 #define	_PATH_SERVICES	"/etc/services"
93 
94 struct	hostent {
95 	char	*h_name;	/* official name of host */
96 	char	**h_aliases;	/* alias list */
97 	int	h_addrtype;	/* host address type */
98 	int	h_length;	/* length of address */
99 	char	**h_addr_list;	/* list of addresses from name server */
100 #define	h_addr	h_addr_list[0]	/* address, for backward compatiblity */
101 };
102 
103 
104 /*
105  * addrinfo introduced with IPv6 for Protocol-Independent Hostname
106  * and Service Name Translation.
107  */
108 
109 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
110 struct addrinfo {
111 	int ai_flags;		/* AI_PASSIVE, AI_CANONNAME, ... */
112 	int ai_family;		/* PF_xxx */
113 	int ai_socktype;	/* SOCK_xxx */
114 	int ai_protocol;	/* 0 or IPPROTO_xxx for IPv4 and IPv6 */
115 #ifdef __sparcv9
116 	int _ai_pad;		/* for backwards compat with old size_t */
117 #endif /* __sparcv9 */
118 	socklen_t ai_addrlen;
119 	char *ai_canonname;	/* canonical name for hostname */
120 	struct sockaddr *ai_addr;	/* binary address */
121 	struct addrinfo *ai_next;	/* next structure in linked list */
122 };
123 
124 
125 /* addrinfo flags */
126 #define	AI_PASSIVE	0x0008	/* intended for bind() + listen() */
127 #define	AI_CANONNAME	0x0010	/* return canonical version of host */
128 #define	AI_NUMERICHOST	0x0020	/* use numeric node address string */
129 #define	AI_NUMERICSERV	0x0040	/* servname is assumed numeric */
130 
131 /* getipnodebyname() flags */
132 #define	AI_V4MAPPED	0x0001	/* IPv4 mapped addresses if no IPv6 */
133 #define	AI_ALL		0x0002	/* IPv6 and IPv4 mapped addresses */
134 #define	AI_ADDRCONFIG	0x0004	/* AAAA or A records only if IPv6/IPv4 cnfg'd */
135 
136 
137 /*
138  * These were defined in RFC 2553 but not SUSv3
139  * or RFC 3493 which obsoleted 2553.
140  */
141 #if !defined(_XPG6) || defined(__EXTENSIONS__)
142 #define	AI_DEFAULT	(AI_V4MAPPED | AI_ADDRCONFIG)
143 
144 /* addrinfo errors */
145 #define	EAI_ADDRFAMILY	1	/* address family not supported */
146 #define	EAI_NODATA	7	/* no address */
147 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
148 #define	EAI_AGAIN	2	/* DNS temporary failure */
149 #define	EAI_BADFLAGS	3	/* invalid ai_flags */
150 #define	EAI_FAIL	4	/* DNS non-recoverable failure */
151 #define	EAI_FAMILY	5	/* ai_family not supported */
152 #define	EAI_MEMORY	6	/* memory allocation failure */
153 #define	EAI_NONAME	8	/* host/servname not known */
154 #define	EAI_SERVICE	9	/* servname not supported for ai_socktype */
155 #define	EAI_SOCKTYPE	10	/* ai_socktype not supported */
156 #define	EAI_SYSTEM	11	/* system error in errno */
157 #define	EAI_OVERFLOW	12	/* argument buffer overflow */
158 #define	EAI_PROTOCOL	13
159 #define	EAI_MAX		14
160 
161 /* getnameinfo flags */
162 #define	NI_NOFQDN	0x0001
163 #define	NI_NUMERICHOST	0x0002	/* return numeric form of address */
164 #define	NI_NAMEREQD	0x0004	/* request DNS name */
165 #define	NI_NUMERICSERV	0x0008
166 #define	NI_DGRAM	0x0010
167 
168 #if !defined(_XPG6) || defined(__EXTENSIONS__)
169 /* Not listed in any standards document */
170 #define	NI_WITHSCOPEID  0x0020
171 #define	NI_NUMERICSCOPE 0x0040
172 
173 /* getnameinfo max sizes as defined in RFC 2553 obsoleted in RFC 3493 */
174 #define	NI_MAXHOST	1025
175 #define	NI_MAXSERV	32
176 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
177 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
178 
179 /*
180  * Scope delimit character
181  */
182 #define	SCOPE_DELIMITER	'%'
183 
184 
185 /*
186  * Algorithm entry for /etc/inet/ipsecalgs which defines IPsec protocols
187  * and algorithms.
188  */
189 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
190 typedef struct ipsecalgent {
191 	char **a_names;		/* algorithm names */
192 	int a_proto_num;	/* protocol number */
193 	int a_alg_num;		/* algorithm number */
194 	char *a_mech_name;	/* encryption framework mechanism name */
195 	int *a_block_sizes;	/* supported block sizes */
196 	int *a_key_sizes;	/* supported key sizes */
197 	int a_key_increment;	/* key size increment */
198 	int *a_mech_params;	/* mechanism specific parameters */
199 	int a_alg_flags;	/* algorithm flags */
200 } ipsecalgent_t;
201 
202 /* well-known IPsec protocol numbers */
203 
204 #define	IPSEC_PROTO_AH		2
205 #define	IPSEC_PROTO_ESP		3
206 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
207 
208 /*
209  * Assumption here is that a network number
210  * fits in 32 bits -- probably a poor one.
211  */
212 struct	netent {
213 	char		*n_name;	/* official name of net */
214 	char		**n_aliases;	/* alias list */
215 	int		n_addrtype;	/* net address type */
216 	in_addr_t	n_net;		/* network # */
217 };
218 
219 struct	protoent {
220 	char	*p_name;	/* official protocol name */
221 	char	**p_aliases;	/* alias list */
222 	int	p_proto;	/* protocol # */
223 };
224 
225 struct	servent {
226 	char	*s_name;	/* official service name */
227 	char	**s_aliases;	/* alias list */
228 	int	s_port;		/* port # */
229 	char	*s_proto;	/* protocol to use */
230 };
231 
232 #ifdef	__STDC__
233 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
234 struct hostent	*gethostbyname_r
235 	(const char *, struct hostent *, char *, int, int *h_errnop);
236 struct hostent	*gethostbyaddr_r
237 	(const char *, int, int, struct hostent *, char *, int, int *h_errnop);
238 struct hostent	*getipnodebyname(const char *, int, int, int *);
239 struct hostent	*getipnodebyaddr(const void *, size_t, int, int *);
240 void		freehostent(struct hostent *);
241 struct hostent	*gethostent_r(struct hostent *, char *, int, int *h_errnop);
242 
243 struct servent	*getservbyname_r
244 	(const char *name, const char *, struct servent *, char *, int);
245 struct servent	*getservbyport_r
246 	(int port, const char *, struct servent *, char *, int);
247 struct servent	*getservent_r(struct	servent *, char *, int);
248 
249 struct netent	*getnetbyname_r
250 	(const char *, struct netent *, char *, int);
251 struct netent	*getnetbyaddr_r(long, int, struct netent *, char *, int);
252 struct netent	*getnetent_r(struct netent *, char *, int);
253 
254 struct protoent	*getprotobyname_r
255 	(const char *, struct protoent *, char *, int);
256 struct protoent	*getprotobynumber_r
257 	(int, struct protoent *, char *, int);
258 struct protoent	*getprotoent_r(struct protoent *, char *, int);
259 
260 int getnetgrent_r(char **, char **, char **, char *, int);
261 int innetgr(const char *, const char *, const char *, const char *);
262 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
263 
264 /* Old interfaces that return a pointer to a static area;  MT-unsafe */
265 struct hostent	*gethostbyname(const char *);
266 struct hostent	*gethostent(void);
267 struct netent	*getnetbyaddr(in_addr_t, int);
268 struct netent	*getnetbyname(const char *);
269 struct netent	*getnetent(void);
270 struct protoent	*getprotobyname(const char *);
271 struct protoent	*getprotobynumber(int);
272 struct protoent	*getprotoent(void);
273 struct servent	*getservbyname(const char *, const char *);
274 struct servent	*getservbyport(int, const char *);
275 struct servent	*getservent(void);
276 
277 /* gethostbyaddr() second argument is a size_t only in unix95/unix98 */
278 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
279 struct hostent	*gethostbyaddr(const void *, socklen_t, int);
280 #else
281 struct hostent	*gethostbyaddr(const void *, size_t, int);
282 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
283 
284 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
285 int endhostent(void);
286 int endnetent(void);
287 int endprotoent(void);
288 int endservent(void);
289 int sethostent(int);
290 int setnetent(int);
291 int setprotoent(int);
292 int setservent(int);
293 #else
294 void endhostent(void);
295 void endnetent(void);
296 void endprotoent(void);
297 void endservent(void);
298 void sethostent(int);
299 void setnetent(int);
300 void setprotoent(int);
301 void setservent(int);
302 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
303 
304 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
305 
306 #ifdef	_XPG6
307 #ifdef	__PRAGMA_REDEFINE_EXTNAME
308 #pragma redefine_extname getaddrinfo __xnet_getaddrinfo
309 #else	/* __PRAGMA_REDEFINE_EXTNAME */
310 #define	getaddrinfo __xnet_getaddrinfo
311 #endif	/* __PRAGMA_REDEFINE_EXTNAME */
312 #endif	/* _XPG6 */
313 
314 int		getaddrinfo(const char *_RESTRICT_KYWD,
315 			const char *_RESTRICT_KYWD,
316 			const struct addrinfo *_RESTRICT_KYWD,
317 			struct addrinfo **_RESTRICT_KYWD);
318 void		freeaddrinfo(struct addrinfo *);
319 const char	*gai_strerror(int);
320 int		getnameinfo(const struct sockaddr *_RESTRICT_KYWD,
321 			socklen_t, char *_RESTRICT_KYWD, socklen_t,
322 			char *_RESTRICT_KYWD, socklen_t, int);
323 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
324 
325 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
326 int getnetgrent(char **, char **, char **);
327 int setnetgrent(const char *);
328 int endnetgrent(void);
329 int rcmd(char **, unsigned short,
330 	const char *, const char *, const char *, int *);
331 int rcmd_af(char **, unsigned short,
332 	const char *, const char *, const char *, int *, int);
333 int rresvport_af(int *, int);
334 int rresvport_addr(int *, struct sockaddr_storage *);
335 int rexec(char **, unsigned short,
336 	const char *, const char *, const char *, int *);
337 int rexec_af(char **, unsigned short,
338 	const char *, const char *, const char *, int *, int);
339 int rresvport(int *);
340 int ruserok(const char *, int, const char *, const char *);
341 /* BIND */
342 struct hostent	*gethostbyname2(const char *, int);
343 void		herror(const char *);
344 const char	*hstrerror(int);
345 /* End BIND */
346 
347 /* IPsec algorithm prototype definitions */
348 struct ipsecalgent *getipsecalgbyname(const char *, int, int *);
349 struct ipsecalgent *getipsecalgbynum(int, int, int *);
350 int getipsecprotobyname(const char *doi_name);
351 char *getipsecprotobynum(int doi_domain);
352 void freeipsecalgent(struct ipsecalgent *ptr);
353 /* END IPsec algorithm prototype definitions */
354 
355 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
356 #else	/* __STDC__ */
357 struct hostent	*gethostbyname_r();
358 struct hostent	*gethostbyaddr_r();
359 struct hostent	*getipnodebyname();
360 struct hostent	*getipnodebyaddr();
361 void		 freehostent();
362 struct hostent	*gethostent_r();
363 struct servent	*getservbyname_r();
364 struct servent	*getservbyport_r();
365 struct servent	*getservent_r();
366 struct netent	*getnetbyname_r();
367 struct netent	*getnetbyaddr_r();
368 struct netent	*getnetent_r();
369 struct protoent	*getprotobyname_r();
370 struct protoent	*getprotobynumber_r();
371 struct protoent	*getprotoent_r();
372 int		 getnetgrent_r();
373 int		 innetgr();
374 
375 /* Old interfaces that return a pointer to a static area;  MT-unsafe */
376 struct hostent	*gethostbyname();
377 struct hostent	*gethostbyaddr();
378 struct hostent	*gethostent();
379 struct netent	*getnetbyname();
380 struct netent	*getnetbyaddr();
381 struct netent	*getnetent();
382 struct servent	*getservbyname();
383 struct servent	*getservbyport();
384 struct servent	*getservent();
385 struct protoent	*getprotobyname();
386 struct protoent	*getprotobynumber();
387 struct protoent	*getprotoent();
388 int		 getnetgrent();
389 
390 int sethostent();
391 int endhostent();
392 int setnetent();
393 int endnetent();
394 int setservent();
395 int endservent();
396 int setprotoent();
397 int endprotoent();
398 int setnetgrent();
399 int endnetgrent();
400 int rcmd();
401 int rcmd_af();
402 int rexec();
403 int rexec_af();
404 int rresvport();
405 int rresvport_af();
406 int rresvport_addr();
407 int ruserok();
408 /* BIND */
409 struct hostent	*gethostbyname2();
410 void		herror();
411 char		*hstrerror();
412 /* IPv6 prototype definitons */
413 int		getaddrinfo();
414 void		freeaddrinfo();
415 const char	*gai_strerror();
416 int		getnameinfo();
417 /* END IPv6 prototype definitions */
418 /* End BIND */
419 
420 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
421 /* IPsec algorithm prototype definitions */
422 struct ipsecalgent *getalgbyname();
423 struct ipsecalgent *getalgbydoi();
424 int getdoidomainbyname();
425 const char *getdoidomainbynum();
426 void freealgent();
427 /* END IPsec algorithm prototype definitions */
428 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
429 
430 #endif	/* __STDC__ */
431 
432 /*
433  * Error return codes from gethostbyname() and gethostbyaddr()
434  * (when using the resolver)
435  */
436 
437 extern  int h_errno;
438 
439 #ifdef	_REENTRANT
440 #ifdef	__STDC__
441 extern int	*__h_errno(void);
442 #else
443 extern int	*__h_errno();
444 #endif	/* __STDC__ */
445 
446 /* Only #define h_errno if there is no conflict with other use */
447 #ifdef	H_ERRNO_IS_FUNCTION
448 #define	h_errno	(*__h_errno())
449 #endif	/* NO_H_ERRNO_DEFINE */
450 #endif	/* _REENTRANT */
451 
452 /*
453  * Error return codes from gethostbyname() and gethostbyaddr()
454  * (left in extern int h_errno).
455  */
456 #define	HOST_NOT_FOUND	1 /* Authoritive Answer Host not found */
457 #define	TRY_AGAIN	2 /* Non-Authoritive Host not found, or SERVERFAIL */
458 #define	NO_RECOVERY	3 /* Non recoverable errors, FORMERR, REFUSED, NOTIMP */
459 #define	NO_DATA		4 /* Valid name, no data record of requested type */
460 
461 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
462 #define	NO_ADDRESS	NO_DATA		/* no address, look for MX record */
463 
464 /* BIND */
465 #define	NETDB_INTERNAL	-1	/* see errno */
466 #define	NETDB_SUCCESS	0	/* no problem */
467 /* End BIND */
468 
469 #define	MAXHOSTNAMELEN	256
470 
471 #define	MAXALIASES	35
472 #define	MAXADDRS	35
473 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
474 
475 #ifdef	__cplusplus
476 }
477 #endif
478 
479 #endif	/* _NETDB_H */
480