1 /** @file 2 3 Copyright (c) 2012, Intel Corporation. All rights reserved.<BR> 4 This program and the accompanying materials 5 are licensed and made available under the terms and conditions of the BSD License 6 which accompanies this distribution. The full text of the license may be found at 7 http://opensource.org/licenses/bsd-license.php 8 9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, 10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 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. Neither the name of the University nor the names of its contributors 24 * may be used to endorse or promote products derived from this software 25 * without specific prior written permission. 26 * 27 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 28 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 29 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 30 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 31 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 32 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 33 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 34 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 35 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 36 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 37 * SUCH DAMAGE. 38 * - 39 * Portions Copyright (c) 1993 by Digital Equipment Corporation. 40 * 41 * Permission to use, copy, modify, and distribute this software for any 42 * purpose with or without fee is hereby granted, provided that the above 43 * copyright notice and this permission notice appear in all copies, and that 44 * the name of Digital Equipment Corporation not be used in advertising or 45 * publicity pertaining to distribution of the document or software without 46 * specific, written prior permission. 47 * 48 * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL 49 * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES 50 * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT 51 * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL 52 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR 53 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS 54 * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 55 * SOFTWARE. 56 * - 57 * Portions Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 58 * All rights reserved. 59 * 60 * Redistribution and use in source and binary forms, with or without 61 * modification, are permitted provided that the following conditions 62 * are met: 63 * 1. Redistributions of source code must retain the above copyright 64 * notice, this list of conditions and the following disclaimer. 65 * 2. Redistributions in binary form must reproduce the above copyright 66 * notice, this list of conditions and the following disclaimer in the 67 * documentation and/or other materials provided with the distribution. 68 * 3. All advertising materials mentioning features or use of this software 69 * must display the following acknowledgement: 70 * This product includes software developed by WIDE Project and 71 * its contributors. 72 * 4. Neither the name of the project nor the names of its contributors 73 * may be used to endorse or promote products derived from this software 74 * without specific prior written permission. 75 * 76 * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND 77 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 78 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 79 * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE 80 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 81 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 82 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 83 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 84 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 85 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 86 * SUCH DAMAGE. 87 * - 88 * @(#)netdb.h 8.1 (Berkeley) 6/2/93 89 * netdb.h,v 1.15.18.6 2006/10/02 01:23:09 marka Exp 90 * netdb.h,v 1.55.2.1 2007/05/17 21:25:10 jdc Exp 91 */ 92 #ifndef _NETDB_H_ 93 #define _NETDB_H_ 94 95 #include <machine/ansi.h> 96 #include <machine/endian_machdep.h> 97 #include <sys/ansi.h> 98 #include <sys/cdefs.h> 99 #include <sys/featuretest.h> 100 #include <inttypes.h> 101 #include <paths.h> 102 103 /* Data types */ 104 #ifndef socklen_t 105 typedef __socklen_t socklen_t; 106 #define socklen_t __socklen_t 107 #endif 108 109 #ifdef _EFI_SIZE_T_ 110 typedef _EFI_SIZE_T_ size_t; 111 #undef _EFI_SIZE_T_ 112 #undef _BSD_SIZE_T_ 113 #endif 114 115 __BEGIN_DECLS 116 extern int h_errno; 117 __END_DECLS 118 119 /** Structures returned by network data base library. All addresses are 120 * supplied in host order, and returned in network order (suitable for 121 * use in system calls). 122 */ 123 struct hostent { 124 char *h_name; /**< official name of host */ 125 char **h_aliases; /**< alias list */ 126 int h_addrtype; /**< host address type */ 127 int h_length; /**< length of address */ 128 char **h_addr_list; /**< list of addresses from name server */ 129 }; 130 #define h_addr h_addr_list[0] /**< address, for backward compatiblity */ 131 132 /** Assumption here is that a network number 133 * fits in an unsigned long -- probably a poor one. 134 */ 135 struct netent { 136 char *n_name; /**< official name of net */ 137 char **n_aliases; /**< alias list */ 138 int n_addrtype; /**< net address type */ 139 uint32_t n_net; /**< network # */ 140 #if defined(__alpha__) || (defined(__i386__) && defined(_LP64)) || \ 141 (defined(__sh__) && defined(_LP64) && (_BYTE_ORDER == _LITTLE_ENDIAN)) 142 int __n_pad0; /* ABI compatibility */ 143 #endif 144 }; 145 146 struct servent { 147 char *s_name; /**< official service name */ 148 char **s_aliases; /**< alias list */ 149 int s_port; /**< port # */ 150 char *s_proto; /**< protocol to use */ 151 }; 152 153 struct protoent { 154 char *p_name; /**< official protocol name */ 155 char **p_aliases; /**< alias list */ 156 int p_proto; /**< protocol # */ 157 }; 158 159 /* Note: ai_addrlen used to be a size_t, per RFC 2553. 160 * In XNS5.2, and subsequently in POSIX-2001 and 161 * draft-ietf-ipngwg-rfc2553bis-02.txt it was changed to a socklen_t. 162 * To accommodate for this while preserving binary compatibility with the 163 * old interface, we prepend or append 32 bits of padding, depending on 164 * the (LP64) architecture's endianness. 165 * 166 * This should be deleted the next time the libc major number is 167 * incremented. 168 */ 169 struct addrinfo { 170 int ai_flags; /**< AI_PASSIVE, AI_CANONNAME */ 171 int ai_family; /**< PF_xxx */ 172 int ai_socktype; /**< SOCK_xxx */ 173 int ai_protocol; /**< 0 or IPPROTO_xxx for IPv4 and IPv6 */ 174 socklen_t ai_addrlen; /**< length of ai_addr */ 175 #if defined(__alpha__) || (defined(__i386__) && defined(_LP64)) 176 int __ai_pad0; /* ABI compatibility */ 177 #endif 178 char *ai_canonname; /**< canonical name for hostname */ 179 struct sockaddr *ai_addr; /**< binary address */ 180 struct addrinfo *ai_next; /**< next structure in linked list */ 181 }; 182 183 /* Error return codes from gethostbyname() and gethostbyaddr() 184 * (left in extern int h_errno). 185 */ 186 187 #define NETDB_INTERNAL -1 /**< see errno */ 188 #define NETDB_SUCCESS 0 /**< no problem */ 189 #define NO_ADDRESS NO_DATA /* no address, look for MX record */ 190 #define HOST_NOT_FOUND 1 /**< Authoritative Answer Host not found */ 191 #define TRY_AGAIN 2 /**< Non-Authoritive Host not found, or SERVERFAIL */ 192 #define NO_RECOVERY 3 /**< Non recoverable errors, FORMERR, REFUSED, NOTIMP */ 193 #define NO_DATA 4 /**< Valid name, no data record of requested type */ 194 195 /* Error return codes from getaddrinfo() */ 196 #define EAI_ADDRFAMILY 1 /**< address family for hostname not supported */ 197 #define EAI_AGAIN 2 /**< temporary failure in name resolution */ 198 #define EAI_BADFLAGS 3 /**< invalid value for ai_flags */ 199 #define EAI_FAIL 4 /**< non-recoverable failure in name resolution */ 200 #define EAI_FAMILY 5 /**< ai_family not supported */ 201 #define EAI_MEMORY 6 /**< memory allocation failure */ 202 #define EAI_NODATA 7 /**< no address associated with hostname */ 203 #define EAI_NONAME 8 /**< hostname nor servname provided, or not known */ 204 #define EAI_SERVICE 9 /**< servname not supported for ai_socktype */ 205 #define EAI_SOCKTYPE 10 /**< ai_socktype not supported */ 206 #define EAI_SYSTEM 11 /**< system error returned in errno */ 207 #define EAI_BADHINTS 12 /**< invalid value for hints */ 208 #define EAI_PROTOCOL 13 /**< resolved protocol is unknown */ 209 #define EAI_OVERFLOW 14 /**< argument buffer overflow */ 210 #define EAI_MAX 15 211 212 /* Flag values for getaddrinfo() */ 213 #define AI_PASSIVE 0x00000001 /* get address to use bind() */ 214 #define AI_CANONNAME 0x00000002 /* fill ai_canonname */ 215 216 #define AI_NUMERICHOST 0x00000004 /* prevent host name resolution */ 217 #define AI_NUMERICSERV 0x00000008 /* prevent service name resolution */ 218 /* valid flags for addrinfo (not a standard def, apps should not use it) */ 219 #define AI_MASK (AI_PASSIVE | AI_CANONNAME | AI_NUMERICHOST | AI_NUMERICSERV) 220 221 /* Constants for getnameinfo() */ 222 #define NI_MAXHOST 1025 223 #define NI_MAXSERV 32 224 225 /* Flag values for getnameinfo() */ 226 #define NI_NOFQDN 0x00000001 227 #define NI_NUMERICHOST 0x00000002 228 #define NI_NAMEREQD 0x00000004 229 #define NI_NUMERICSERV 0x00000008 230 #define NI_DGRAM 0x00000010 231 #define NI_NUMERICSCOPE 0x00000040 232 233 /** Scope delimit character */ 234 #define SCOPE_DELIMITER '%' 235 236 __BEGIN_DECLS 237 void endhostent (void); 238 void endnetent (void); 239 void endprotoent (void); 240 void endservent (void); 241 struct hostent *gethostbyaddr (const char *, socklen_t, int); 242 struct hostent *gethostbyname (const char *); 243 struct hostent *gethostbyname2 (const char *, int); 244 struct hostent *gethostent (void); 245 struct netent *getnetbyaddr (uint32_t, int); 246 struct netent *getnetbyname (const char *); 247 struct netent *getnetent (void); 248 struct protoent *getprotobyname (const char *); 249 struct protoent *getprotobynumber(int); 250 struct protoent *getprotoent (void); 251 struct servent *getservbyname (const char *, const char *); 252 struct servent *getservbyport (int, const char *); 253 struct servent *getservent (void); 254 void sethostent (int); 255 void setnetent (int); 256 void setprotoent (int); 257 void setservent (int); 258 int getaddrinfo ( const char * __restrict, const char * __restrict, 259 const struct addrinfo * __restrict, 260 struct addrinfo ** __restrict); 261 int getnameinfo ( const struct sockaddr * __restrict, socklen_t, 262 char * __restrict, socklen_t, 263 char * __restrict, socklen_t, int); 264 void freeaddrinfo (struct addrinfo *); 265 const char *gai_strerror (int); 266 void setservent (int); 267 268 __END_DECLS 269 270 #endif /* !_NETDB_H_ */ 271