CURLOPT_TLS13_CIPHERS(3)

1CURLOPT_TLS13_CIPHERS(3)   curl_easy_setopt options   CURLOPT_TLS13_CIPHERS(3)
2
3
4

NAME

6       CURLOPT_TLS13_CIPHERS - ciphers suites to use for TLS 1.3
7

SYNOPSIS

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

DESCRIPTION

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

DEFAULT

32       NULL, use internal default
33

PROTOCOLS

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

EXAMPLE

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

AVAILABILITY

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

RETURN VALUE

51       Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
52