fetch.3 (b33a8b38225a600626f8fc4b3718f4bd79e773dc) fetch.3 (fe85238ef758d1adead72be009d07c597fdba0bb)
1.\"-
2.\" Copyright (c) 1998-2013 Dag-Erling Smørgrav
3.\" Copyright (c) 2013-2016 Michael Gmelin <freebsd@grem.de>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:

--- 12 unchanged lines hidden (view full) ---

21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
1.\"-
2.\" Copyright (c) 1998-2013 Dag-Erling Smørgrav
3.\" Copyright (c) 2013-2016 Michael Gmelin <freebsd@grem.de>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:

--- 12 unchanged lines hidden (view full) ---

21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd August 28, 2019
29.Dd November 24, 2020
30.Dt FETCH 3
31.Os
32.Sh NAME
33.Nm fetchMakeURL ,
34.Nm fetchParseURL ,
35.Nm fetchFreeURL ,
36.Nm fetchXGetURL ,
37.Nm fetchGetURL ,

--- 422 unchanged lines hidden (view full) ---

460input (see
461.Xr PEM 3 ) .
462.Pp
463By default
464.Nm libfetch
465allows TLSv1 and newer when negotiating the connecting with the remote
466peer.
467You can change this behavior by setting the
30.Dt FETCH 3
31.Os
32.Sh NAME
33.Nm fetchMakeURL ,
34.Nm fetchParseURL ,
35.Nm fetchFreeURL ,
36.Nm fetchXGetURL ,
37.Nm fetchGetURL ,

--- 422 unchanged lines hidden (view full) ---

460input (see
461.Xr PEM 3 ) .
462.Pp
463By default
464.Nm libfetch
465allows TLSv1 and newer when negotiating the connecting with the remote
466peer.
467You can change this behavior by setting the
468.Ev SSL_ALLOW_SSL3
469environment variable to allow SSLv3 and
470.Ev SSL_NO_TLS1 ,
471.Ev SSL_NO_TLS1_1 and
472.Ev SSL_NO_TLS1_2
468.Ev SSL_NO_TLS1 ,
469.Ev SSL_NO_TLS1_1 and
470.Ev SSL_NO_TLS1_2
473to disable TLS 1.0, 1.1 and 1.2 respectively.
471environment variables to disable TLS 1.0, 1.1 and 1.2 respectively.
474.Sh AUTHENTICATION
475Apart from setting the appropriate environment variables and
476specifying the user name and password in the URL or the
477.Vt struct url ,
478the calling program has the option of defining an authentication
479function with the following prototype:
480.Pp
481.Ft int

--- 188 unchanged lines hidden (view full) ---

670for compatibility.
671.It Ev SOCKS5_PROXY
672Uses SOCKS version 5 to make connection.
673The format must be the IP or hostname followed by a colon for the port.
674IPv6 addresses must enclose the address in brackets.
675If no port is specified, the default is 1080.
676This setting will supercede a connection to an
677.Ev HTTP_PROXY .
472.Sh AUTHENTICATION
473Apart from setting the appropriate environment variables and
474specifying the user name and password in the URL or the
475.Vt struct url ,
476the calling program has the option of defining an authentication
477function with the following prototype:
478.Pp
479.Ft int

--- 188 unchanged lines hidden (view full) ---

668for compatibility.
669.It Ev SOCKS5_PROXY
670Uses SOCKS version 5 to make connection.
671The format must be the IP or hostname followed by a colon for the port.
672IPv6 addresses must enclose the address in brackets.
673If no port is specified, the default is 1080.
674This setting will supercede a connection to an
675.Ev HTTP_PROXY .
678.It Ev SSL_ALLOW_SSL3
679Allow SSL version 3 when negotiating the connection (not recommended).
680.It Ev SSL_CA_CERT_FILE
681CA certificate bundle containing trusted CA certificates.
682Default value: See HTTPS SCHEME above.
683.It Ev SSL_CA_CERT_PATH
684Path containing trusted CA hashes.
685.It Ev SSL_CLIENT_CERT_FILE
686PEM encoded client certificate/key which will be used in
687client certificate authentication.

--- 194 unchanged lines hidden ---
676.It Ev SSL_CA_CERT_FILE
677CA certificate bundle containing trusted CA certificates.
678Default value: See HTTPS SCHEME above.
679.It Ev SSL_CA_CERT_PATH
680Path containing trusted CA hashes.
681.It Ev SSL_CLIENT_CERT_FILE
682PEM encoded client certificate/key which will be used in
683client certificate authentication.

--- 194 unchanged lines hidden ---