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  or SChannel. If you are using a different SSL backend
25       you can try setting TLS 1.3 cipher suites by using the  CURLOPT_SSL_CI‐
26       PHER_LIST option.
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                          "TLS_CHACHA20_POLY1305_SHA256");
43         ret = curl_easy_perform(curl);
44         curl_easy_cleanup(curl);
45       }
46

AVAILABILITY

48       Added in 7.61.0 for OpenSSL.  Available  when  built  with  OpenSSL  >=
49       1.1.1.
50
51       Added in 7.85.0 for SChannel.
52

RETURN VALUE

54       Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
55