mirror of
https://github.com/curl/curl.git
synced 2026-07-02 01:07:15 +03:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
82 lines
1.7 KiB
Markdown
82 lines
1.7 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_PROXY_CAPATH
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_CAINFO (3)
|
|
- CURLOPT_DEBUGFUNCTION (3)
|
|
- CURLOPT_PROXY_CAINFO (3)
|
|
- CURLOPT_PROXY_SSL_VERIFYHOST (3)
|
|
- CURLOPT_STDERR (3)
|
|
Protocol:
|
|
- TLS
|
|
TLS-backend:
|
|
- OpenSSL
|
|
- GnuTLS
|
|
- mbedTLS
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_PROXY_CAPATH - directory holding HTTPS proxy CA certificates
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a char pointer to a null-terminated string naming a directory holding
|
|
multiple CA certificates to verify the HTTPS proxy with. If libcurl is built
|
|
against OpenSSL, the certificate directory must be prepared using the OpenSSL
|
|
**c_rehash** utility. This makes sense only when
|
|
CURLOPT_PROXY_SSL_VERIFYPEER(3) is enabled (which it is by default).
|
|
|
|
The application does not have to keep the string around after setting this
|
|
option.
|
|
|
|
The default value for this can be figured out with CURLINFO_CAPATH(3).
|
|
|
|
# DEFAULT
|
|
|
|
NULL
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
CURLcode res;
|
|
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
|
|
/* using an HTTPS proxy */
|
|
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
|
|
curl_easy_setopt(curl, CURLOPT_PROXY_CAPATH, "/etc/cert-dir");
|
|
res = curl_easy_perform(curl);
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 7.52.0
|
|
|
|
mbedTLS support added in 7.56.0.
|
|
|
|
# RETURN VALUE
|
|
|
|
CURLE_OK if supported; or an error such as:
|
|
|
|
CURLE_NOT_BUILT_IN - Not supported by the SSL backend
|
|
|
|
CURLE_UNKNOWN_OPTION
|
|
|
|
CURLE_OUT_OF_MEMORY
|