summaryrefslogtreecommitdiffstats
path: root/lib/libfetch/fetch.3
diff options
context:
space:
mode:
authordes <des@FreeBSD.org>2000-10-12 16:55:52 +0000
committerdes <des@FreeBSD.org>2000-10-12 16:55:52 +0000
commit88e20da596d97e1dd6e75aa05d95ec075316ad5f (patch)
tree5a105973d789919c911a6431af9e338985ff1d2a /lib/libfetch/fetch.3
parent529896e0eaa10f24eedd25e99cd5dc9a520fc14b (diff)
downloadFreeBSD-src-88e20da596d97e1dd6e75aa05d95ec075316ad5f.zip
FreeBSD-src-88e20da596d97e1dd6e75aa05d95ec075316ad5f.tar.gz
Make the ENVIRONMENT section more legible, and mention that HTTP_AUTH is
colon-separated.
Diffstat (limited to 'lib/libfetch/fetch.3')
-rw-r--r--lib/libfetch/fetch.314
1 files changed, 10 insertions, 4 deletions
diff --git a/lib/libfetch/fetch.3 b/lib/libfetch/fetch.3
index 9c4249f..bd6df15 100644
--- a/lib/libfetch/fetch.3
+++ b/lib/libfetch/fetch.3
@@ -416,7 +416,7 @@ and message, e.g. "File is not available (404 Not Found)"
.Sh ENVIRONMENT
.Bl -tag -width HTTP_PROXY_AUTH
.It Ev FTP_PROXY
-host name of the FTP proxy to use, optionally followed by a port
+Host name of the FTP proxy to use, optionally followed by a port
number separated from the host name by a colon.
.Nm libfetch
will send
@@ -426,23 +426,28 @@ as user name to the proxy, where
is the real user name, and
.Ql host
is the name of the FTP server.
+.Pp
If this variable is set to an empty string, no proxy will be used for
FTP requests, even if the
.Ev HTTP_PROXY
variable is set.
.It Ev HTTP_AUTH
-Specifies HTTP authorization parameters, used only if the server
-requires authorization and no user name or password was specified in
-the URL.
+Specifies HTTP authorization parameters as a colon-separated list of
+items.
The first and second item are the authorization scheme and realm
respectively; further items are scheme-dependent.
Currently, only basic authorization is supported.
+.Pp
Basic authorization requires two parameters: the user name and
password, in that order.
+.Pp
+This variable is only used if the server requires authorization and
+no user name or password was specified in the URL.
.It Ev HTTP_PROXY
host name of the HTTP proxy to use, optionally followed by a port
number separated from the host name by a colon.
If no port number is specified, the default is 3128.
+.Pp
Note that the HTTP proxy will also be used for FTP documents, unless
the
.Ev FTP_PROXY
@@ -452,6 +457,7 @@ Specifies authorization parameters for the HTTP proxy in the same
format as the
.Ev HTTP_AUTH
variable.
+.Pp
The value of this variable is used if and only if connected to an HTTP
proxy.
.El
OpenPOWER on IntegriCloud