CURLOPT_SSL_EC_CURVES.3 1.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. .\" generated by cd2nroff 0.1 from CURLOPT_SSL_EC_CURVES.md
  2. .TH CURLOPT_SSL_EC_CURVES 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLOPT_SSL_EC_CURVES \- key exchange curves
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_EC_CURVES, char *alg_list);
  9. .fi
  10. .SH DESCRIPTION
  11. Pass a string as parameter with a colon delimited list of (EC) algorithms. This
  12. option defines the client\(aqs key exchange algorithms in the SSL handshake (if
  13. the SSL backend libcurl is built to use supports it).
  14. .SH DEFAULT
  15. \&"", embedded in SSL backend
  16. .SH PROTOCOLS
  17. This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
  18. This option works only with the following TLS backends:
  19. OpenSSL and wolfSSL
  20. .SH EXAMPLE
  21. .nf
  22. int main(void)
  23. {
  24. CURL *curl = curl_easy_init();
  25. if(curl) {
  26. CURLcode res;
  27. curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  28. curl_easy_setopt(curl, CURLOPT_SSL_EC_CURVES, "X25519:P-521");
  29. res = curl_easy_perform(curl);
  30. curl_easy_cleanup(curl);
  31. }
  32. }
  33. .fi
  34. .SH AVAILABILITY
  35. Added in curl 7.73.0
  36. .SH RETURN VALUE
  37. Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
  38. .SH SEE ALSO
  39. .BR CURLOPT_SSL_CIPHER_LIST (3),
  40. .BR CURLOPT_SSL_OPTIONS (3),
  41. .BR CURLOPT_TLS13_CIPHERS (3)