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 |
