CURLOPT_DNS_LOCAL_IP4(3)

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

NAME

6       CURLOPT_DNS_LOCAL_IP4 - IPv4 address to bind DNS resolves to
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_DNS_LOCAL_IP4,  char
12       *address);
13

DESCRIPTION

15       Set the local IPv4 address that the resolver should bind to. The  argu‐
16       ment  should  be of type char * and contain a single numerical IPv4 ad‐
17       dress as a string.  Set this option to NULL to use the default  setting
18       (don't bind to a specific IP address).
19
20       The  application  does not have to keep the string around after setting
21       this option.
22

DEFAULT

24       NULL
25

PROTOCOLS

27       All
28

EXAMPLE

30       CURL *curl = curl_easy_init();
31       if(curl) {
32         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
33         curl_easy_setopt(curl, CURLOPT_DNS_LOCAL_IP4, "192.168.0.14");
34         ret = curl_easy_perform(curl);
35         curl_easy_cleanup(curl);
36       }
37

AVAILABILITY

39       This option requires that libcurl was built  with  a  resolver  backend
40       that supports this operation. The c-ares backend is the only such one.
41
42       Added in 7.33.0
43

RETURN VALUE

45       Returns  CURLE_OK  if  the option is supported, CURLE_UNKNOWN_OPTION if
46       not, CURLE_NOT_BUILT_IN if support was  disabled  at  compile-time,  or
47       CURLE_BAD_FUNCTION_ARGUMENT when given a bad address.
48