CURLOPT_IPRESOLVE(3)

1CURLOPT_IPRESOLVE(3)       curl_easy_setopt options       CURLOPT_IPRESOLVE(3)
2
3
4

NAME

6       CURLOPT_IPRESOLVE - IP protocol version to use
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_IPRESOLVE,  long re‐
12       solve);
13

DESCRIPTION

15       Allows an application to select what kind of IP addresses to  use  when
16       establishing  a  connection  or  choosing one from the connection pool.
17       This is interesting when using host names that resolve addresses  using
18       more than one version of IP. The allowed values are:
19
20       CURL_IPRESOLVE_WHATEVER
21              Default,  can  use addresses of all IP versions that your system
22              allows.
23
24       CURL_IPRESOLVE_V4
25              Uses only IPv4 addresses.
26
27       CURL_IPRESOLVE_V6
28              Uses only IPv6 addresses.
29

DEFAULT

31       CURL_IPRESOLVE_WHATEVER
32

PROTOCOLS

34       All
35

EXAMPLE

37       CURL *curl = curl_easy_init();
38       if(curl) {
39         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
40
41         /* of all addresses example.com resolves to, only IPv6 ones are used */
42         curl_easy_setopt(curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V6);
43
44         ret = curl_easy_perform(curl);
45
46         curl_easy_cleanup(curl);
47       }
48
49

AVAILABILITY

51       Always
52

RETURN VALUE

54       Returns CURLE_OK
55