summaryrefslogtreecommitdiffstats
path: root/doc/man3/OSSL_LIB_CTX_set_conf_diagnostics.pod
blob: 80c02afb0cc899a1e3165f08d4336d1670485f59 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
=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