CURLOPT_PROXY_CAINFO_BLOB(3)

1CURLOPT_PROXY_CAINFO_BLOB(3)curl_easy_setopt optionsCURLOPT_PROXY_CAINFO_BLOB(3)
2
3
4

NAME

6       CURLOPT_PROXY_CAINFO_BLOB  - proxy Certificate Authority (CA) bundle in
7       PEM format
8

SYNOPSIS

10       #include <curl/curl.h>
11
12       CURLcode  curl_easy_setopt(CURL   *handle,   CURLOPT_PROXY_CAINFO_BLOB,
13       struct curl_blob *stblob);
14

DESCRIPTION

16       This option is for connecting to an HTTPS proxy, not an HTTPS server.
17
18       Pass  a  pointer  to  a curl_blob structure, which contains information
19       (pointer and size) about a memory block with binary data of PEM encoded
20       content  holding  one  or  more  certificates to verify the HTTPS proxy
21       with.
22
23       If CURLOPT_PROXY_SSL_VERIFYPEER(3) is zero and you avoid verifying  the
24       server's certificate, CURLOPT_PROXY_CAINFO_BLOB(3) is not needed.
25
26       This option overrides CURLOPT_PROXY_CAINFO(3).
27

DEFAULT

29       NULL
30

PROTOCOLS

32       Used with HTTPS proxy
33

EXAMPLE

35       char *strpem; /* strpem must point to a PEM string */
36       CURL *curl = curl_easy_init();
37       if(curl) {
38         struct curl_blob blob;
39         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
40         /* using an HTTPS proxy */
41         curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
42         blob.data = strpem;
43         blob.len = strlen(strpem);
44         blob.flags = CURL_BLOB_COPY;
45         curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO_BLOB, &blob);
46         ret = curl_easy_perform(curl);
47         curl_easy_cleanup(curl);
48       }
49

AVAILABILITY

51       Added in 7.77.0.
52
53       This  option is supported by the OpenSSL, Secure Transport and Schannel
54       backends.
55

RETURN VALUE

57       Returns CURLE_OK if the option is  supported,  CURLE_UNKNOWN_OPTION  if
58       not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space.
59