mirror of
https://github.com/curl/curl.git
synced 2024-12-15 06:40:09 +08:00
f0b374f662
- CURL_GLOBAL_SSL This option was changed in libcurl 7.57.0 and clearly it has not caused too many issues and a lot of time has passed. - Store TLS context per transfer instead of per connection This is a possible future optimization. One that is much less important and interesting since the added support for CA caching. - Microsoft telnet server This bug was filed in May 2007 against curl 7.16.1 and we have not received further reports. - active FTP over a SOCKS Actually, proxies in general is not working with active FTP mode. This is now added in proxy documentation. - DICT responses show the underlying protocol curl still does this, but since this is now an established behavior since forever we cannot change it easily and adding an option for it seems crazy as this protocol is not so little its not worth it. Let's just live with it. - Secure Transport disabling hostname validation also disables SNI This is an already documented restriction in Secure Transport. - CURLOPT_SEEKFUNCTION not called with CURLFORM_STREAM The curl_formadd() function is marked and documented as deprecated. No point in collecting bugs for it. It should not be used further. - STARTTRANSFER time is wrong for HTTP POSTs After close source code inspection I cannot see how this is true or that there is any special treatment for different HTTP methods. We also have not received many further reports on this, making me strongly suspect that this is no (longer an) issue. - multipart formposts file name encoding The once proposed RFC 5987-encoding is since RFC 7578 documented as MUST NOT be used. The since then implemented MIME API allows the user to set the name on their own and can thus provide it encoded as it wants. - DoH is not used for all name resolves when enabled It is questionable if users actually want to use DoH for interface and FTP port name resolving. This restriction is now documented and we advice users against using name resolving at all for these functions. Closes #10043
51 lines
1.8 KiB
Makefile
51 lines
1.8 KiB
Makefile
c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Long: proxy
|
|
Short: x
|
|
Arg: [protocol://]host[:port]
|
|
Help: Use this proxy
|
|
Category: proxy
|
|
Example: --proxy http://proxy.example $URL
|
|
Added: 4.0
|
|
See-also: socks5 proxy-basic
|
|
Multi: single
|
|
---
|
|
Use the specified proxy.
|
|
|
|
The proxy string can be specified with a protocol:// prefix. No protocol
|
|
specified or http:// will be treated as HTTP proxy. Use socks4://, socks4a://,
|
|
socks5:// or socks5h:// to request a specific SOCKS version to be used.
|
|
(Added in 7.21.7)
|
|
|
|
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.
|
|
|
|
Unrecognized and unsupported proxy protocols cause an error since 7.52.0.
|
|
Prior versions may ignore the protocol and use http:// instead.
|
|
|
|
If the port number is not specified in the proxy string, it is assumed to be
|
|
1080.
|
|
|
|
This option overrides existing environment variables that set the proxy to
|
|
use. If there's an environment variable setting a proxy, you can set proxy to
|
|
"" to override it.
|
|
|
|
All operations that are performed over an HTTP proxy will transparently be
|
|
converted to HTTP. It means that certain protocol specific operations might
|
|
not be available. This is not the case if you can tunnel through the proxy, as
|
|
one with the --proxytunnel option.
|
|
|
|
User and password that might be provided in the proxy string are URL decoded
|
|
by curl. This allows you to pass in special characters such as @ by using %40
|
|
or pass in a colon with %3a.
|
|
|
|
The proxy host can be specified the same way as the proxy environment
|
|
variables, including the protocol prefix (http://) and the embedded user +
|
|
password.
|
|
|
|
When a proxy is used, the active FTP mode as set with --ftp-port, cannot be
|
|
used.
|