1 /* Copyright (C) 1996-2002, 2003, 2004, 2009 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, see
16 <http://www.gnu.org/licenses/>. */
17
18 /* All data returned by the network data base library are supplied in
19 host order and returned in network order (suitable for use in
20 system calls). */
21
22 #ifndef _NETDB_H
23 #define _NETDB_H 1
24
25 #include <features.h>
26
27 #include <netinet/in.h>
28 #include <stdint.h>
29 #if defined __USE_MISC && defined __UCLIBC_HAS_RPC__
30 /* This is necessary to make this include file properly replace the
31 Sun version. */
32 # include <rpc/netdb.h>
33 #endif
34
35 #ifdef __USE_GNU
36 # define __need_sigevent_t
37 # include <bits/siginfo.h>
38 # define __need_timespec
39 # include <time.h>
40 #endif
41
42 #include <bits/netdb.h>
43
44 /* Absolute file name for network data base files. */
45 #define _PATH_HEQUIV "/etc/hosts.equiv"
46 #define _PATH_HOSTS "/etc/hosts"
47 #define _PATH_NETWORKS "/etc/networks"
48 #define _PATH_NSSWITCH_CONF "/etc/nsswitch.conf"
49 #define _PATH_PROTOCOLS "/etc/protocols"
50 #define _PATH_SERVICES "/etc/services"
51
52
53 __BEGIN_DECLS
54
55 /* Error status for non-reentrant lookup functions.
56 We use a macro to access always the thread-specific `h_errno' variable. */
57 #define h_errno (*__h_errno_location ())
58
59 /* Function to get address of global `h_errno' variable. */
60 extern int *__h_errno_location (void) __THROW __attribute__ ((__const__));
61
62 /* Macros for accessing h_errno from inside libc. */
63 #ifdef _LIBC
64 # ifdef __UCLIBC_HAS_THREADS__
65 # if defined __UCLIBC_HAS_TLS__ \
66 && (!defined NOT_IN_libc || defined IS_IN_libpthread)
67 # undef h_errno
68 # ifndef NOT_IN_libc
69 # define h_errno __libc_h_errno
70 # else
71 # define h_errno h_errno /* For #ifndef h_errno tests. */
72 # endif
73 extern __thread int h_errno attribute_tls_model_ie;
74 # define __set_h_errno(x) (h_errno = (x))
75 # else
__set_h_errno(int __err)76 static inline int __set_h_errno (int __err)
77 {
78 return *__h_errno_location () = __err;
79 }
80 # endif /* __UCLIBC_HAS_TLS__ */
81 # else
82 # undef h_errno
83 # define __set_h_errno(x) (h_errno = (x))
84 extern int h_errno;
85 # endif /* __UCLIBC_HAS_THREADS__ */
86 #endif /* _LIBC */
87
88 /* Possible values left in `h_errno'. */
89 #define HOST_NOT_FOUND 1 /* Authoritative Answer Host not found. */
90 #define TRY_AGAIN 2 /* Non-Authoritative Host not found,
91 or SERVERFAIL. */
92 #define NO_RECOVERY 3 /* Non recoverable errors, FORMERR, REFUSED,
93 NOTIMP. */
94 #define NO_DATA 4 /* Valid name, no data record of requested
95 type. */
96 #if defined __USE_MISC || defined __USE_GNU
97 # define NETDB_INTERNAL -1 /* See errno. */
98 # define NETDB_SUCCESS 0 /* No problem. */
99 # define NO_ADDRESS NO_DATA /* No address, look for MX record. */
100 #endif
101
102 #ifdef __USE_XOPEN2K
103 /* Highest reserved Internet port number. */
104 # define IPPORT_RESERVED 1024
105 #endif
106
107 #ifdef __USE_GNU
108 /* Scope delimiter for getaddrinfo(), getnameinfo(). */
109 # define SCOPE_DELIMITER '%'
110 #endif
111
112 #if defined __USE_MISC || defined __USE_GNU
113 /* Print error indicated by `h_errno' variable on standard error. STR
114 if non-null is printed before the error string. */
115 extern void herror (const char *__str) __THROW;
116 libc_hidden_proto(herror)
117
118 /* Return string associated with error ERR_NUM. */
119 extern const char *hstrerror (int __err_num) __THROW;
120 #endif
121
122
123 /* Description of data base entry for a single host. */
124 struct hostent
125 {
126 char *h_name; /* Official name of host. */
127 char **h_aliases; /* Alias list. */
128 int h_addrtype; /* Host address type. */
129 int h_length; /* Length of address. */
130 char **h_addr_list; /* List of addresses from name server. */
131 #if defined __USE_MISC || defined __USE_GNU
132 # define h_addr h_addr_list[0] /* Address, for backward compatibility.*/
133 #endif
134 };
135
136 /* Open host data base files and mark them as staying open even after
137 a later search if STAY_OPEN is non-zero.
138
139 This function is a possible cancellation point and therefore not
140 marked with __THROW. */
141 extern void sethostent (int __stay_open);
142
143 /* Close host data base files and clear `stay open' flag.
144
145 This function is a possible cancellation point and therefore not
146 marked with __THROW. */
147 extern void endhostent (void);
148
149 /* Get next entry from host data base file. Open data base if
150 necessary.
151
152 This function is a possible cancellation point and therefore not
153 marked with __THROW. */
154 extern struct hostent *gethostent (void);
155
156 /* Return entry from host data base which address match ADDR with
157 length LEN and type TYPE.
158
159 This function is a possible cancellation point and therefore not
160 marked with __THROW. */
161 extern struct hostent *gethostbyaddr (const void *__addr, __socklen_t __len,
162 int __type);
163 libc_hidden_proto(gethostbyaddr)
164
165 /* Return entry from host data base for host with NAME.
166
167 This function is a possible cancellation point and therefore not
168 marked with __THROW. */
169 extern struct hostent *gethostbyname (const char *__name);
170 libc_hidden_proto(gethostbyname)
171
172 #ifdef __USE_MISC
173 /* Return entry from host data base for host with NAME. AF must be
174 set to the address type which is `AF_INET' for IPv4 or `AF_INET6'
175 for IPv6.
176
177 This function is not part of POSIX and therefore no official
178 cancellation point. But due to similarity with an POSIX interface
179 or due to the implementation it is a cancellation point and
180 therefore not marked with __THROW. */
181 extern struct hostent *gethostbyname2 (const char *__name, int __af);
182 libc_hidden_proto(gethostbyname2)
183
184 /* Reentrant versions of the functions above. The additional
185 arguments specify a buffer of BUFLEN starting at BUF. The last
186 argument is a pointer to a variable which gets the value which
187 would be stored in the global variable `herrno' by the
188 non-reentrant functions.
189
190 These functions are not part of POSIX and therefore no official
191 cancellation point. But due to similarity with an POSIX interface
192 or due to the implementation they are cancellation points and
193 therefore not marked with __THROW. */
194 extern int gethostent_r (struct hostent *__restrict __result_buf,
195 char *__restrict __buf, size_t __buflen,
196 struct hostent **__restrict __result,
197 int *__restrict __h_errnop);
198 libc_hidden_proto(gethostent_r)
199
200 extern int gethostbyaddr_r (const void *__restrict __addr, __socklen_t __len,
201 int __type,
202 struct hostent *__restrict __result_buf,
203 char *__restrict __buf, size_t __buflen,
204 struct hostent **__restrict __result,
205 int *__restrict __h_errnop);
206 libc_hidden_proto(gethostbyaddr_r)
207
208 extern int gethostbyname_r (const char *__restrict __name,
209 struct hostent *__restrict __result_buf,
210 char *__restrict __buf, size_t __buflen,
211 struct hostent **__restrict __result,
212 int *__restrict __h_errnop);
213 libc_hidden_proto(gethostbyname_r)
214
215 extern int gethostbyname2_r (const char *__restrict __name, int __af,
216 struct hostent *__restrict __result_buf,
217 char *__restrict __buf, size_t __buflen,
218 struct hostent **__restrict __result,
219 int *__restrict __h_errnop);
220 libc_hidden_proto(gethostbyname2_r)
221 #endif /* misc */
222
223
224 /* Open network data base files and mark them as staying open even
225 after a later search if STAY_OPEN is non-zero.
226
227 This function is a possible cancellation point and therefore not
228 marked with __THROW. */
229 extern void setnetent (int __stay_open);
230 libc_hidden_proto(setnetent)
231
232 /* Close network data base files and clear `stay open' flag.
233
234 This function is a possible cancellation point and therefore not
235 marked with __THROW. */
236 extern void endnetent (void);
237 libc_hidden_proto(endnetent)
238
239 /* Get next entry from network data base file. Open data base if
240 necessary.
241
242 This function is a possible cancellation point and therefore not
243 marked with __THROW. */
244 extern struct netent *getnetent (void);
245
246 /* Return entry from network data base which address match NET and
247 type TYPE.
248
249 This function is a possible cancellation point and therefore not
250 marked with __THROW. */
251 extern struct netent *getnetbyaddr (uint32_t __net, int __type);
252
253 /* Return entry from network data base for network with NAME.
254
255 This function is a possible cancellation point and therefore not
256 marked with __THROW. */
257 extern struct netent *getnetbyname (const char *__name);
258
259 #ifdef __USE_MISC
260 /* Reentrant versions of the functions above. The additional
261 arguments specify a buffer of BUFLEN starting at BUF. The last
262 argument is a pointer to a variable which gets the value which
263 would be stored in the global variable `herrno' by the
264 non-reentrant functions.
265
266 These functions are not part of POSIX and therefore no official
267 cancellation point. But due to similarity with an POSIX interface
268 or due to the implementation they are cancellation points and
269 therefore not marked with __THROW. */
270 extern int getnetent_r (struct netent *__restrict __result_buf,
271 char *__restrict __buf, size_t __buflen,
272 struct netent **__restrict __result,
273 int *__restrict __h_errnop);
274 libc_hidden_proto(getnetent_r)
275
276 extern int getnetbyaddr_r (uint32_t __net, int __type,
277 struct netent *__restrict __result_buf,
278 char *__restrict __buf, size_t __buflen,
279 struct netent **__restrict __result,
280 int *__restrict __h_errnop);
281 libc_hidden_proto(getnetbyaddr_r)
282
283 extern int getnetbyname_r (const char *__restrict __name,
284 struct netent *__restrict __result_buf,
285 char *__restrict __buf, size_t __buflen,
286 struct netent **__restrict __result,
287 int *__restrict __h_errnop);
288 libc_hidden_proto(getnetbyname_r)
289 #endif /* __USE_MISC */
290
291
292 /* Description of data base entry for a single service. */
293 struct servent
294 {
295 char *s_name; /* Official service name. */
296 char **s_aliases; /* Alias list. */
297 int s_port; /* Port number. */
298 char *s_proto; /* Protocol to use. */
299 };
300
301 /* Open service data base files and mark them as staying open even
302 after a later search if STAY_OPEN is non-zero.
303
304 This function is a possible cancellation point and therefore not
305 marked with __THROW. */
306 extern void setservent (int __stay_open);
307 libc_hidden_proto(setservent)
308
309 /* Close service data base files and clear `stay open' flag.
310
311 This function is a possible cancellation point and therefore not
312 marked with __THROW. */
313 extern void endservent (void);
314 libc_hidden_proto(endservent)
315
316 /* Get next entry from service data base file. Open data base if
317 necessary.
318
319 This function is a possible cancellation point and therefore not
320 marked with __THROW. */
321 extern struct servent *getservent (void);
322
323 /* Return entry from network data base for network with NAME and
324 protocol PROTO.
325
326 This function is a possible cancellation point and therefore not
327 marked with __THROW. */
328 extern struct servent *getservbyname (const char *__name,
329 const char *__proto);
330
331 /* Return entry from service data base which matches port PORT and
332 protocol PROTO.
333
334 This function is a possible cancellation point and therefore not
335 marked with __THROW. */
336 extern struct servent *getservbyport (int __port, const char *__proto);
337 libc_hidden_proto(getservbyport)
338
339
340 #ifdef __USE_MISC
341 /* Reentrant versions of the functions above. The additional
342 arguments specify a buffer of BUFLEN starting at BUF.
343
344 These functions are not part of POSIX and therefore no official
345 cancellation point. But due to similarity with an POSIX interface
346 or due to the implementation they are cancellation points and
347 therefore not marked with __THROW. */
348 extern int getservent_r (struct servent *__restrict __result_buf,
349 char *__restrict __buf, size_t __buflen,
350 struct servent **__restrict __result);
351 libc_hidden_proto(getservent_r)
352
353 extern int getservbyname_r (const char *__restrict __name,
354 const char *__restrict __proto,
355 struct servent *__restrict __result_buf,
356 char *__restrict __buf, size_t __buflen,
357 struct servent **__restrict __result);
358 libc_hidden_proto(getservbyname_r)
359
360 extern int getservbyport_r (int __port, const char *__restrict __proto,
361 struct servent *__restrict __result_buf,
362 char *__restrict __buf, size_t __buflen,
363 struct servent **__restrict __result);
364 libc_hidden_proto(getservbyport_r)
365 #endif /* misc */
366
367
368 /* Description of data base entry for a single service. */
369 struct protoent
370 {
371 char *p_name; /* Official protocol name. */
372 char **p_aliases; /* Alias list. */
373 int p_proto; /* Protocol number. */
374 };
375
376 /* Open protocol data base files and mark them as staying open even
377 after a later search if STAY_OPEN is non-zero.
378
379 This function is a possible cancellation point and therefore not
380 marked with __THROW. */
381 extern void setprotoent (int __stay_open);
382 libc_hidden_proto(setprotoent)
383
384 /* Close protocol data base files and clear `stay open' flag.
385
386 This function is a possible cancellation point and therefore not
387 marked with __THROW. */
388 extern void endprotoent (void);
389 libc_hidden_proto(endprotoent)
390
391 /* Get next entry from protocol data base file. Open data base if
392 necessary.
393
394 This function is a possible cancellation point and therefore not
395 marked with __THROW. */
396 extern struct protoent *getprotoent (void);
397
398 /* Return entry from protocol data base for network with NAME.
399
400 This function is a possible cancellation point and therefore not
401 marked with __THROW. */
402 extern struct protoent *getprotobyname (const char *__name);
403
404 /* Return entry from protocol data base which number is PROTO.
405
406 This function is a possible cancellation point and therefore not
407 marked with __THROW. */
408 extern struct protoent *getprotobynumber (int __proto);
409
410
411 #ifdef __USE_MISC
412 /* Reentrant versions of the functions above. The additional
413 arguments specify a buffer of BUFLEN starting at BUF.
414
415 These functions are not part of POSIX and therefore no official
416 cancellation point. But due to similarity with an POSIX interface
417 or due to the implementation they are cancellation points and
418 therefore not marked with __THROW. */
419 extern int getprotoent_r (struct protoent *__restrict __result_buf,
420 char *__restrict __buf, size_t __buflen,
421 struct protoent **__restrict __result);
422 libc_hidden_proto(getprotoent_r)
423
424 extern int getprotobyname_r (const char *__restrict __name,
425 struct protoent *__restrict __result_buf,
426 char *__restrict __buf, size_t __buflen,
427 struct protoent **__restrict __result);
428 libc_hidden_proto(getprotobyname_r)
429
430 extern int getprotobynumber_r (int __proto,
431 struct protoent *__restrict __result_buf,
432 char *__restrict __buf, size_t __buflen,
433 struct protoent **__restrict __result);
434 libc_hidden_proto(getprotobynumber_r)
435
436
437 #ifdef __UCLIBC_HAS_NETGROUP__
438 /* Establish network group NETGROUP for enumeration.
439
440 This function is not part of POSIX and therefore no official
441 cancellation point. But due to similarity with an POSIX interface
442 or due to the implementation it is a cancellation point and
443 therefore not marked with __THROW. */
444 extern int setnetgrent (const char *__netgroup);
445
446 /* Free all space allocated by previous `setnetgrent' call.
447
448 This function is not part of POSIX and therefore no official
449 cancellation point. But due to similarity with an POSIX interface
450 or due to the implementation it is a cancellation point and
451 therefore not marked with __THROW. */
452 extern void endnetgrent (void);
453
454 /* Get next member of netgroup established by last `setnetgrent' call
455 and return pointers to elements in HOSTP, USERP, and DOMAINP.
456
457 This function is not part of POSIX and therefore no official
458 cancellation point. But due to similarity with an POSIX interface
459 or due to the implementation it is a cancellation point and
460 therefore not marked with __THROW. */
461 extern int getnetgrent (char **__restrict __hostp,
462 char **__restrict __userp,
463 char **__restrict __domainp);
464
465
466 /* Test whether NETGROUP contains the triple (HOST,USER,DOMAIN).
467
468 This function is not part of POSIX and therefore no official
469 cancellation point. But due to similarity with an POSIX interface
470 or due to the implementation it is a cancellation point and
471 therefore not marked with __THROW. */
472 extern int innetgr (const char *__netgroup, const char *__host,
473 const char *__user, const char *__domain);
474
475 /* Reentrant version of `getnetgrent' where result is placed in BUFFER.
476
477 This function is not part of POSIX and therefore no official
478 cancellation point. But due to similarity with an POSIX interface
479 or due to the implementation it is a cancellation point and
480 therefore not marked with __THROW. */
481 extern int getnetgrent_r (char **__restrict __hostp,
482 char **__restrict __userp,
483 char **__restrict __domainp,
484 char *__restrict __buffer, size_t __buflen);
485 #endif /* UCLIBC_HAS_NETGROUP */
486 #endif /* misc */
487
488 #ifdef __UCLIBC__
489 /* ruserpass - remote password check.
490 This function also exists in glibc but is undocumented */
491 extern int ruserpass(const char *host, const char **aname, const char **apass);
492 libc_hidden_proto(ruserpass)
493 #endif
494
495 #ifdef __USE_BSD
496 /* Call `rshd' at port RPORT on remote machine *AHOST to execute CMD.
497 The local user is LOCUSER, on the remote machine the command is
498 executed as REMUSER. In *FD2P the descriptor to the socket for the
499 connection is returned. The caller must have the right to use a
500 reserved port. When the function returns *AHOST contains the
501 official host name.
502
503 This function is not part of POSIX and therefore no official
504 cancellation point. But due to similarity with an POSIX interface
505 or due to the implementation it is a cancellation point and
506 therefore not marked with __THROW. */
507 extern int rcmd (char **__restrict __ahost, unsigned short int __rport,
508 const char *__restrict __locuser,
509 const char *__restrict __remuser,
510 const char *__restrict __cmd, int *__restrict __fd2p);
511
512 #if 0
513 /* FIXME */
514 /* This is the equivalent function where the protocol can be selected
515 and which therefore can be used for IPv6.
516
517 This function is not part of POSIX and therefore no official
518 cancellation point. But due to similarity with an POSIX interface
519 or due to the implementation it is a cancellation point and
520 therefore not marked with __THROW. */
521 extern int rcmd_af (char **__restrict __ahost, unsigned short int __rport,
522 const char *__restrict __locuser,
523 const char *__restrict __remuser,
524 const char *__restrict __cmd, int *__restrict __fd2p,
525 sa_family_t __af);
526 #endif
527
528 /* Call `rexecd' at port RPORT on remote machine *AHOST to execute
529 CMD. The process runs at the remote machine using the ID of user
530 NAME whose cleartext password is PASSWD. In *FD2P the descriptor
531 to the socket for the connection is returned. When the function
532 returns *AHOST contains the official host name.
533
534 This function is not part of POSIX and therefore no official
535 cancellation point. But due to similarity with an POSIX interface
536 or due to the implementation it is a cancellation point and
537 therefore not marked with __THROW. */
538 extern int rexec (char **__restrict __ahost, int __rport,
539 const char *__restrict __name,
540 const char *__restrict __pass,
541 const char *__restrict __cmd, int *__restrict __fd2p);
542
543 /* This is the equivalent function where the protocol can be selected
544 and which therefore can be used for IPv6.
545
546 This function is not part of POSIX and therefore no official
547 cancellation point. But due to similarity with an POSIX interface
548 or due to the implementation it is a cancellation point and
549 therefore not marked with __THROW. */
550 extern int rexec_af (char **__restrict __ahost, int __rport,
551 const char *__restrict __name,
552 const char *__restrict __pass,
553 const char *__restrict __cmd, int *__restrict __fd2p,
554 sa_family_t __af);
555 libc_hidden_proto(rexec_af)
556
557 /* Check whether user REMUSER on system RHOST is allowed to login as LOCUSER.
558 If SUSER is not zero the user tries to become superuser. Return 0 if
559 it is possible.
560
561 This function is not part of POSIX and therefore no official
562 cancellation point. But due to similarity with an POSIX interface
563 or due to the implementation it is a cancellation point and
564 therefore not marked with __THROW. */
565 extern int ruserok (const char *__rhost, int __suser,
566 const char *__remuser, const char *__locuser);
567
568 #if 0
569 /* FIXME */
570 /* This is the equivalent function where the protocol can be selected
571 and which therefore can be used for IPv6.
572
573 This function is not part of POSIX and therefore no official
574 cancellation point. But due to similarity with an POSIX interface
575 or due to the implementation it is a cancellation point and
576 therefore not marked with __THROW. */
577 extern int ruserok_af (const char *__rhost, int __suser,
578 const char *__remuser, const char *__locuser,
579 sa_family_t __af);
580 #endif
581
582 /* Try to allocate reserved port, returning a descriptor for a socket opened
583 at this port or -1 if unsuccessful. The search for an available port
584 will start at ALPORT and continues with lower numbers.
585
586 This function is not part of POSIX and therefore no official
587 cancellation point. But due to similarity with an POSIX interface
588 or due to the implementation it is a cancellation point and
589 therefore not marked with __THROW. */
590 extern int rresvport (int *__alport);
591 libc_hidden_proto(rresvport)
592
593 #if 0
594 /* FIXME */
595 /* This is the equivalent function where the protocol can be selected
596 and which therefore can be used for IPv6.
597
598 This function is not part of POSIX and therefore no official
599 cancellation point. But due to similarity with an POSIX interface
600 or due to the implementation it is a cancellation point and
601 therefore not marked with __THROW. */
602 extern int rresvport_af (int *__alport, sa_family_t __af);
603 #endif
604 #endif
605
606
607 /* Extension from POSIX.1g. */
608 #ifdef __USE_POSIX
609 /* Structure to contain information about address of a service provider. */
610 struct addrinfo
611 {
612 int ai_flags; /* Input flags. */
613 int ai_family; /* Protocol family for socket. */
614 int ai_socktype; /* Socket type. */
615 int ai_protocol; /* Protocol for socket. */
616 socklen_t ai_addrlen; /* Length of socket address. */
617 struct sockaddr *ai_addr; /* Socket address for socket. */
618 char *ai_canonname; /* Canonical name for service location. */
619 struct addrinfo *ai_next; /* Pointer to next in list. */
620 };
621
622 /* Possible values for `ai_flags' field in `addrinfo' structure. */
623 # define AI_PASSIVE 0x0001 /* Socket address is intended for `bind'. */
624 # define AI_CANONNAME 0x0002 /* Request for canonical name. */
625 # define AI_NUMERICHOST 0x0004 /* Don't use name resolution. */
626 # define AI_V4MAPPED 0x0008 /* IPv4 mapped addresses are acceptable. */
627 # define AI_ALL 0x0010 /* Return IPv4 mapped and IPv6 addresses. */
628 # define AI_ADDRCONFIG 0x0020 /* Use configuration of this host to choose
629 returned address type.. */
630 # ifdef __USE_GNU
631 # define AI_IDN 0x0040 /* IDN encode input (assuming it is encoded
632 in the current locale's character set)
633 before looking it up. */
634 # define AI_CANONIDN 0x0080 /* Translate canonical name from IDN format. */
635 # define AI_IDN_ALLOW_UNASSIGNED 0x0100 /* Don't reject unassigned Unicode
636 code points. */
637 # define AI_IDN_USE_STD3_ASCII_RULES 0x0200 /* Validate strings according to
638 STD3 rules. */
639 # endif
640 # define AI_NUMERICSERV 0x0400 /* Don't use name resolution. */
641
642 /* Error values for `getaddrinfo' function. */
643 # define EAI_BADFLAGS -1 /* Invalid value for `ai_flags' field. */
644 # define EAI_NONAME -2 /* NAME or SERVICE is unknown. */
645 # define EAI_AGAIN -3 /* Temporary failure in name resolution. */
646 # define EAI_FAIL -4 /* Non-recoverable failure in name res. */
647 # define EAI_FAMILY -6 /* `ai_family' not supported. */
648 # define EAI_SOCKTYPE -7 /* `ai_socktype' not supported. */
649 # define EAI_SERVICE -8 /* SERVICE not supported for `ai_socktype'. */
650 # define EAI_MEMORY -10 /* Memory allocation failure. */
651 # define EAI_SYSTEM -11 /* System error returned in `errno'. */
652 # define EAI_OVERFLOW -12 /* Argument buffer overflow. */
653 # ifdef __USE_GNU
654 # define EAI_NODATA -5 /* No address associated with NAME. */
655 # define EAI_ADDRFAMILY -9 /* Address family for NAME not supported. */
656 # define EAI_INPROGRESS -100 /* Processing request in progress. */
657 # define EAI_CANCELED -101 /* Request canceled. */
658 # define EAI_NOTCANCELED -102 /* Request not canceled. */
659 # define EAI_ALLDONE -103 /* All requests done. */
660 # define EAI_INTR -104 /* Interrupted by a signal. */
661 # define EAI_IDN_ENCODE -105 /* IDN encoding failed. */
662 # endif
663
664 # ifdef __USE_MISC
665 # define NI_MAXHOST 1025
666 # define NI_MAXSERV 32
667 # endif
668
669 # define NI_NUMERICHOST 1 /* Don't try to look up hostname. */
670 # define NI_NUMERICSERV 2 /* Don't convert port number to name. */
671 # define NI_NOFQDN 4 /* Only return nodename portion. */
672 # define NI_NAMEREQD 8 /* Don't return numeric addresses. */
673 # define NI_DGRAM 16 /* Look up UDP service rather than TCP. */
674 # ifdef __USE_GNU
675 # define NI_IDN 32 /* Convert name from IDN format. */
676 # define NI_IDN_ALLOW_UNASSIGNED 64 /* Don't reject unassigned Unicode
677 code points. */
678 # define NI_IDN_USE_STD3_ASCII_RULES 128 /* Validate strings according to
679 STD3 rules. */
680 # endif
681
682 /* Translate name of a service location and/or a service name to set of
683 socket addresses.
684
685 This function is a possible cancellation point and therefore not
686 marked with __THROW. */
687 extern int getaddrinfo (const char *__restrict __name,
688 const char *__restrict __service,
689 const struct addrinfo *__restrict __req,
690 struct addrinfo **__restrict __pai);
691 libc_hidden_proto(getaddrinfo)
692
693 /* Free `addrinfo' structure AI including associated storage. */
694 extern void freeaddrinfo (struct addrinfo *__ai) __THROW;
695 libc_hidden_proto(freeaddrinfo)
696
697 /* Convert error return from getaddrinfo() to a string. */
698 extern const char *gai_strerror (int __ecode) __THROW;
699
700 /* Translate a socket address to a location and service name.
701
702 This function is a possible cancellation point and therefore not
703 marked with __THROW. */
704 extern int getnameinfo (const struct sockaddr *__restrict __sa,
705 socklen_t __salen, char *__restrict __host,
706 socklen_t __hostlen, char *__restrict __serv,
707 socklen_t __servlen, unsigned int __flags);
708 libc_hidden_proto(getnameinfo)
709 #endif /* POSIX */
710
711 __END_DECLS
712
713 #endif /* netdb.h */
714