openssl/doc/man3/OSSL_LIB_CTX_set_conf_diagnostics.pod
Tomas Mraz a0d37e200f Add documentation for OSSL_LIB_CTX_set/get_conf_diagnostics
Reviewed-by: Paul Dale <ppzgs1@gmail.com>
Reviewed-by: Neil Horman <nhorman@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/24275)
2024-05-09 09:20:58 +02:00

54 lines
1.7 KiB
Plaintext

=pod
=head1 NAME
OSSL_LIB_CTX_set_conf_diagnostics, OSSL_LIB_CTX_get_conf_diagnostics
- Set and get configuration diagnostics
=head1 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);
=head1 DESCRIPTION
OSSL_LIB_CTX_set_conf_diagnostics() sets the value of the configuration
diagnostics flag. If I<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 L<SSL_CTX_new(3)> and L<SSL_CTX_new_ex(3)> calls. The configuration
diagnostics flag can be also set when a configuration file is being loaded
into B<OSSL_LIB_CTX> with L<OSSL_LIB_CTX_load_config(3)>. If the configuration
sets a B<config_diagnostics> value as described in L<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.
=head1 RETURN VALUES
OSSL_LIB_CTX_get_conf_diagnostics() returns 0 if the configuration diagnostics
should not be performed, nonzero otherwise.
=head1 SEE ALSO
L<SSL_CTX_new(3)>, L<OSSL_LIB_CTX_load_config(3)>, L<config(5)>
=head1 HISTORY
The functions described on this page were added in OpenSSL 3.4.
=head1 COPYRIGHT
Copyright 2024 The OpenSSL Project Authors. All Rights Reserved.
Licensed under the Apache License 2.0 (the "License"). You may not use
this file except in compliance with the License. You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.
=cut