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