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