CURLOPT_IPRESOLVE(3)

CURLOPT_IPRESOLVE(3)curl_easy_setopt options CURLOPT_IPRESOLVE(3)

NAME

     CURLOPT_IPRESOLVE - specify which IP protocol version to use

SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL  *handle,  CURLOPT_IPRESOLVE,
     long resolve);

DESCRIPTION

     Allows an application to select what kind of IP addresses to
     use when resolving host names. This is only interesting when
     using host names that resolve addresses using more than  one
     version of IP. The allowed values are:

     CURL_IPRESOLVE_WHATEVER
          Default, resolves addresses to  all  IP  versions  that
          your system allows.

     CURL_IPRESOLVE_V4
          Resolve to IPv4 addresses.

     CURL_IPRESOLVE_V6
          Resolve to IPv6 addresses.

DEFAULT

     CURL_IPRESOLVE_WHATEVER

PROTOCOLS

     All

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");

       /* resolve host name using IPv6-names only */
       curl_easy_setopt(curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V6);

       ret = curl_easy_perform(curl);

       curl_easy_cleanup(curl);
     }

AVAILABILITY

     Always

RETURN VALUE

     Returns CURLE_OK

libcurl 7.58.0      Last change: May 05, 2017                   1

CURLOPT_IPRESOLVE(3)curl_easy_setopt options CURLOPT_IPRESOLVE(3)

SEE ALSO

     CURLOPT_HTTP_VERSION(3), CURLOPT_SSLVERSION(3),

libcurl 7.58.0      Last change: May 05, 2017                   2