.Bl -tag -width HTTP_TIMEOUT

.Bl -tag -width ".Ev FETCH_BIND_ADDRESS"

.It Ev FTP_TIMEOUT

.It Ev FETCH_BIND_ADDRESS

maximum time, in seconds, to wait before aborting an

Specifies a hostname or IP address to which sockets used for outgoing

.Tn FTP

connections will be bound.

connection.

.It Ev FTP_LOGIN

.It Ev HTTP_TIMEOUT

Default FTP login if none was provided in the URL.

maximum time, in seconds, to wait before aborting an

.It Ev FTP_PASSIVE_MODE

.Tn HTTP

If set to anything but

connection.

.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.

All environment variables mentioned in the documentation for the

The second method is by using the

.Xr fetch 3

.Ev HTTP_PROXY_AUTH

library are supported.

environment variable:

.Bd -literal -offset indent

HTTP_PROXY=http://proxy.example.com:8080

HTTP_PROXY_AUTH=basic:*:<user>:<pwd>

.Ed