xref: /third_party/curl/lib/curl_addrinfo.h (revision 13498266) 
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
52struct 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
63void
64Curl_freeaddrinfo(struct Curl_addrinfo *cahead);
65
66#ifdef HAVE_GETADDRINFO
67int
68Curl_getaddrinfo_ex(const char *nodename,
69                    const char *servname,
70                    const struct addrinfo *hints,
71                    struct Curl_addrinfo **result);
72#endif
73
74struct Curl_addrinfo *
75Curl_he2ai(const struct hostent *he, int port);
76
77struct Curl_addrinfo *
78Curl_ip2addr(int af, const void *inaddr, const char *hostname, int port);
79
80struct Curl_addrinfo *Curl_str2addr(char *dotted, int port);
81
82#ifdef USE_UNIX_SOCKETS
83struct 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)
89void
90curl_dbg_freeaddrinfo(struct addrinfo *freethis, int line, const char *source);
91#endif
92
93#if defined(CURLDEBUG) && defined(HAVE_GETADDRINFO)
94int
95curl_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
102void 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