diff options
Diffstat (limited to 'src/lib/libcrypto/man/OPENSSL_config.3')
-rw-r--r-- | src/lib/libcrypto/man/OPENSSL_config.3 | 39 |
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 |
84 | These functions have been deprecated since OpenSSL 1.1.0. | ||
85 | It is recommended to use | ||
86 | .Xr CONF_modules_load_file 3 | ||
87 | instead of | ||
88 | .Fn OPENSSL_config | ||
89 | or | ||
90 | .Xr OPENSSL_init_crypto 3 | ||
91 | with | ||
92 | .Dv OPENSSL_INIT_NO_LOAD_CONFIG | ||
93 | instead of | ||
94 | .Fn OPENSSL_no_config . | ||
95 | Except to disable the standard configuration file, application programs | ||
96 | do not need to call any library initialization function at all because | ||
97 | LibreSSL does all the required initialization automatically, and so does | ||
98 | OpenSSL 1.1.0 and later. | ||
99 | .Pp | ||
100 | .Fn OPENSSL_config | 84 | .Fn OPENSSL_config |
101 | initializes the crypto library, in particular calling | 85 | initializes the crypto library with |
102 | .Xr OPENSSL_init_crypto 3 | 86 | .Xr OPENSSL_init_crypto 3 |
87 | and then calls | ||
88 | .Xr OPENSSL_load_builtin_modules 3 , | ||
89 | .Xr ENGINE_load_builtin_engines 3 , | ||
103 | and | 90 | and |
104 | .Xr CONF_modules_load_file 3 | 91 | .Xr CONF_modules_load_file 3 |
105 | with the standard configuration file and the given | 92 | with the standard configuration file and the given |
@@ -117,10 +104,13 @@ Further calls to | |||
117 | have no effect. | 104 | have no effect. |
118 | .Pp | 105 | .Pp |
119 | .Fn OPENSSL_no_config | 106 | .Fn OPENSSL_no_config |
120 | disables configuration. | 107 | has no effect except that later calls to |
121 | If called before | 108 | .Fn OPENSSL_config |
122 | .Fn OPENSSL_config , | 109 | will be ignored. |
123 | no configuration takes place. | 110 | .Pp |
111 | Calling these functions is optional. | ||
112 | All required initialization of the crypto libraries happens | ||
113 | automatically when needed. | ||
124 | .Pp | 114 | .Pp |
125 | If an application is compiled with the preprocessor symbol | 115 | If 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 |