OpenBSD manual page server

Manual Page Search Parameters

OPENSSL_CONFIG(3) Library Functions Manual OPENSSL_CONFIG(3)

OPENSSL_config, OPENSSL_no_configsimple crypto and ssl library configuration

#include <openssl/conf.h>

void
OPENSSL_config(const char *appname);

void
OPENSSL_no_config(void);

OPENSSL_config() initializes the crypto library and calls CONF_modules_load_file(3) with the standard configuration file and the given appname. If appname is NULL, then the default name openssl_conf is used. Any errors are ignored. Further calls to OPENSSL_config() have no effect.

OPENSSL_no_config() suppresses the loading of the standard configuration file, so that any future calls to OPENSSL_config() or to OPENSSL_init_crypto(3) will ensure the library is initialized but no configuration file will be loaded.

Calling these functions is optional. All required initialization of the crypto libraries happens automatically when needed.

To use a non-standard configuration file, refer to CONF_modules_load_file(3).

Internally, OPENSSL_config() calls OPENSSL_init_crypto(3), OPENSSL_load_builtin_modules(3), and ENGINE_load_builtin_engines(3).

If an application is compiled with the preprocessor symbol OPENSSL_LOAD_CONF #define'd, OpenSSL_add_all_algorithms(3) automatically calls OPENSSL_config().

Applications should free up configuration at application closedown by calling CONF_modules_free(3).

/etc/ssl/openssl.cnf
standard configuration file

CONF_modules_free(3), CONF_modules_load_file(3), crypto(3), OPENSSL_load_builtin_modules(3), OPENSSL_VERSION_NUMBER(3), openssl.cnf(5), x509v3.cnf(5)

OPENSSL_config() and OPENSSL_no_config() first appeared in OpenSSL 0.9.7 and have been available since OpenBSD 3.2.

June 14, 2019 OpenBSD-current