The accompanying error message includes a protocol-specific error code and message, e.g. "File is not available (404 Not Found)"
| FETCH_BIND_ADDRESS || Specifies a hostname or IP address to which sockets used for outgoing connections will be bound. |
| FTP_LOGIN || Default FTP login if none was provided in the URL. |
| FTP_PASSIVE_MODE || If set to anything but no, forces the FTP code to use passive mode. |
| FTP_PASSWORD || Default FTP password if the remote server requests one and none was provided in the URL. |
| 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, libfetch will send user@host as user name to the proxy, where user is the real user name, and host is the name of the FTP server. |
If this variable is set to an empty string, no proxy will be used for FTP requests, even if the HTTP_PROXY variable is set.
| ftp_proxy || Same as FTP_PROXY, for compatibility. |
| 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. |
Basic authorization requires two parameters: the user name and 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.
| 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. |
Note that this proxy will also be used for FTP documents, unless the FTP_PROXY variable is set.
| http_proxy || Same as HTTP_PROXY, for compatibility. |
| HTTP_PROXY_AUTH || Specifies authorization parameters for the HTTP proxy in the same format as the HTTP_AUTH variable. |
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.
| HTTP_REFERER || Specifies the referrer URL to use for HTTP requests. If set to "auto", the document URL will be used as referrer URL. |
| 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. |
| NETRC || Specifies a file to use instead of ~/.netrc to look up login names and passwords for FTP sites. See ftp(1) for a description of the file format. This feature is experimental. |
To access a proxy server on proxy.example.com port 8080, set the HTTP_PROXY environment variable in a manner similar to this:
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:
The second method is by using the HTTP_PROXY_AUTH environment variable:
fetch(1), ftpio(3), ip(4)
.Rs How to Use Anonymous FTP
.Rs Uniform Resource Locators (URL)