1*536f31e8Sschwarze.\" $OpenBSD: OPENSSL_init_ssl.3,v 1.4 2019/06/14 13:41:31 schwarze Exp $ 2595e8f71Sschwarze.\" Copyright (c) 2018 Ingo Schwarze <schwarze@openbsd.org> 3595e8f71Sschwarze.\" 4595e8f71Sschwarze.\" Permission to use, copy, modify, and distribute this software for any 5595e8f71Sschwarze.\" purpose with or without fee is hereby granted, provided that the above 6595e8f71Sschwarze.\" copyright notice and this permission notice appear in all copies. 7595e8f71Sschwarze.\" 8595e8f71Sschwarze.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 9595e8f71Sschwarze.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 10595e8f71Sschwarze.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 11595e8f71Sschwarze.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 12595e8f71Sschwarze.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 13595e8f71Sschwarze.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 14595e8f71Sschwarze.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 15595e8f71Sschwarze.\" 16*536f31e8Sschwarze.Dd $Mdocdate: June 14 2019 $ 17595e8f71Sschwarze.Dt OPENSSL_INIT_SSL 3 18595e8f71Sschwarze.Os 19595e8f71Sschwarze.Sh NAME 20595e8f71Sschwarze.Nm OPENSSL_init_ssl 21595e8f71Sschwarze.Nd initialise the crypto and ssl libraries 22595e8f71Sschwarze.Sh SYNOPSIS 23595e8f71Sschwarze.In openssl/ssl.h 24595e8f71Sschwarze.Ft int 25595e8f71Sschwarze.Fo OPENSSL_init_ssl 26595e8f71Sschwarze.Fa "uint64_t options" 27595e8f71Sschwarze.Fa "const void *dummy" 28595e8f71Sschwarze.Fc 29595e8f71Sschwarze.Sh DESCRIPTION 30*536f31e8SschwarzeThis function is deprecated. 31*536f31e8SschwarzeIt is never useful for any application program to call it explicitly. 32*536f31e8SschwarzeThe library automatically calls it internally with an 33*536f31e8Sschwarze.Fa options 34*536f31e8Sschwarzeargument of 0 whenever needed. 35*536f31e8SschwarzeIt is safest to assume that any function may do so. 36*536f31e8Sschwarze.Pp 37*536f31e8SschwarzeTo enable or disable the standard configuration file, instead use 38*536f31e8Sschwarze.Xr OPENSSL_config 3 39*536f31e8Sschwarzeor 40*536f31e8Sschwarze.Xr OPENSSL_no_config 3 , 41*536f31e8Sschwarzerespectively. 42*536f31e8SschwarzeTo load a non-standard configuration file, refer to 43*536f31e8Sschwarze.Xr CONF_modules_load_file 3 . 44*536f31e8Sschwarze.Pp 45595e8f71Sschwarze.Fn OPENSSL_init_ssl 46595e8f71Sschwarzecalls 47*536f31e8Sschwarze.Xr OPENSSL_init_crypto 3 , 48*536f31e8Sschwarze.Xr SSL_load_error_strings 3 , 49*536f31e8Sschwarzeand 50*536f31e8Sschwarze.Xr SSL_library_init 3 . 51595e8f71Sschwarze.Pp 52595e8f71SschwarzeThe 53595e8f71Sschwarze.Fa options 54595e8f71Sschwarzeargument is passed on to 55595e8f71Sschwarze.Xr OPENSSL_init_crypto 3 56595e8f71Sschwarzeand the 57595e8f71Sschwarze.Fa dummy 58595e8f71Sschwarzeargument is ignored. 59595e8f71Sschwarze.Pp 60595e8f71SschwarzeIf this function is called more than once, 61595e8f71Sschwarzenone of the calls except the first one have any effect. 62595e8f71Sschwarze.Sh RETURN VALUES 63595e8f71Sschwarze.Fn OPENSSL_init_ssl 64595e8f71Sschwarzeis intended to return 1 on success or 0 on error. 65595e8f71Sschwarze.Sh SEE ALSO 66595e8f71Sschwarze.Xr CONF_modules_load_file 3 , 67*536f31e8Sschwarze.Xr OPENSSL_config 3 , 687a73e666Sschwarze.Xr ssl 3 69595e8f71Sschwarze.Sh HISTORY 70595e8f71Sschwarze.Fn OPENSSL_init_ssl 7120b9f7f9Sschwarzefirst appeared in OpenSSL 1.1.0 and has been available since 7220b9f7f9Sschwarze.Ox 6.3 . 73595e8f71Sschwarze.Sh BUGS 74595e8f71Sschwarze.Fn OPENSSL_init_ssl 75595e8f71Sschwarzesilently ignores even more configuration failures than 76595e8f71Sschwarze.Xr OPENSSL_init_crypto 3 . 77