1=pod
2
3=head1 NAME
4
5OSSL_LIB_CTX_set_conf_diagnostics, OSSL_LIB_CTX_get_conf_diagnostics
6- Set and get configuration diagnostics
7
8=head1 SYNOPSIS
9
10 #include <openssl/crypto.h>
11
12 void OSSL_LIB_CTX_set_conf_diagnostics(OSSL_LIB_CTX *ctx, int value);
13 int OSSL_LIB_CTX_get_conf_diagnostics(OSSL_LIB_CTX *ctx);
14
15=head1 DESCRIPTION
16
17OSSL_LIB_CTX_set_conf_diagnostics() sets the value of the configuration
18diagnostics flag. If I<value> is nonzero subsequent parsing and application
19of configuration data can report errors that would otherwise be ignored. In
20particular any errors in the ssl configuration module will cause a failure
21of L<SSL_CTX_new(3)> and L<SSL_CTX_new_ex(3)> calls. The configuration
22diagnostics flag can be also set when a configuration file is being loaded
23into B<OSSL_LIB_CTX> with L<OSSL_LIB_CTX_load_config(3)>. If the configuration
24sets a B<config_diagnostics> value as described in L<config(5)>, it will
25override the value set by OSSL_LIB_CTX_set_conf_diagnostics() before
26loading the configuration file.
27
28OSSL_LIB_CTX_get_conf_diagnostics() returns the current value of the
29configuration diagnostics flag.
30
31=head1 RETURN VALUES
32
33OSSL_LIB_CTX_get_conf_diagnostics() returns 0 if the configuration diagnostics
34should not be performed, nonzero otherwise.
35
36=head1 SEE ALSO
37
38L<SSL_CTX_new(3)>, L<OSSL_LIB_CTX_load_config(3)>, L<config(5)>
39
40=head1 HISTORY
41
42The functions described on this page were added in OpenSSL 3.4.
43
44=head1 COPYRIGHT
45
46Copyright 2024 The OpenSSL Project Authors. All Rights Reserved.
47
48Licensed under the Apache License 2.0 (the "License").  You may not use
49this file except in compliance with the License.  You can obtain a copy
50in the file LICENSE in the source distribution or at
51L<https://www.openssl.org/source/license.html>.
52
53=cut
54