OSSL_LIB_CTX_set_conf_diagnostics.3ossl - Man Page

Set and get configuration diagnostics

Synopsis

 #include <openssl/crypto.h>

 void OSSL_LIB_CTX_set_conf_diagnostics(OSSL_LIB_CTX *ctx, int value);
 int OSSL_LIB_CTX_get_conf_diagnostics(OSSL_LIB_CTX *ctx);

Description

OSSL_LIB_CTX_set_conf_diagnostics() sets the value of the configuration diagnostics flag. If value is nonzero subsequent parsing and application of configuration data can report errors that would otherwise be ignored. In particular any errors in the ssl configuration module will cause a failure of SSL_CTX_new(3) and SSL_CTX_new_ex(3) calls. The configuration diagnostics flag can be also set when a configuration file is being loaded into OSSL_LIB_CTX with OSSL_LIB_CTX_load_config(3). If the configuration sets a config_diagnostics value as described in config(5), it will override the value set by OSSL_LIB_CTX_set_conf_diagnostics() before loading the configuration file.

OSSL_LIB_CTX_get_conf_diagnostics() returns the current value of the configuration diagnostics flag.

Return Values

OSSL_LIB_CTX_get_conf_diagnostics() returns 0 if the configuration diagnostics should not be performed, nonzero otherwise.

See Also

SSL_CTX_new(3), OSSL_LIB_CTX_load_config(3), config(5)

History

The functions described on this page were added in OpenSSL 3.4.

Referenced By

The man page OSSL_LIB_CTX_get_conf_diagnostics.3ossl(3) is an alias of OSSL_LIB_CTX_set_conf_diagnostics.3ossl(3).

2025-03-26 3.5.0-beta1 OpenSSL