CURLOPT_TLS13_CIPHERS(3)

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

NAME

6       CURLOPT_TLS13_CIPHERS - specify 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
12       *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. The list must be syn‐
17       tactically correct, it consists of one or  more  cipher  suite  strings
18       separated by colons.
19
20       You'll 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_SSL_CIPHER_LIST op‐
27       tion.
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_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