moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-11-12 04:25:08 -05:00
Code Issues Releases Wiki Activity

proxy protocol docs: rephrased and updated

Browse Source
This commit is contained in:
Daniel Stenberg 2011-08-09 09:12:51 +02:00
parent 9f10dabc43
commit 27dbc3f526
1 changed files with 25 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
docs/curl.1
View File

@ -1268,9 +1268,8 @@ the port number is not specified, it is assumed at port 1080. (Added in
This option overrides any previous use of \fI-x, --proxy\fP, as they are This option overrides any previous use of \fI-x, --proxy\fP, as they are
mutually exclusive. mutually exclusive.
Since 7.21.7, this option is superfluous since you can specify a Since 7.21.7, this option is superfluous since you can specify a socks5
socks5-hostnamae proxy with \fI-x, --proxy\fP using a socks5h:// protocol hostname proxy with \fI-x, --proxy\fP using a socks5h:// protocol prefix.
prefix.
If this option is used several times, the last one will be used. (This option If this option is used several times, the last one will be used. (This option
was previously wrongly documented and used as --socks without the number was previously wrongly documented and used as --socks without the number
@ -1658,22 +1657,39 @@ Default config file, see \fI-K, --config\fP for details.
The environment variables can be specified in lower case or upper case. The The environment variables can be specified in lower case or upper case. The
lower case version has precedence. http_proxy is an exception as it is only lower case version has precedence. http_proxy is an exception as it is only
available in lower case. available in lower case.
Using an environment variable to set the proxy has the same effect as using
the \fI--proxy\fP option.
.IP "http_proxy [protocol://]<host>[:port]" .IP "http_proxy [protocol://]<host>[:port]"
Sets the proxy server to use for HTTP. Sets the proxy server to use for HTTP.
.IP "HTTPS_PROXY [protocol://]<host>[:port]" .IP "HTTPS_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use for HTTPS. Sets the proxy server to use for HTTPS.
.IP "FTP_PROXY [protocol://]<host>[:port]" .IP "[url-protocol]_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use for FTP. Sets the proxy server to use for [url-protocol], where the protocol is a
protocol that curl supports and as specified in a URL. FTP, FTPS, POP3, IMAP,
SMTP, LDAP etc.
.IP "ALL_PROXY [protocol://]<host>[:port]" .IP "ALL_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use if no protocol-specific proxy is set. Sets the proxy server to use if no protocol-specific proxy is set.
.IP "NO_PROXY <comma-separated list of hosts>" .IP "NO_PROXY <comma-separated list of hosts>"
list of host names that shouldn't go through any proxy. If set to a asterisk list of host names that shouldn't go through any proxy. If set to a asterisk
\&'*' only, it matches all hosts. \&'*' only, it matches all hosts.
.SH "PROXY PROTOCOL PREFIXES"
Since curl version 7.21.7, the proxy string may be specified with a
protocol:// prefix to specify alternative proxy protocols.
Since 7.21.7, the proxy string may be specified with a protocol:// prefix to If no protocol is specified in the proxy string or if the string doesn't match
specify alternative proxy protocols. Use socks4://, socks4a:// or socks5:// to a supported one, the proxy will be treated as a HTTP proxy.
request the specific SOCKS version to be used. No protocol specified, http://
and all others will be treated as HTTP proxies. The supported proxy protocol prefixes are as follows:
.IP "socks4://"
Makes it the equivalent of \fI--socks4\fP
.IP "socks4a://"
Makes it the equivalent of \fI--socks4a\fP
.IP "socks5://"
Makes it the equivalent of \fI--socks5\fP
.IP "socks5h://"
Makes it the equivalent of \fI--socks5-hostname\fP
.SH EXIT CODES .SH EXIT CODES
There are a bunch of different error codes and their corresponding error 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, messages that may appear during bad conditions. At the time of this writing,
@ -1854,4 +1870,3 @@ ftp://ftp.sunet.se/pub/www/utilities/curl/
.SH "SEE ALSO" .SH "SEE ALSO"
.BR ftp (1), .BR ftp (1),
.BR wget (1) .BR wget (1)