From 0ebd286aa3365def7ae0126b2e0cba363518e498 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sun, 22 Dec 2024 22:56:52 +0100 Subject: [PATCH] CURLOPT_PROXY.md: clarify the crendential support in proxy URLs Ref: #15802 Closes #15805 --- docs/libcurl/opts/CURLOPT_PROXY.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/libcurl/opts/CURLOPT_PROXY.md b/docs/libcurl/opts/CURLOPT_PROXY.md index 7c84556024..e7c3d96ff9 100644 --- a/docs/libcurl/opts/CURLOPT_PROXY.md +++ b/docs/libcurl/opts/CURLOPT_PROXY.md @@ -90,9 +90,6 @@ proxy. Such tunneling is activated with CURLOPT_HTTPPROXYTUNNEL(3). Setting the proxy string to "" (an empty string) explicitly disables the use of a proxy, even if there is an environment variable set for it. -A proxy host string can also include protocol scheme (http://) and embedded -user + password. - Unix domain sockets are supported for socks proxies since 7.84.0. Set localhost for the host part. e.g. socks5h://localhost/path/to/socket.sock @@ -106,6 +103,14 @@ Doing FTP over an HTTP proxy without CURLOPT_HTTPPROXYTUNNEL(3) set makes libcurl do HTTP with an FTP URL over the proxy. For such transfers, common FTP specific options do not work, for example CURLOPT_USE_SSL(3). +# Authentication + +The proxy can also be specified with its associated credentials like for +ordinary URLs in the style: `scheme://username:password@hostname` + +Alternatively, set them using CURLOPT_PROXYUSERNAME(3) and +CURLOPT_PROXYPASSWORD(3). + # Environment variables libcurl respects the proxy environment variables named **http_proxy**,