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 zero 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'll find more details about cipher lists on this URL:
21
22        https://curl.haxx.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    CUR‐
27       LOPT_PROXY_SSL_CIPHER_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