summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/OPENSSL_config.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/OPENSSL_config.3')
-rw-r--r--src/lib/libcrypto/man/OPENSSL_config.339
1 files changed, 15 insertions, 24 deletions
diff --git a/src/lib/libcrypto/man/OPENSSL_config.3 b/src/lib/libcrypto/man/OPENSSL_config.3
index 6e2a1ef56f..cdfdb3fea4 100644
--- a/src/lib/libcrypto/man/OPENSSL_config.3
+++ b/src/lib/libcrypto/man/OPENSSL_config.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: OPENSSL_config.3,v 1.8 2018/03/17 20:18:44 schwarze Exp $ 1.\" $OpenBSD: OPENSSL_config.3,v 1.9 2018/03/21 22:08:04 schwarze Exp $
2.\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file is a derived work. 4.\" This file is a derived work.
@@ -65,13 +65,13 @@
65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
66.\" OF THE POSSIBILITY OF SUCH DAMAGE. 66.\" OF THE POSSIBILITY OF SUCH DAMAGE.
67.\" 67.\"
68.Dd $Mdocdate: March 17 2018 $ 68.Dd $Mdocdate: March 21 2018 $
69.Dt OPENSSL_CONFIG 3 69.Dt OPENSSL_CONFIG 3
70.Os 70.Os
71.Sh NAME 71.Sh NAME
72.Nm OPENSSL_config , 72.Nm OPENSSL_config ,
73.Nm OPENSSL_no_config 73.Nm OPENSSL_no_config
74.Nd old style crypto and ssl library initialization 74.Nd simple crypto and ssl library configuration
75.Sh SYNOPSIS 75.Sh SYNOPSIS
76.In openssl/conf.h 76.In openssl/conf.h
77.Ft void 77.Ft void
@@ -81,25 +81,12 @@
81.Ft void 81.Ft void
82.Fn OPENSSL_no_config void 82.Fn OPENSSL_no_config void
83.Sh DESCRIPTION 83.Sh DESCRIPTION
84These functions have been deprecated since OpenSSL 1.1.0.
85It is recommended to use
86.Xr CONF_modules_load_file 3
87instead of
88.Fn OPENSSL_config
89or
90.Xr OPENSSL_init_crypto 3
91with
92.Dv OPENSSL_INIT_NO_LOAD_CONFIG
93instead of
94.Fn OPENSSL_no_config .
95Except to disable the standard configuration file, application programs
96do not need to call any library initialization function at all because
97LibreSSL does all the required initialization automatically, and so does
98OpenSSL 1.1.0 and later.
99.Pp
100.Fn OPENSSL_config 84.Fn OPENSSL_config
101initializes the crypto library, in particular calling 85initializes the crypto library with
102.Xr OPENSSL_init_crypto 3 86.Xr OPENSSL_init_crypto 3
87and then calls
88.Xr OPENSSL_load_builtin_modules 3 ,
89.Xr ENGINE_load_builtin_engines 3 ,
103and 90and
104.Xr CONF_modules_load_file 3 91.Xr CONF_modules_load_file 3
105with the standard configuration file and the given 92with the standard configuration file and the given
@@ -117,10 +104,13 @@ Further calls to
117have no effect. 104have no effect.
118.Pp 105.Pp
119.Fn OPENSSL_no_config 106.Fn OPENSSL_no_config
120disables configuration. 107has no effect except that later calls to
121If called before 108.Fn OPENSSL_config
122.Fn OPENSSL_config , 109will be ignored.
123no configuration takes place. 110.Pp
111Calling these functions is optional.
112All required initialization of the crypto libraries happens
113automatically when needed.
124.Pp 114.Pp
125If an application is compiled with the preprocessor symbol 115If an application is compiled with the preprocessor symbol
126.Dv OPENSSL_LOAD_CONF 116.Dv OPENSSL_LOAD_CONF
@@ -141,6 +131,7 @@ standard configuration file
141.Xr CONF_modules_free 3 , 131.Xr CONF_modules_free 3 ,
142.Xr CONF_modules_load_file 3 , 132.Xr CONF_modules_load_file 3 ,
143.Xr OPENSSL_init_crypto 3 , 133.Xr OPENSSL_init_crypto 3 ,
134.Xr OPENSSL_load_builtin_modules 3 ,
144.Xr openssl.cnf 5 135.Xr openssl.cnf 5
145.Sh HISTORY 136.Sh HISTORY
146.Fn OPENSSL_config 137.Fn OPENSSL_config