getaddrinfo.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 1996-2017 The Squid Software Foundation and contributors
3  *
4  * Squid software is distributed under GPLv2+ license and includes
5  * contributions from numerous individuals and organizations.
6  * Please see the COPYING and CONTRIBUTORS files for details.
7  */
8 
9 #ifndef _getaddrinfo_h
10 #define _getaddrinfo_h
11 
12 /*
13  * Shamelessly duplicated from the fetchmail public sources
14  * for use by the Squid Project under GNU Public License.
15  *
16  * Update/Maintenance History:
17  *
18  * 15-Aug-2007 : Copied from fetchmail 6.3.8
19  * - added protection around libray headers
20  *
21  * 16-Aug-2007 : Altered configure checks
22  * Un-hacked slightly to use system gethostbyname()
23  *
24  * Original License and code follows.
25  */
26 
27 /*
28  * This file is part of libESMTP, a library for submission of RFC 2822
29  * formatted electronic mail messages using the SMTP protocol described
30  * in RFC 2821.
31  *
32  * Copyright (C) 2001,2002 Brian Stafford <brian@stafford.uklinux.net>
33  *
34  * This library is free software; you can redistribute it and/or
35  * modify it under the terms of the GNU Lesser General Public
36  * License as published by the Free Software Foundation; either
37  * version 2.1 of the License, or (at your option) any later version.
38  *
39  * This library is distributed in the hope that it will be useful,
40  * but WITHOUT ANY WARRANTY; without even the implied warranty of
41  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
42  * Lesser General Public License for more details.
43  *
44  * You should have received a copy of the GNU Lesser General Public
45  * License along with this library; if not, write to the Free Software
46  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
47  */
48 
49 /* Structure and prototypes taken from RFC 2553 */
50 
51 /* These functions are provided by the OS */
52 #if !HAVE_DECL_GETADDRINFO
53 
54 /* SG 23/09/2007:
55 On Windows the following definitions are already available, may be that
56 this could be needed on some other platform */
57 #if 0
58 struct addrinfo {
59  int ai_flags; /* AI_PASSIVE, AI_CANONNAME, AI_NUMERICHOST */
60  int ai_family; /* PF_xxx */
61  int ai_socktype; /* SOCK_xxx */
62  int ai_protocol; /* 0 or IPPROTO_xxx for IPv4 and IPv6 */
63  socklen_t ai_addrlen; /* length of ai_addr */
64  char *ai_canonname; /* canonical name for nodename */
65  struct sockaddr *ai_addr; /* binary address */
66  struct addrinfo *ai_next; /* next structure in linked list */
67 };
68 
69 /* Supposed to be defined in <netdb.h> */
70 #define AI_PASSIVE 1 /* Socket address is intended for `bind'. */
71 #define AI_CANONNAME 2 /* Request for canonical name. */
72 #define AI_NUMERICHOST 4 /* Don't use name resolution. */
73 
74 /* Supposed to be defined in <netdb.h> */
75 #define EAI_ADDRFAMILY 1 /* address family for nodename not supported */
76 #define EAI_AGAIN 2 /* temporary failure in name resolution */
77 #define EAI_BADFLAGS 3 /* invalid value for ai_flags */
78 #define EAI_FAIL 4 /* non-recoverable failure in name resolution */
79 #define EAI_FAMILY 5 /* ai_family not supported */
80 #define EAI_MEMORY 6 /* memory allocation failure */
81 #define EAI_NODATA 7 /* no address associated with nodename */
82 #define EAI_NONAME 8 /* nodename nor servname provided, or not known */
83 #define EAI_SERVICE 9 /* servname not supported for ai_socktype */
84 #define EAI_SOCKTYPE 10 /* ai_socktype not supported */
85 #endif
86 #ifndef EAI_SYSTEM
87 /* Not defined on mingw32. */
88 #define EAI_SYSTEM 11 /* System error returned in `errno'. */
89 #endif
90 #ifndef EAI_OVERFLOW
91 /* Not defined on mingw32. */
92 #define EAI_OVERFLOW 12 /* Argument buffer overflow. */
93 #endif
94 
95 #ifndef IN_EXPERIMENTAL
96 #define IN_EXPERIMENTAL(a) \
97  ((((long int) (a)) & 0xf0000000) == 0xf0000000)
98 #endif
99 
100 /* RFC 2553 / Posix resolver */
101 SQUIDCEXTERN int xgetaddrinfo (const char *nodename, const char *servname,
102  const struct addrinfo *hints, struct addrinfo **res);
103 #define getaddrinfo xgetaddrinfo
104 
105 /* Free addrinfo structure and associated storage */
106 SQUIDCEXTERN void xfreeaddrinfo (struct addrinfo *ai);
107 #define freeaddrinfo xfreeaddrinfo
108 
109 /* Convert error return from getaddrinfo() to string */
110 SQUIDCEXTERN const char *xgai_strerror (int code);
111 #if !defined(gai_strerror)
112 #define gai_strerror xgai_strerror
113 #endif
114 
115 #endif /* HAVE_DECL_GETADDRINFO */
116 #endif /* _getaddrinfo_h */
117 
int socklen_t
Definition: types.h:158
SQUIDCEXTERN int xgetaddrinfo(const char *nodename, const char *servname, const struct addrinfo *hints, struct addrinfo **res)
Definition: getaddrinfo.cc:101
SQUIDCEXTERN const char * xgai_strerror(int code)
Definition: getaddrinfo.cc:311
SQUIDCEXTERN void xfreeaddrinfo(struct addrinfo *ai)
Definition: getaddrinfo.cc:295
#define SQUIDCEXTERN
Definition: squid.h:26
struct addrinfo * ai_next
unsigned char code
Definition: html_quote.c:20
socklen_t ai_addrlen
struct sockaddr * ai_addr

 

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors