diff options
author | Daniel Stenberg <daniel@haxx.se> | 2011-05-02 22:15:14 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2011-05-02 22:15:14 +0200 |
commit | d4ebf3c6b0951dcec2157feb6e064ee636cd919b (patch) | |
tree | 9104c505e2e8e2f2c91dab191e7e254535526d67 /docs/curl.1 | |
parent | f78fa6a57d53db9b0ee2141394c28ca2d86cc958 (diff) |
docs: mention the protocol:// support in proxy strings
Diffstat (limited to 'docs/curl.1')
-rw-r--r-- | docs/curl.1 | 30 |
1 files changed, 20 insertions, 10 deletions
diff --git a/docs/curl.1 b/docs/curl.1 index 2214312b6..638cc70b0 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -1542,22 +1542,27 @@ means the verification was successful. (Added in 7.19.0) .RE If this option is used several times, the last one will be used. -.IP "-x/--proxy <proxyhost[:port]>" -Use the specified HTTP proxy. If the port number is not specified, it is assumed -at port 1080. +.IP "-x/--proxy <[protocol://][user@password]proxyhost[:port]>" +Use the specified HTTP proxy. If the port number is not specified, it is +assumed at port 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. -\fBNote\fP that all operations that are performed over a 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 done with the \fI-p/--proxytunnel\fP option. +All operations that are performed over a 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 +done with the \fI-p/--proxytunnel\fP option. + +The proxy host can be specified the exact same way as the proxy environment +variables, including the protocol prefix (http://) and the embedded user + +password. -Starting with 7.14.1, the proxy host can be specified the exact same way as -the proxy environment variables, including the protocol prefix (http://) and -the embedded user + password. +From 7.21.7, the proxy string may be specified with a protocol:// prefix to +specify alternative proxy protocols. Use socks4://, socks4a:// or socks5:// to +request the specific SOCKS version to be used. No protocol specified, http:// +and all others will be treated as HTTP proxies. If this option is used several times, the last one will be used. .IP "-X/--request <command>" @@ -1649,6 +1654,11 @@ Sets the proxy server to use if no protocol-specific proxy is set. .IP "NO_PROXY <comma-separated list of hosts>" list of host names that shouldn't go through any proxy. If set to a asterisk \&'*' only, it matches all hosts. + +Since 7.21.7, the proxy string may be specified with a protocol:// prefix to +specify alternative proxy protocols. Use socks4://, socks4a:// or socks5:// to +request the specific SOCKS version to be used. No protocol specified, http:// +and all others will be treated as HTTP proxies. .SH EXIT CODES There are a bunch of different error codes and their corresponding error messages that may appear during bad conditions. At the time of this writing, |