diff options
author | des <des@FreeBSD.org> | 2000-10-12 22:11:26 +0000 |
---|---|---|
committer | des <des@FreeBSD.org> | 2000-10-12 22:11:26 +0000 |
commit | 9a7ce3cd1a23050362e81c4b0d67a50cd643fb69 (patch) | |
tree | 2f0092b9de64c955bf0be790a6148c4811974b81 /lib/libfetch/fetch.3 | |
parent | 62f1dcda1959d87be6dc973549521d5edb6dcc7c (diff) | |
download | FreeBSD-src-9a7ce3cd1a23050362e81c4b0d67a50cd643fb69.zip FreeBSD-src-9a7ce3cd1a23050362e81c4b0d67a50cd643fb69.tar.gz |
Document recent changes in URL parsing and proxy handling
Diffstat (limited to 'lib/libfetch/fetch.3')
-rw-r--r-- | lib/libfetch/fetch.3 | 30 |
1 files changed, 20 insertions, 10 deletions
diff --git a/lib/libfetch/fetch.3 b/lib/libfetch/fetch.3 index bd6df15..6649594 100644 --- a/lib/libfetch/fetch.3 +++ b/lib/libfetch/fetch.3 @@ -133,10 +133,16 @@ A regular expression which produces this syntax is: <scheme>:(//(<user>(:<pwd>)?@)?<host>(:<port>)?)?/(<document>)? .Ed .Pp +If the URL does not seem to begin with a scheme name, the following +syntax is assumed: +.Bd -literal + ((<user>(:<pwd>)?@)?<host>(:<port>)?)?/(<document>)? +.Ed +.Pp Note that some components of the URL are not necessarily relevant to all URL schemes. -For instance, the file scheme only needs the <scheme> -and <document> components. +For instance, the file scheme only needs the <scheme> and <document> +components. .Pp .Fn fetchMakeURL and @@ -416,8 +422,11 @@ 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 -number separated from the host name by a colon. +URL of the proxy to use for FTP requests. +The document part is ignored. +FTP and HTTP proxies are supported; if no scheme is specified, FTP is +assumed. +If the proxy is an FTP proxy, .Nm libfetch will send .Ql user@host @@ -444,12 +453,12 @@ password, in that order. 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. +URL of the proxy to use for HTTP requests. +The document part is ignored. +Only HTTP proxies are supported for HTTP requests. 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 +Note that this proxy will also be used for FTP documents, unless the .Ev FTP_PROXY variable is set. .It Ev HTTP_PROXY_AUTH @@ -458,8 +467,9 @@ format as the .Ev HTTP_AUTH variable. .Pp -The value of this variable is used if and only if connected to an HTTP -proxy. +This variable is used if and only if connected to an HTTP proxy, and +is ignored if a user and/or a password were specified in the proxy +URL. .El .Sh SEE ALSO .Xr fetch 1 , |