]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
docs: wolfssl and mbedtls add CURLOPT_TLS13_CIPHERS support
authorJan Venekamp <1422460+jan2000@users.noreply.github.com>
Sun, 4 Aug 2024 18:30:37 +0000 (20:30 +0200)
committerDaniel Stenberg <daniel@haxx.se>
Mon, 5 Aug 2024 21:29:11 +0000 (23:29 +0200)
Documentation for #14384 and #14385

Closes #14386

docs/CIPHERS.md
docs/libcurl/opts/CURLOPT_PROXY_TLS13_CIPHERS.md
docs/libcurl/opts/CURLOPT_TLS13_CIPHERS.md

index 607810c04cb39dbc87f44f0e4eae1c724a8e2c30..456d4878a0a173fb1e85872962bbfe2a5f4c5bd1 100644 (file)
@@ -12,13 +12,14 @@ and
 [`--ciphers`](https://curl.se/docs/manpage.html#--ciphers)
 users can control which ciphers to consider when negotiating TLS connections.
 
-TLS 1.3 ciphers are supported since curl 7.61 for OpenSSL 1.1.1+, and since
-curl 7.85 for Schannel with options
+TLS 1.3 ciphers are supported since curl 7.61 for OpenSSL 1.1.1+, since curl
+7.85 for Schannel, since curl 8.10.0 for wolfSSL and since curl 8.10.0 for
+mbedTLS 3.6.0+ with options
 [`CURLOPT_TLS13_CIPHERS`](https://curl.se/libcurl/c/CURLOPT_TLS13_CIPHERS.html)
 and
 [`--tls13-ciphers`](https://curl.se/docs/manpage.html#--tls13-ciphers)
-. If you are using a different SSL backend you can try setting TLS 1.3 cipher
-suites by using the respective regular cipher option.
+. Before curl 8.10.0 with mbedTLS or wolfSSL, TLS 1.3 cipher suites where set
+by using the respective regular cipher option.
 
 The names of the known ciphers differ depending on which TLS backend that
 libcurl was built to use. This is an attempt to list known cipher names.
index 42a871d09dc8ec59e12e7d30136bdfa1b8937c78..37470518d1e5a729b78d26c67dfdb7e5e402659a 100644 (file)
@@ -15,6 +15,8 @@ Protocol:
 TLS-backend:
   - OpenSSL
   - Schannel
+  - wolfSSL
+  - mbedTLS
 Added-in: 7.61.0
 ---
 
@@ -42,9 +44,11 @@ Find more details about cipher lists on this URL:
 
  https://curl.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_PROXY_SSL_CIPHER_LIST(3) option.
+This option is used when curl is built to use OpenSSL 1.1.1 or later,
+Schannel, wolfSSL, or mbedTLS 3.6.0 or later.
+
+Before curl 8.10.0 with mbedTLS or wolfSSL, TLS 1.3 cipher suites where set
+by using the CURLOPT_PROXY_SSL_CIPHER_LIST(3) option.
 
 The application does not have to keep the string around after setting this
 option.
@@ -72,6 +76,16 @@ int main(void)
 }
 ~~~
 
+# HISTORY
+
+Added in 7.61.0 for OpenSSL. Available when built with OpenSSL \>= 1.1.1.
+
+Added in 7.85.0 for Schannel.
+
+Added in 8.10.0 for wolfSSL.
+
+Added in 8.10.0 for mbedTLS. Available when built with mbedTLS \>= 3.6.0.
+
 # %AVAILABILITY%
 
 # RETURN VALUE
index f9320560de793e2b8830580d697fb173e219b1de..16fccdb7d10d082184f19fc51c037df3dfaa4016 100644 (file)
@@ -16,6 +16,8 @@ Protocol:
 TLS-backend:
   - OpenSSL
   - Schannel
+  - wolfSSL
+  - mbedTLS
 Added-in: 7.61.0
 ---
 
@@ -42,10 +44,11 @@ Find more details about cipher lists on this URL:
 
  https://curl.se/docs/ssl-ciphers.html
 
-This option is currently used only when curl is built to use OpenSSL 1.1.1 or
-later, or Schannel. If you are using a different SSL backend you can try
-setting TLS 1.3 cipher suites by using the CURLOPT_SSL_CIPHER_LIST(3)
-option.
+This option is used when curl is built to use OpenSSL 1.1.1 or later,
+Schannel, wolfSSL, or mbedTLS 3.6.0 or later.
+
+Before curl 8.10.0 with mbedTLS or wolfSSL, TLS 1.3 cipher suites where set
+by using the CURLOPT_SSL_CIPHER_LIST(3) option.
 
 The application does not have to keep the string around after setting this
 option.
@@ -79,6 +82,10 @@ Added in 7.61.0 for OpenSSL. Available when built with OpenSSL \>= 1.1.1.
 
 Added in 7.85.0 for Schannel.
 
+Added in 8.10.0 for wolfSSL.
+
+Added in 8.10.0 for mbedTLS. Available when built with mbedTLS \>= 3.6.0.
+
 # %AVAILABILITY%
 
 # RETURN VALUE