Changeset View
Changeset View
Standalone View
Standalone View
lib/libfetch/fetch.3
Show First 20 Lines • Show All 618 Lines • ▼ Show 20 Lines | ||||||||||
This variable is only used if the server requires authorization and | This variable is only used if the server requires authorization and | |||||||||
no user name or password was specified in the URL. | no user name or password was specified in the URL. | |||||||||
.It Ev HTTP_PROXY | .It Ev HTTP_PROXY | |||||||||
URL of the proxy to use for HTTP requests. | URL of the proxy to use for HTTP requests. | |||||||||
The document part is ignored. | The document part is ignored. | |||||||||
Only HTTP proxies are supported for HTTP requests. | Only HTTP proxies are supported for HTTP requests. | |||||||||
If no port number is specified, the default is 3128. | If no port number is specified, the default is 3128. | |||||||||
.Pp | .Pp | |||||||||
Note that this proxy will also be used for FTP documents, unless the | Note that this proxy will also be used for FTP and HTTPS documents, | |||||||||
unless the | ||||||||||
.Ev FTP_PROXY | .Ev FTP_PROXY | |||||||||
variable is set. | and | |||||||||
.Ev HTTPS_PROXY | ||||||||||
variables are set respectively. | ||||||||||
.It Ev http_proxy | .It Ev http_proxy | |||||||||
Same as | Same as | |||||||||
.Ev HTTP_PROXY , | .Ev HTTP_PROXY , | |||||||||
for compatibility. | for compatibility. | |||||||||
.It Ev HTTP_PROXY_AUTH | .It Ev HTTP_PROXY_AUTH | |||||||||
Specifies authorization parameters for the HTTP proxy in the same | Specifies authorization parameters for the HTTP proxy in the same | |||||||||
format as the | format as the | |||||||||
.Ev HTTP_AUTH | .Ev HTTP_AUTH | |||||||||
variable. | variable. | |||||||||
.Pp | .Pp | |||||||||
This variable is used if and only if connected to an HTTP proxy, and | 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 | is ignored if a user and/or a password were specified in the proxy | |||||||||
URL. | URL. | |||||||||
.It Ev HTTP_REFERER | .It Ev HTTP_REFERER | |||||||||
Specifies the referrer URL to use for HTTP requests. | Specifies the referrer URL to use for HTTP requests. | |||||||||
If set to | If set to | |||||||||
.Dq auto , | .Dq auto , | |||||||||
the document URL will be used as referrer URL. | the document URL will be used as referrer URL. | |||||||||
.It Ev HTTP_USER_AGENT | .It Ev HTTP_USER_AGENT | |||||||||
Specifies the User-Agent string to use for HTTP requests. | Specifies the User-Agent string to use for HTTP requests. | |||||||||
This can be useful when working with HTTP origin or proxy servers that | This can be useful when working with HTTP origin or proxy servers that | |||||||||
differentiate between user agents. | differentiate between user agents. | |||||||||
If defined but empty, no User-Agent header is sent. | If defined but empty, no User-Agent header is sent. | |||||||||
.It Ev HTTPS_PROXY | ||||||||||
URL of the proxy to use for HTTPS requests. | ||||||||||
The document part is ignored. | ||||||||||
Only HTTP proxies are supported for HTTPS requests. | ||||||||||
crees: HTTP or HTTPS? | ||||||||||
If no port number is specified, the default is 3128. | ||||||||||
.Pp | ||||||||||
If this variable is set to an empty string, no proxy will be used for | ||||||||||
HTTPS requests, even if the | ||||||||||
.Ev HTTP_PROXY | ||||||||||
variable is set. | ||||||||||
.It Ev https_proxy | ||||||||||
Same as | ||||||||||
.Ev HTTPS_PROXY , | ||||||||||
for compatibility. | ||||||||||
.It Ev NETRC | .It Ev NETRC | |||||||||
Specifies a file to use instead of | Specifies a file to use instead of | |||||||||
.Pa ~/.netrc | .Pa ~/.netrc | |||||||||
to look up login names and passwords for FTP and HTTP sites as well as | to look up login names and passwords for FTP and HTTP sites as well as | |||||||||
HTTP proxies. | HTTP proxies. | |||||||||
See | See | |||||||||
.Xr ftp 1 | .Xr ftp 1 | |||||||||
for a description of the file format. | for a description of the file format. | |||||||||
▲ Show 20 Lines • Show All 181 Lines • ▼ Show 20 Lines | ||||||||||
The most notable | The most notable | |||||||||
examples of this are | examples of this are | |||||||||
.Fn fetchPutHTTP , | .Fn fetchPutHTTP , | |||||||||
.Fn fetchListHTTP , | .Fn fetchListHTTP , | |||||||||
.Fn fetchListFTP | .Fn fetchListFTP | |||||||||
and FTP proxy support. | and FTP proxy support. | |||||||||
.Pp | .Pp | |||||||||
There is no way to select a proxy at run-time other than setting the | There is no way to select a proxy at run-time other than setting the | |||||||||
.Ev HTTPS_PROXY , | ||||||||||
.Ev HTTP_PROXY | .Ev HTTP_PROXY | |||||||||
creesUnsubmitted Not Done Inline Actions
We use the serial comma. crees: We use the serial comma. | ||||||||||
or | or | |||||||||
.Ev FTP_PROXY | .Ev FTP_PROXY | |||||||||
environment variables as appropriate. | environment variables as appropriate. | |||||||||
.Pp | .Pp | |||||||||
.Nm libfetch | .Nm libfetch | |||||||||
does not understand or obey 305 (Use Proxy) replies. | does not understand or obey 305 (Use Proxy) replies. | |||||||||
.Pp | .Pp | |||||||||
Error numbers are unique only within a certain context; the error | Error numbers are unique only within a certain context; the error | |||||||||
Show All 19 Lines |
HTTP or HTTPS?