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       The  application  does not have to keep the string around after setting
25       this option.
26

DEFAULT

28       NULL, use internal default
29

PROTOCOLS

31       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
32

EXAMPLE

34       CURL *curl = curl_easy_init();
35       if(curl) {
36         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
37         curl_easy_setopt(curl, CURLOPT_PROXY_TLS13_CIPHERS,
38                          "TLS13-CHACHA20-POLY1305-SHA256");
39         ret = curl_easy_perform(curl);
40         curl_easy_cleanup(curl);
41       }
42

AVAILABILITY

44       Added in 7.61.0.  Available when built with OpenSSL >= 1.1.1.
45

RETURN VALUE

47       Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
48