docs: wolfssl and mbedtls add CURLOPT_TLS13_CIPHERS support
Documentation for #14384 and #14385 Closes #14386
This commit is contained in:
parent
4c12892411
commit
f3e07e5c55
@ -12,13 +12,14 @@ and
|
|||||||
[`--ciphers`](https://curl.se/docs/manpage.html#--ciphers)
|
[`--ciphers`](https://curl.se/docs/manpage.html#--ciphers)
|
||||||
users can control which ciphers to consider when negotiating TLS connections.
|
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
|
TLS 1.3 ciphers are supported since curl 7.61 for OpenSSL 1.1.1+, since curl
|
||||||
curl 7.85 for Schannel with options
|
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)
|
[`CURLOPT_TLS13_CIPHERS`](https://curl.se/libcurl/c/CURLOPT_TLS13_CIPHERS.html)
|
||||||
and
|
and
|
||||||
[`--tls13-ciphers`](https://curl.se/docs/manpage.html#--tls13-ciphers)
|
[`--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
|
. Before curl 8.10.0 with mbedTLS or wolfSSL, TLS 1.3 cipher suites where set
|
||||||
suites by using the respective regular cipher option.
|
by using the respective regular cipher option.
|
||||||
|
|
||||||
The names of the known ciphers differ depending on which TLS backend that
|
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.
|
libcurl was built to use. This is an attempt to list known cipher names.
|
||||||
|
|||||||
@ -15,6 +15,8 @@ Protocol:
|
|||||||
TLS-backend:
|
TLS-backend:
|
||||||
- OpenSSL
|
- OpenSSL
|
||||||
- Schannel
|
- Schannel
|
||||||
|
- wolfSSL
|
||||||
|
- mbedTLS
|
||||||
Added-in: 7.61.0
|
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
|
https://curl.se/docs/ssl-ciphers.html
|
||||||
|
|
||||||
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
|
This option is used when curl is built to use OpenSSL 1.1.1 or later,
|
||||||
later. If you are using a different SSL backend you can try setting TLS 1.3
|
Schannel, wolfSSL, or mbedTLS 3.6.0 or later.
|
||||||
cipher suites by using the CURLOPT_PROXY_SSL_CIPHER_LIST(3) option.
|
|
||||||
|
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
|
The application does not have to keep the string around after setting this
|
||||||
option.
|
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%
|
# %AVAILABILITY%
|
||||||
|
|
||||||
# RETURN VALUE
|
# RETURN VALUE
|
||||||
|
|||||||
@ -16,6 +16,8 @@ Protocol:
|
|||||||
TLS-backend:
|
TLS-backend:
|
||||||
- OpenSSL
|
- OpenSSL
|
||||||
- Schannel
|
- Schannel
|
||||||
|
- wolfSSL
|
||||||
|
- mbedTLS
|
||||||
Added-in: 7.61.0
|
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
|
https://curl.se/docs/ssl-ciphers.html
|
||||||
|
|
||||||
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
|
This option is used when curl is built to use OpenSSL 1.1.1 or later,
|
||||||
later, or Schannel. If you are using a different SSL backend you can try
|
Schannel, wolfSSL, or mbedTLS 3.6.0 or later.
|
||||||
setting TLS 1.3 cipher suites by using the CURLOPT_SSL_CIPHER_LIST(3)
|
|
||||||
option.
|
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
|
The application does not have to keep the string around after setting this
|
||||||
option.
|
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 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%
|
# %AVAILABILITY%
|
||||||
|
|
||||||
# RETURN VALUE
|
# RETURN VALUE
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user