xref: /curl/lib/curl_addrinfo.h (revision 2bc1d775)
1 #ifndef HEADER_CURL_ADDRINFO_H
2 #define HEADER_CURL_ADDRINFO_H
3 /***************************************************************************
4  *                                  _   _ ____  _
5  *  Project                     ___| | | |  _ \| |
6  *                             / __| | | | |_) | |
7  *                            | (__| |_| |  _ <| |___
8  *                             \___|\___/|_| \_\_____|
9  *
10  * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
11  *
12  * This software is licensed as described in the file COPYING, which
13  * you should have received as part of this distribution. The terms
14  * are also available at https://curl.se/docs/copyright.html.
15  *
16  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
17  * copies of the Software, and permit persons to whom the Software is
18  * furnished to do so, under the terms of the COPYING file.
19  *
20  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
21  * KIND, either express or implied.
22  *
23  * SPDX-License-Identifier: curl
24  *
25  ***************************************************************************/
26 
27 #include "curl_setup.h"
28 
29 #ifdef HAVE_NETINET_IN_H
30 #  include <netinet/in.h>
31 #endif
32 #ifdef HAVE_NETDB_H
33 #  include <netdb.h>
34 #endif
35 #ifdef HAVE_ARPA_INET_H
36 #  include <arpa/inet.h>
37 #endif
38 
39 #ifdef __VMS
40 #  include <in.h>
41 #  include <inet.h>
42 #  include <stdlib.h>
43 #endif
44 
45 /*
46  * Curl_addrinfo is our internal struct definition that we use to allow
47  * consistent internal handling of this data. We use this even when the
48  * system provides an addrinfo structure definition. And we use this for
49  * all sorts of IPv4 and IPV6 builds.
50  */
51 
52 struct Curl_addrinfo {
53   int                   ai_flags;
54   int                   ai_family;
55   int                   ai_socktype;
56   int                   ai_protocol;
57   curl_socklen_t        ai_addrlen;   /* Follow rfc3493 struct addrinfo */
58   char                 *ai_canonname;
59   struct sockaddr      *ai_addr;
60   struct Curl_addrinfo *ai_next;
61 };
62 
63 void
64 Curl_freeaddrinfo(struct Curl_addrinfo *cahead);
65 
66 #ifdef HAVE_GETADDRINFO
67 int
68 Curl_getaddrinfo_ex(const char *nodename,
69                     const char *servname,
70                     const struct addrinfo *hints,
71                     struct Curl_addrinfo **result);
72 #endif
73 
74 struct Curl_addrinfo *
75 Curl_he2ai(const struct hostent *he, int port);
76 
77 struct Curl_addrinfo *
78 Curl_ip2addr(int af, const void *inaddr, const char *hostname, int port);
79 
80 struct Curl_addrinfo *Curl_str2addr(char *dotted, int port);
81 
82 #ifdef USE_UNIX_SOCKETS
83 struct Curl_addrinfo *Curl_unix2addr(const char *path, bool *longpath,
84                                      bool abstract);
85 #endif
86 
87 #if defined(CURLDEBUG) && defined(HAVE_GETADDRINFO) && \
88     defined(HAVE_FREEADDRINFO)
89 void
90 curl_dbg_freeaddrinfo(struct addrinfo *freethis, int line, const char *source);
91 #endif
92 
93 #if defined(CURLDEBUG) && defined(HAVE_GETADDRINFO)
94 int
95 curl_dbg_getaddrinfo(const char *hostname, const char *service,
96                      const struct addrinfo *hints, struct addrinfo **result,
97                      int line, const char *source);
98 #endif
99 
100 #ifdef HAVE_GETADDRINFO
101 #ifdef USE_RESOLVE_ON_IPS
102 void Curl_addrinfo_set_port(struct Curl_addrinfo *addrinfo, int port);
103 #else
104 #define Curl_addrinfo_set_port(x,y)
105 #endif
106 #endif
107 
108 #endif /* HEADER_CURL_ADDRINFO_H */
109