CURLOPT_PROXY_TLS13_CIPHERS(3)

1CURLOPT_PROXY_TLS13_CIPHERS(c3u)rl_easy_setopt optioCnUsRLOPT_PROXY_TLS13_CIPHERS(3)
2
3
4

NAME

6       CURLOPT_PROXY_TLS13_CIPHERS - ciphers suites for proxy TLS 1.3
7

SYNOPSIS

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

DESCRIPTION

15       Pass a char *, pointing to a null-terminated string holding the list of
16       cipher suites to use for the TLS 1.3 connection to a  proxy.  The  list
17       must  be syntactically correct, it consists of one or more cipher suite
18       strings separated by colons.
19
20       you will find more details about cipher lists on this URL:
21
22        https://curl.se/docs/ssl-ciphers.html
23
24       This option is currently used only when curl is built  to  use  OpenSSL
25       1.1.1  or  later.  If you are using a different SSL backend you can try
26       setting TLS  1.3  cipher  suites  by  using  the  CURLOPT_PROXY_SSL_CI‐
27       PHER_LIST option.
28
29       The  application  does not have to keep the string around after setting
30       this option.
31

DEFAULT

33       NULL, use internal default
34

PROTOCOLS

36       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
37

EXAMPLE

39       CURL *curl = curl_easy_init();
40       if(curl) {
41         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
42         curl_easy_setopt(curl, CURLOPT_PROXY_TLS13_CIPHERS,
43                          "TLS13-CHACHA20-POLY1305-SHA256");
44         ret = curl_easy_perform(curl);
45         curl_easy_cleanup(curl);
46       }
47

AVAILABILITY

49       Added in 7.61.0.  Available when built with OpenSSL >= 1.1.1.
50

RETURN VALUE

52       Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
53