moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-08-13 17:03:50 -04:00
Code Issues Releases Wiki Activity

docs: clarify NO_PROXY env variable functionality

Browse Source 
Reported-by: Kirill Marchuk
Fixes #2773
Closes #2911
This commit is contained in:
Daniel Stenberg 2018-08-24 09:30:47 +02:00
parent 20168b948a
commit a7ba60bb72
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
3 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/cmdline-opts/page-footer
View File

@ -20,9 +20,10 @@ protocol that curl supports and as specified in a URL. FTP, FTPS, POP3, IMAP,
SMTP, LDAP etc. 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/domains>" list of host names that
list of host names that shouldn't go through any proxy. If set to an asterisk shouldn't go through any proxy. If set to an asterisk \&'*' only, it matches
\&'*' only, it matches all hosts. all hosts. Each name in this list is matched as either a domain name which
contains the hostname, or the hostname itself.
This environment variable disables use of the proxy even when specified with This environment variable disables use of the proxy even when specified with
the --proxy option. That is the --proxy option. That is

4
docs/libcurl/opts/CURLOPT_NOPROXY.3
View File

@ -52,7 +52,9 @@ brackets:
The application does not have to keep the string around after setting this The application does not have to keep the string around after setting this
option. option.
.SH "Environment variables" .SH "Environment variables"
See \fICURLOPT_PROXY(3)\fP If there's an environment variable called \fBno_proxy\fP (or \fBNO_PROXY\fP),
it will be used if the \fICURLOPT_NOPROXY(3)\fP option is not set. It works
exactly the same way.
.SH DEFAULT .SH DEFAULT
NULL NULL
.SH PROTOCOLS .SH PROTOCOLS

8
docs/libcurl/opts/CURLOPT_PROXY.3
View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -79,10 +79,8 @@ libcurl respects the proxy environment variables named \fBhttp_proxy\fP,
proxy for that URL scheme. So for a "FTP://" URL, the \fBftp_proxy\fP is proxy for that URL scheme. So for a "FTP://" URL, the \fBftp_proxy\fP is
considered. \fBall_proxy\fP is used if no protocol specific proxy was set. considered. \fBall_proxy\fP is used if no protocol specific proxy was set.
If \fBno_proxy\fP (or \fBNO_PROXY\fP) is set, it can specify a list of host If \fBno_proxy\fP (or \fBNO_PROXY\fP) is set, it is the exact equivalent of
names to not use a proxy for (even if one of the previous mention variables setting the \fICURLOPT_NOPROXY(3)\fP option.
are set). That is the exact equivalent of setting the \fICURLOPT_NOPROXY(3)\fP
option.
The \fICURLOPT_PROXY(3)\fP and \fICURLOPT_NOPROXY(3)\fP options override The \fICURLOPT_PROXY(3)\fP and \fICURLOPT_NOPROXY(3)\fP options override
environment variables. environment variables.