Changeset View
Changeset View
Standalone View
Standalone View
lib/libfetch/fetch.3
Show All 20 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd March 18, 2016 | .Dd June 19, 2019 | ||||
0mp: Remember to bump the date. | |||||
.Dt FETCH 3 | .Dt FETCH 3 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm fetchMakeURL , | .Nm fetchMakeURL , | ||||
.Nm fetchParseURL , | .Nm fetchParseURL , | ||||
.Nm fetchFreeURL , | .Nm fetchFreeURL , | ||||
.Nm fetchXGetURL , | .Nm fetchXGetURL , | ||||
.Nm fetchGetURL , | .Nm fetchGetURL , | ||||
▲ Show 20 Lines • Show All 609 Lines • ▼ Show 20 Lines | |||||
.It Ev NO_PROXY | .It Ev NO_PROXY | ||||
Either a single asterisk, which disables the use of proxies | Either a single asterisk, which disables the use of proxies | ||||
altogether, or a comma- or whitespace-separated list of hosts for | altogether, or a comma- or whitespace-separated list of hosts for | ||||
which proxies should not be used. | which proxies should not be used. | ||||
.It Ev no_proxy | .It Ev no_proxy | ||||
Same as | Same as | ||||
.Ev NO_PROXY , | .Ev NO_PROXY , | ||||
for compatibility. | for compatibility. | ||||
.It Ev SOCKS5_PROXY | |||||
Uses SOCKS version 5 to make connection. | |||||
Not Done Inline ActionsPlease lint your changes using mandoc -Tlint fetch.3 and igor fetch.3 (https://www.freshports.org/textproc/igor). 0mp: Please lint your changes using `mandoc -Tlint fetch.3` and `igor fetch.3` (https://www. | |||||
The format must be the IP or hostname followed by a colon for the port. | |||||
IPv6 addresses must enclose the address in brackets. | |||||
Done Inline ActionsTypo:
0mp: Typo:
> If no port | |||||
If no port is specified, the default is 1080. | |||||
This setting will supercede a connection to an | |||||
Done Inline Actions.Ev HTTP_PROXY 0mp: .Ev HTTP_PROXY | |||||
Not Done Inline ActionsThis setting will supercede a connection to an . Ev HTTP_PROXY . 0mp: ```
This setting will supercede a connection to an
. Ev HTTP_PROXY .
``` | |||||
.Ev HTTP_PROXY . | |||||
.It Ev SSL_ALLOW_SSL3 | .It Ev SSL_ALLOW_SSL3 | ||||
Allow SSL version 3 when negotiating the connection (not recommended). | Allow SSL version 3 when negotiating the connection (not recommended). | ||||
.It Ev SSL_CA_CERT_FILE | .It Ev SSL_CA_CERT_FILE | ||||
CA certificate bundle containing trusted CA certificates. | CA certificate bundle containing trusted CA certificates. | ||||
Default value: See HTTPS SCHEME above. | Default value: See HTTPS SCHEME above. | ||||
.It Ev SSL_CA_CERT_PATH | .It Ev SSL_CA_CERT_PATH | ||||
Path containing trusted CA hashes. | Path containing trusted CA hashes. | ||||
.It Ev SSL_CLIENT_CERT_FILE | .It Ev SSL_CLIENT_CERT_FILE | ||||
Show All 40 Lines | |||||
.Ed | .Ed | ||||
.Pp | .Pp | ||||
To disable the use of a proxy for an HTTP server running on the local | To disable the use of a proxy for an HTTP server running on the local | ||||
host, define | host, define | ||||
.Ev NO_PROXY | .Ev NO_PROXY | ||||
as follows: | as follows: | ||||
.Bd -literal -offset indent | .Bd -literal -offset indent | ||||
NO_PROXY=localhost,127.0.0.1 | NO_PROXY=localhost,127.0.0.1 | ||||
.Ed | |||||
.Pp | |||||
To use a SOCKS5 proxy, set the | |||||
Done Inline Actions.Ev SOCKS5_PROXY 0mp: .Ev SOCKS5_PROXY | |||||
.Ev SOCKS5_PROXY | |||||
environment variable to a | |||||
valid host or IP followed by an optional colon and the port. | |||||
IPv6 addresses must be enclosed in brackets. | |||||
Done Inline ActionsI'd use something like .Bd -literal -offset indent instead of multiple .Dl. See NO_PROXY above for example. 0mp: I'd use something like `.Bd -literal -offset indent` instead of multiple `.Dl`. See NO_PROXY… | |||||
The following are examples of valid settings: | |||||
.Bd -literal -offset indent | |||||
SOCKS5_PROXY=proxy.example.com | |||||
SOCKS5_PROXY=proxy.example.com:1080 | |||||
SOCKS5_PROXY=192.0.2.0 | |||||
SOCKS5_PROXY=198.51.100.0:1080 | |||||
SOCKS5_PROXY=[2001:db8::1] | |||||
SOCKS5_PROXY=[2001:db8::2]:1080 | |||||
.Ed | .Ed | ||||
.Pp | .Pp | ||||
Access HTTPS website without any certificate verification whatsoever: | Access HTTPS website without any certificate verification whatsoever: | ||||
.Bd -literal -offset indent | .Bd -literal -offset indent | ||||
SSL_NO_VERIFY_PEER=1 | SSL_NO_VERIFY_PEER=1 | ||||
SSL_NO_VERIFY_HOSTNAME=1 | SSL_NO_VERIFY_HOSTNAME=1 | ||||
.Ed | .Ed | ||||
.Pp | .Pp | ||||
▲ Show 20 Lines • Show All 125 Lines • Show Last 20 Lines |
Remember to bump the date.