From: Daniel Stenberg Date: Wed, 26 Apr 2023 13:39:03 +0000 (+0200) Subject: docs: clarify that more backends have HTTPS proxy support X-Git-Tag: curl-8_1_0~69 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=53523d7dcc3ad627f0c079f05ab4d2f0d954eb00;p=thirdparty%2Fcurl.git docs: clarify that more backends have HTTPS proxy support Closes #11033 --- diff --git a/docs/cmdline-opts/proxy.d b/docs/cmdline-opts/proxy.d index 73bfa9e2e6..8c85d396cd 100644 --- a/docs/cmdline-opts/proxy.d +++ b/docs/cmdline-opts/proxy.d @@ -21,7 +21,8 @@ Unix domain sockets are supported for socks proxy. Set localhost for the host part. e.g. socks5h://localhost/path/to/socket.sock HTTPS proxy support via https:// protocol prefix was added in 7.52.0 for -OpenSSL, GnuTLS and NSS. +OpenSSL, GnuTLS and NSS. Since 7.87.0, it also works for BearSSL, mbedTLS, +rustls, Schannel, Secure Transport and wolfSSL. Unrecognized and unsupported proxy protocols cause an error since 7.52.0. Prior versions may ignore the protocol and use http:// instead. diff --git a/docs/libcurl/opts/CURLOPT_PROXY.3 b/docs/libcurl/opts/CURLOPT_PROXY.3 index 640e184095..e97a40a812 100644 --- a/docs/libcurl/opts/CURLOPT_PROXY.3 +++ b/docs/libcurl/opts/CURLOPT_PROXY.3 @@ -48,7 +48,12 @@ proxy is used. .IP http:// HTTP Proxy. Default when no scheme or proxy type is specified. .IP https:// -HTTPS Proxy. (Added in 7.52.0 for OpenSSL, GnuTLS and NSS) +HTTPS Proxy. (Added in 7.52.0 for OpenSSL, GnuTLS and NSS. Since 7.87.0, it +also works for BearSSL, mbedTLS, rustls, Schannel, Secure Transport and +wolfSSL.) + +This will use HTTP/1 by default. Setting \fICURLOPT_PROXYTYPE(3)\fP to +\fBCURLPROXY_HTTPS2\fP allows libcurl to negotiate using HTTP/2 with proxy. .IP socks4:// SOCKS4 Proxy. .IP socks4a:// diff --git a/docs/libcurl/opts/CURLOPT_PROXYTYPE.3 b/docs/libcurl/opts/CURLOPT_PROXYTYPE.3 index 64a1a2ff34..89ea880e7e 100644 --- a/docs/libcurl/opts/CURLOPT_PROXYTYPE.3 +++ b/docs/libcurl/opts/CURLOPT_PROXYTYPE.3 @@ -38,7 +38,9 @@ Pass one of the values below to set the type of the proxy. .IP CURLPROXY_HTTP HTTP Proxy. Default. .IP CURLPROXY_HTTPS -HTTPS Proxy using HTTP/1. (Added in 7.52.0 for OpenSSL, GnuTLS and NSS) +HTTPS Proxy using HTTP/1. (Added in 7.52.0 for OpenSSL, GnuTLS and NSS. Since +7.87.0, it also works for BearSSL, mbedTLS, rustls, Schannel, Secure Transport +and wolfSSL.) .IP CURLPROXY_HTTPS2 HTTPS Proxy and attempt to speak HTTP/2 over it. (Added in 8.1.0) .IP CURLPROXY_HTTP_1_0