CURLOPT_PROXY_CAPATH(3)

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

NAME

6       CURLOPT_PROXY_CAPATH - specify directory holding proxy CA certificates
7

SYNOPSIS

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

DESCRIPTION

15       Pass a char * to a zero terminated string naming  a  directory  holding
16       multiple  CA certificates to verify the HTTPS proxy with. If libcurl is
17       built against OpenSSL, the certificate directory must be prepared using
18       the   openssl  c_rehash  utility.  This  makes  sense  only  when  CUR‐
19       LOPT_PROXY_SSL_VERIFYPEER(3) is enabled (which it is by default).
20
21       The application does not have to keep the string around  after  setting
22       this option.
23

DEFAULT

25       NULL
26

PROTOCOLS

28       Everything used over an HTTPS proxy
29

EXAMPLE

31       CURL *curl = curl_easy_init();
32       if(curl) {
33         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
34         /* using an HTTPS proxy */
35         curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
36         curl_easy_setopt(curl, CURLOPT_PROXY_CAPATH, "/etc/cert-dir");
37         ret = curl_easy_perform(curl);
38         curl_easy_cleanup(curl);
39       }
40

AVAILABILITY

42       Added in 7.52.0
43
44       This  option  is  supported  by the OpenSSL, GnuTLS, and mbedTLS (since
45       7.56.0) backends. The NSS backend provides the option only for backward
46       compatibility.
47

RETURN VALUE

49       CURLE_OK if supported; or an error such as:
50
51       CURLE_NOT_BUILT_IN - Not supported by the SSL backend
52
53       CURLE_UNKNOWN_OPTION
54
55       CURLE_OUT_OF_MEMORY
56