xref: /netbsd-src/crypto/external/bsd/openssl.old/dist/doc/man3/CONF_modules_free.pod (revision 4724848cf0da353df257f730694b7882798e5daf)
1*4724848cSchristos=pod
2*4724848cSchristos
3*4724848cSchristos=head1 NAME
4*4724848cSchristos
5*4724848cSchristosCONF_modules_free, CONF_modules_finish, CONF_modules_unload -
6*4724848cSchristosOpenSSL configuration cleanup functions
7*4724848cSchristos
8*4724848cSchristos=head1 SYNOPSIS
9*4724848cSchristos
10*4724848cSchristos #include <openssl/conf.h>
11*4724848cSchristos
12*4724848cSchristos void CONF_modules_finish(void);
13*4724848cSchristos void CONF_modules_unload(int all);
14*4724848cSchristos
15*4724848cSchristosDeprecated:
16*4724848cSchristos
17*4724848cSchristos #if OPENSSL_API_COMPAT < 0x10100000L
18*4724848cSchristos void CONF_modules_free(void)
19*4724848cSchristos #endif
20*4724848cSchristos
21*4724848cSchristos=head1 DESCRIPTION
22*4724848cSchristos
23*4724848cSchristosCONF_modules_free() closes down and frees up all memory allocated by all
24*4724848cSchristosconfiguration modules.  Normally, in versions of OpenSSL prior to 1.1.0,
25*4724848cSchristosapplications called
26*4724848cSchristosCONF_modules_free() at exit to tidy up any configuration performed.
27*4724848cSchristos
28*4724848cSchristosCONF_modules_finish() calls each configuration modules B<finish> handler
29*4724848cSchristosto free up any configuration that module may have performed.
30*4724848cSchristos
31*4724848cSchristosCONF_modules_unload() finishes and unloads configuration modules. If
32*4724848cSchristosB<all> is set to B<0> only modules loaded from DSOs will be unloads. If
33*4724848cSchristosB<all> is B<1> all modules, including builtin modules will be unloaded.
34*4724848cSchristos
35*4724848cSchristos=head1 RETURN VALUES
36*4724848cSchristos
37*4724848cSchristosNone of the functions return a value.
38*4724848cSchristos
39*4724848cSchristos=head1 SEE ALSO
40*4724848cSchristos
41*4724848cSchristosL<config(5)>, L<OPENSSL_config(3)>,
42*4724848cSchristosL<CONF_modules_load_file(3)>
43*4724848cSchristos
44*4724848cSchristos=head1 HISTORY
45*4724848cSchristos
46*4724848cSchristosCONF_modules_free() was deprecated in OpenSSL 1.1.0; do not use it.
47*4724848cSchristosFor more information see L<OPENSSL_init_crypto(3)>.
48*4724848cSchristos
49*4724848cSchristos=head1 COPYRIGHT
50*4724848cSchristos
51*4724848cSchristosCopyright 2004-2018 The OpenSSL Project Authors. All Rights Reserved.
52*4724848cSchristos
53*4724848cSchristosLicensed under the OpenSSL license (the "License").  You may not use
54*4724848cSchristosthis file except in compliance with the License.  You can obtain a copy
55*4724848cSchristosin the file LICENSE in the source distribution or at
56*4724848cSchristosL<https://www.openssl.org/source/license.html>.
57*4724848cSchristos
58*4724848cSchristos=cut
59