Scroll to navigation

CURLOPT_TLS13_CIPHERS(3) curl_easy_setopt options CURLOPT_TLS13_CIPHERS(3)

NAME

CURLOPT_TLS13_CIPHERS - specify ciphers suites to use for TLS 1.3

SYNOPSIS

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

DESCRIPTION

Pass a char *, pointing to a zero terminated string holding the list of cipher suites to use for the TLS 1.3 connection. The list must be syntactically correct, it consists of one or more cipher suite strings separated by colons.
You'll find more details about cipher lists on this URL:

https://curl.haxx.se/docs/ssl-ciphers.html
The application does not have to keep the string around after setting this option.

DEFAULT

NULL, use internal default

PROTOCOLS

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

EXAMPLE

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_TLS13_CIPHERS,
                   "TLS13-CHACHA20-POLY1305-SHA256");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

AVAILABILITY

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

RETURN VALUE

Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.

SEE ALSO

CURLOPT_SSLVERSION(3), CURLOPT_PROXY_TLS13_CIPHERS(3),
May 29, 2018 libcurl 7.61.0