CURLOPT_PROXY.md: clarify the crendential support in proxy URLs

Ref: #15802
Closes #15805
This commit is contained in:
Daniel Stenberg 2024-12-22 22:56:52 +01:00
parent 6090018305
commit 0ebd286aa3
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2

View file

@ -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**,