jcs.org
jcs's openbsd hax
openbsd
1.\" $OpenBSD: OPENSSL_init_ssl.3,v 1.5 2025/06/08 22:52:00 schwarze Exp $
2.\" Copyright (c) 2018 Ingo Schwarze <schwarze@openbsd.org>
3.\"
4.\" Permission to use, copy, modify, and distribute this software for any
5.\" purpose with or without fee is hereby granted, provided that the above
6.\" copyright notice and this permission notice appear in all copies.
7.\"
8.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15.\"
16.Dd $Mdocdate: June 8 2025 $
17.Dt OPENSSL_INIT_SSL 3
18.Os
19.Sh NAME
20.Nm OPENSSL_init_ssl
21.Nd initialise the crypto and ssl libraries
22.Sh SYNOPSIS
23.Lb libssl libcrypto
24.In openssl/ssl.h
25.Ft int
26.Fo OPENSSL_init_ssl
27.Fa "uint64_t options"
28.Fa "const void *dummy"
29.Fc
30.Sh DESCRIPTION
31This function is deprecated.
32It is never useful for any application program to call it explicitly.
33The library automatically calls it internally with an
34.Fa options
35argument of 0 whenever needed.
36It is safest to assume that any function may do so.
37.Pp
38To enable or disable the standard configuration file, instead use
39.Xr OPENSSL_config 3
40or
41.Xr OPENSSL_no_config 3 ,
42respectively.
43To load a non-standard configuration file, refer to
44.Xr CONF_modules_load_file 3 .
45.Pp
46.Fn OPENSSL_init_ssl
47calls
48.Xr OPENSSL_init_crypto 3 ,
49.Xr SSL_load_error_strings 3 ,
50and
51.Xr SSL_library_init 3 .
52.Pp
53The
54.Fa options
55argument is passed on to
56.Xr OPENSSL_init_crypto 3
57and the
58.Fa dummy
59argument is ignored.
60.Pp
61If this function is called more than once,
62none of the calls except the first one have any effect.
63.Sh RETURN VALUES
64.Fn OPENSSL_init_ssl
65is intended to return 1 on success or 0 on error.
66.Sh SEE ALSO
67.Xr CONF_modules_load_file 3 ,
68.Xr OPENSSL_config 3 ,
69.Xr ssl 3
70.Sh HISTORY
71.Fn OPENSSL_init_ssl
72first appeared in OpenSSL 1.1.0 and has been available since
73.Ox 6.3 .
74.Sh BUGS
75.Fn OPENSSL_init_ssl
76silently ignores even more configuration failures than
77.Xr OPENSSL_init_crypto 3 .