]>
Commit | Line | Data |
---|---|---|
f82bb9cb DSH |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
1bc74519 RS |
5 | CONF_modules_free, CONF_modules_finish, CONF_modules_unload - |
6 | OpenSSL configuration cleanup functions | |
f82bb9cb DSH |
7 | |
8 | =head1 SYNOPSIS | |
9 | ||
10 | #include <openssl/conf.h> | |
11 | ||
f82bb9cb | 12 | void CONF_modules_finish(void); |
fec38ca4 | 13 | void CONF_modules_unload(int all); |
f82bb9cb | 14 | |
3dbf8243 MC |
15 | The following functions have been deprecated since OpenSSL 1.1.0, and can be |
16 | hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value, | |
17 | see L<openssl_user_macros(7)>: | |
cbf6959f | 18 | |
f64f17c3 | 19 | void CONF_modules_free(void); |
cbf6959f | 20 | |
f82bb9cb DSH |
21 | =head1 DESCRIPTION |
22 | ||
23 | CONF_modules_free() closes down and frees up all memory allocated by all | |
b3696a55 RS |
24 | configuration modules. Normally, in versions of OpenSSL prior to 1.1.0, |
25 | applications called | |
26 | CONF_modules_free() at exit to tidy up any configuration performed. | |
f82bb9cb DSH |
27 | |
28 | CONF_modules_finish() calls each configuration modules B<finish> handler | |
29 | to free up any configuration that module may have performed. | |
30 | ||
31 | CONF_modules_unload() finishes and unloads configuration modules. If | |
32 | B<all> is set to B<0> only modules loaded from DSOs will be unloads. If | |
9c0586d5 | 33 | B<all> is B<1> all modules, including built-in modules will be unloaded. |
f82bb9cb | 34 | |
1f13ad31 | 35 | =head1 RETURN VALUES |
f82bb9cb DSH |
36 | |
37 | None of the functions return a value. | |
38 | ||
39 | =head1 SEE ALSO | |
40 | ||
b97fdb57 | 41 | L<config(5)>, L<OPENSSL_config(3)>, |
d8652be0 | 42 | L<CONF_modules_load_file_ex(3)> |
f82bb9cb | 43 | |
cbf6959f MC |
44 | =head1 HISTORY |
45 | ||
b3696a55 RS |
46 | CONF_modules_free() was deprecated in OpenSSL 1.1.0; do not use it. |
47 | For more information see L<OPENSSL_init_crypto(3)>. | |
cbf6959f | 48 | |
e2f92610 RS |
49 | =head1 COPYRIGHT |
50 | ||
33388b44 | 51 | Copyright 2004-2020 The OpenSSL Project Authors. All Rights Reserved. |
e2f92610 | 52 | |
4746f25a | 53 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
54 | this file except in compliance with the License. You can obtain a copy |
55 | in the file LICENSE in the source distribution or at | |
56 | L<https://www.openssl.org/source/license.html>. | |
57 | ||
58 | =cut |