From 1c6dd887ec8f9d6b87ce2f220e839fbe1b78db67 Mon Sep 17 00:00:00 2001 From: schwarze <> Date: Fri, 14 Jun 2019 13:41:31 +0000 Subject: Further improve the documentation of library initialization and configuration. Among other improvements: * Use a uniform wording at the top of the DECSRIPTION for obsolete pages. * Better explain how to use a non-standard configuration file. * Remove obsolete functions from SEE ALSO. Triggered by some suggestions from tb@. Tweaks and OK tb@. --- src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) (limited to 'src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3') diff --git a/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 b/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 index fd9e656bce..bcfb363ca4 100644 --- a/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 +++ b/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: OPENSSL_load_builtin_modules.3,v 1.5 2018/03/22 21:08:22 schwarze Exp $ +.\" $OpenBSD: OPENSSL_load_builtin_modules.3,v 1.6 2019/06/14 13:41:31 schwarze Exp $ .\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 .\" .\" This file was written by Dr. Stephen Henson . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: March 22 2018 $ +.Dd $Mdocdate: June 14 2019 $ .Dt OPENSSL_LOAD_BUILTIN_MODULES 3 .Os .Sh NAME @@ -83,19 +83,23 @@ is called then .Fn OPENSSL_load_builtin_modules is called automatically. .Pp -Applications which use the configuration functions directly will need to -call +Applications which use configuration functions like +.Xr CONF_modules_load_file 3 +directly need to call .Fn OPENSSL_load_builtin_modules themselves .Em before any other configuration code. .Pp Applications should call +.Xr OPENSSL_config 3 +or .Fn OPENSSL_load_builtin_modules to load all configuration modules instead of adding modules selectively: otherwise functionality may be missing from the application when new modules are added. .Sh SEE ALSO +.Xr CONF_modules_load_file 3 , .Xr OPENSSL_config 3 .Sh HISTORY These functions first appeared in OpenSSL 0.9.7 -- cgit v1.2.3-55-g6feb