Attachment 39118 Details for Bug 61759 – file.diff

[patch] file.diff

file.diff (text/plain), 3.86 KB, created by Christian S. Peron on 2004-01-23 02:20:00 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Christian S. Peron

Created: 2004-01-23 02:20:00 UTC

Size: 3.86 KB

patch

obsolete

>--- usr.bin/fetch/fetch.1	Fri Jan 23 01:53:34 2004
>+++ usr.bin/fetch/fetch.1.newer	Fri Jan 23 01:50:33 2004
>@@ -214,20 +214,116 @@
> will attempt to retrieve them each of them in turn, and return zero
> only if they were all successfully retrieved.
> .Sh ENVIRONMENT
>-.Bl -tag -width HTTP_TIMEOUT
>-.It Ev FTP_TIMEOUT
>-maximum time, in seconds, to wait before aborting an
>-.Tn FTP
>-connection.
>-.It Ev HTTP_TIMEOUT
>-maximum time, in seconds, to wait before aborting an
>-.Tn HTTP
>-connection.
>+.Bl -tag -width ".Ev FETCH_BIND_ADDRESS"
>+.It Ev FETCH_BIND_ADDRESS
>+Specifies a hostname or IP address to which sockets used for outgoing
>+connections will be bound.
>+.It Ev FTP_LOGIN
>+Default FTP login if none was provided in the URL.
>+.It Ev FTP_PASSIVE_MODE
>+If set to anything but
>+.Ql no ,
>+forces the FTP code to use passive mode.
>+.It Ev FTP_PASSWORD
>+Default FTP password if the remote server requests one and none was
>+provided in the URL.
>+.It Ev FTP_PROXY
>+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 fetch
>+will send
>+.Ql user@host
>+as user name to the proxy, where
>+.Ql user
>+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 ftp_proxy
>+Same as
>+.Ev FTP_PROXY ,
>+for compatibility.
>+.It Ev HTTP_AUTH
>+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
>+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 this proxy will also be used for FTP documents, unless the
>+.Ev FTP_PROXY
>+variable is set.
>+.It Ev http_proxy
>+Same as
>+.Ev HTTP_PROXY ,
>+for compatibility.
>+.It Ev HTTP_PROXY_AUTH
>+Specifies authorization parameters for the HTTP proxy in the same
>+format as the
>+.Ev HTTP_AUTH
>+variable.
>+.Pp
>+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.
>+.It Ev HTTP_REFERER
>+Specifies the referrer URL to use for HTTP requests.
>+If set to
>+.Dq auto ,
>+the document URL will be used as referrer URL.
>+.It Ev HTTP_USER_AGENT
>+Specifies the User-Agent string to use for HTTP requests.
>+This can be useful when working with HTTP origin or proxy servers that
>+differentiate between user agents.
>+.It Ev NETRC
>+Specifies a file to use instead of
>+.Pa ~/.netrc
>+to look up login names and passwords for FTP sites.
>+See
>+.Xr ftp 1
>+for a description of the file format.
>+This feature is experimental.
> .El
>+.Sh EXAMPLES
>+To access a proxy server on
>+.Pa proxy.example.com
>+port 8080, set the
>+.Ev HTTP_PROXY
>+environment variable in a manner similar to this:
>+.Pp
>+.Dl HTTP_PROXY=http://proxy.example.com:8080
>+.Pp
>+If the proxy server requires authentication, there are
>+two options available for passing the authentication data.
>+The first method is by using the proxy URL:
>+.Pp
>+.Dl HTTP_PROXY=http://<user>:<pwd>@proxy.example.com:8080
> .Pp
>-All environment variables mentioned in the documentation for the
>-.Xr fetch 3
>-library are supported.
>+The second method is by using the
>+.Ev HTTP_PROXY_AUTH
>+environment variable:
>+.Bd -literal -offset indent
>+HTTP_PROXY=http://proxy.example.com:8080
>+HTTP_PROXY_AUTH=basic:*:<user>:<pwd>
>+.Ed
> .Sh SEE ALSO
> .Xr fetch 3
> .Sh HISTORY

Actions: View | Diff

Attachments on bug 61759: 39118