Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 null-terminated string holding the list of
       cipher  suites to use for the TLS 1.3 connection. The list must be syn-
       tactically 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

       This  option  is	 currently used	only when curl is built	to use OpenSSL
       1.1.1 or	later. If you are using	a different SSL	backend	 you  can  try
       setting	TLS 1.3	cipher suites by using the CURLOPT_SSL_CIPHER_LIST op-
       tion.

       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_SSL_CIPHER_LIST(3),	   CURLOPT_SSLVERSION(3),	  CUR-
       LOPT_PROXY_SSL_CIPHER_LIST(3),	CURLOPT_PROXY_TLS13_CIPHERS(3),	  CUR-
       LOPT_PROXY_SSLVERSION(3), CURLOPT_USE_SSL(3),

libcurl	7.72.0			 June 25, 2020	      CURLOPT_TLS13_CIPHERS(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_TLS13_CIPHERS&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help