CURLOPT_DNS_INTERFACE(3)

1CURLOPT_DNS_INTERFACE(3)            libcurl           CURLOPT_DNS_INTERFACE(3)
2
3
4

NAME

6       CURLOPT_DNS_INTERFACE - interface to speak DNS over
7

SYNOPSIS

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

DESCRIPTION

14       Pass  a char * as parameter. Set the name of the network interface that
15       the DNS resolver should bind to. This must be an interface name (not an
16       address).  Set  this  option to NULL to use the default setting (do not
17       bind to a specific interface).
18
19       The application does not have to keep the string around  after  setting
20       this option.
21

DEFAULT

23       NULL
24

PROTOCOLS

26       All protocols except file:// - protocols that resolve host names.
27

EXAMPLE

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

AVAILABILITY

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

RETURN VALUE

43       Returns  CURLE_OK  if  the option is supported, CURLE_UNKNOWN_OPTION if
44       not, or CURLE_NOT_BUILT_IN if support was disabled at compile-time.
45