mirror of
https://github.com/curl/curl.git
synced 2026-04-11 12:01:42 +08:00
188 lines
6.7 KiB
C
188 lines
6.7 KiB
C
#ifndef HEADER_CURL_HOSTIP_H
|
|
#define HEADER_CURL_HOSTIP_H
|
|
/***************************************************************************
|
|
* _ _ ____ _
|
|
* Project ___| | | | _ \| |
|
|
* / __| | | | |_) | |
|
|
* | (__| |_| | _ <| |___
|
|
* \___|\___/|_| \_\_____|
|
|
*
|
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
*
|
|
* This software is licensed as described in the file COPYING, which
|
|
* you should have received as part of this distribution. The terms
|
|
* are also available at https://curl.se/docs/copyright.html.
|
|
*
|
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
* copies of the Software, and permit persons to whom the Software is
|
|
* furnished to do so, under the terms of the COPYING file.
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
* KIND, either express or implied.
|
|
*
|
|
* SPDX-License-Identifier: curl
|
|
*
|
|
***************************************************************************/
|
|
#include "curl_setup.h"
|
|
|
|
#include "hash.h"
|
|
#include "curlx/timeval.h" /* for curltime, timediff_t */
|
|
|
|
/* Allocate enough memory to hold the full name information structs and
|
|
* everything. OSF1 is known to require at least 8872 bytes. The buffer
|
|
* required for storing all possible aliases and IP numbers is according to
|
|
* Stevens' Unix Network Programming 2nd edition, p. 304: 8192 bytes!
|
|
*/
|
|
#define CURL_HOSTENT_SIZE 9000
|
|
|
|
#define CURL_TIMEOUT_RESOLVE_MS (300 * 1000)
|
|
|
|
struct addrinfo;
|
|
struct hostent;
|
|
struct Curl_easy;
|
|
struct connectdata;
|
|
struct easy_pollset;
|
|
struct Curl_https_rrinfo;
|
|
struct Curl_multi;
|
|
struct Curl_dns_entry;
|
|
|
|
/* DNS query types */
|
|
#define CURL_DNSQ_A (1U << 0)
|
|
#define CURL_DNSQ_AAAA (1U << 1)
|
|
#define CURL_DNSQ_HTTPS (1U << 2)
|
|
|
|
#define CURL_DNSQ_ALL (CURL_DNSQ_A|CURL_DNSQ_AAAA|CURL_DNSQ_HTTPS)
|
|
#define CURL_DNSQ_IP(x) (uint8_t)((x)&(CURL_DNSQ_A|CURL_DNSQ_AAAA))
|
|
|
|
#ifdef CURLVERBOSE
|
|
const char *Curl_resolv_query_str(uint8_t dns_queries);
|
|
#endif
|
|
|
|
/* Return CURL_DNSQ_* bits for the transfer and ip_version. */
|
|
uint8_t Curl_resolv_dns_queries(struct Curl_easy *data, uint8_t ip_version);
|
|
|
|
enum alpnid {
|
|
ALPN_none = 0,
|
|
ALPN_h1 = CURLALTSVC_H1,
|
|
ALPN_h2 = CURLALTSVC_H2,
|
|
ALPN_h3 = CURLALTSVC_H3
|
|
};
|
|
|
|
bool Curl_host_is_ipnum(const char *hostname);
|
|
|
|
#ifdef USE_IPV6
|
|
|
|
/* probe if it seems to work */
|
|
CURLcode Curl_probeipv6(struct Curl_multi *multi);
|
|
/*
|
|
* Curl_ipv6works() returns TRUE if IPv6 seems to work.
|
|
*/
|
|
bool Curl_ipv6works(struct Curl_easy *data);
|
|
#else
|
|
#define Curl_probeipv6(x) CURLE_OK
|
|
#define Curl_ipv6works(x) FALSE
|
|
#endif
|
|
|
|
/* IPv4 thread-safe resolve function used for synch and asynch builds */
|
|
struct Curl_addrinfo *Curl_ipv4_resolve_r(const char *hostname, uint16_t port);
|
|
|
|
/*
|
|
* Curl_printable_address() returns a printable version of the 1st address
|
|
* given in the 'ip' argument. The result will be stored in the buf that is
|
|
* bufsize bytes big.
|
|
*/
|
|
void Curl_printable_address(const struct Curl_addrinfo *ip,
|
|
char *buf, size_t bufsize);
|
|
|
|
/* Start DNS resolving for the given parameters. Returns
|
|
* - CURLE_OK: `*pdns` is the resolved DNS entry (needs to be unlinked).
|
|
* `*presolv_id` is 0.
|
|
* - CURLE_AGAIN: resolve is asynchronous and not finished yet.
|
|
* `presolv_id` is the identifier for querying results later.
|
|
* - other: the operation failed, `*pdns` is NULL, `*presolv_id` is 0.
|
|
*/
|
|
CURLcode Curl_resolv(struct Curl_easy *data,
|
|
uint8_t dns_queries,
|
|
const char *hostname,
|
|
uint16_t port,
|
|
uint8_t transport,
|
|
timediff_t timeout_ms,
|
|
uint32_t *presolv_id,
|
|
struct Curl_dns_entry **pdns);
|
|
|
|
CURLcode Curl_resolv_blocking(struct Curl_easy *data,
|
|
uint8_t dns_queries,
|
|
const char *hostname,
|
|
uint16_t port,
|
|
uint8_t transport,
|
|
struct Curl_dns_entry **pdns);
|
|
|
|
/* Announce start of a resolve operation to application callback,
|
|
* passing the resolver implementation (maybe NULL). */
|
|
CURLcode Curl_resolv_announce_start(struct Curl_easy *data,
|
|
void *resolver);
|
|
|
|
#ifdef USE_CURL_ASYNC
|
|
|
|
CURLcode Curl_resolv_pollset(struct Curl_easy *data,
|
|
struct easy_pollset *ps);
|
|
|
|
/* Get the `async` struct for the given `resolv_id`, if it exists. */
|
|
struct Curl_resolv_async *Curl_async_get(struct Curl_easy *data,
|
|
uint32_t resolv_id);
|
|
|
|
/* Shut down all resolves of the given easy handle. */
|
|
void Curl_resolv_shutdown_all(struct Curl_easy *data);
|
|
|
|
/* Destroy all resolve resources of the given easy handle. */
|
|
void Curl_resolv_destroy_all(struct Curl_easy *data);
|
|
|
|
CURLcode Curl_resolv_take_result(struct Curl_easy *data, uint32_t resolv_id,
|
|
struct Curl_dns_entry **pdns);
|
|
|
|
void Curl_resolv_destroy(struct Curl_easy *data, uint32_t resolv_id);
|
|
|
|
const struct Curl_addrinfo *
|
|
Curl_resolv_get_ai(struct Curl_easy *data, uint32_t resolv_id,
|
|
int ai_family, unsigned int index);
|
|
#ifdef USE_HTTPSRR
|
|
const struct Curl_https_rrinfo *
|
|
Curl_resolv_get_https(struct Curl_easy *data, uint32_t resolv_id);
|
|
bool Curl_resolv_knows_https(struct Curl_easy *data, uint32_t resolv_id);
|
|
#endif /* USE_HTTPSRR */
|
|
|
|
#else /* USE_CURL_ASYNC */
|
|
#define Curl_resolv_shutdown_all(x) Curl_nop_stmt
|
|
#define Curl_resolv_destroy_all(x) Curl_nop_stmt
|
|
#define Curl_resolv_take_result(x, y, z) CURLE_NOT_BUILT_IN
|
|
#define Curl_resolv_get_ai(x,y,z, a) NULL
|
|
#define Curl_resolv_get_https(x,y) NULL
|
|
#define Curl_resolv_knows_https(x,y) TRUE
|
|
#define Curl_resolv_pollset(x,y) CURLE_OK
|
|
#define Curl_resolv_destroy(x,y) Curl_nop_stmt
|
|
#endif /* USE_CURL_ASYNC, else */
|
|
|
|
CURLcode Curl_resolver_error(struct Curl_easy *data, const char *detail);
|
|
|
|
#ifdef CURLRES_SYNCH
|
|
/*
|
|
* Curl_sync_getaddrinfo() is the non-async low-level name resolve API.
|
|
* There are several versions of this function - depending on IPV6
|
|
* support and platform.
|
|
*/
|
|
struct Curl_addrinfo *Curl_sync_getaddrinfo(struct Curl_easy *data,
|
|
uint8_t dns_queries,
|
|
const char *hostname,
|
|
uint16_t port,
|
|
uint8_t transport);
|
|
#endif
|
|
|
|
#ifdef USE_UNIX_SOCKETS
|
|
CURLcode Curl_resolv_unix(struct Curl_easy *data,
|
|
const char *unix_path,
|
|
bool abstract_path,
|
|
struct Curl_dns_entry **pdns);
|
|
#endif
|
|
|
|
#endif /* HEADER_CURL_HOSTIP_H */
|