xref: /netbsd-src/crypto/external/bsd/openssl/dist/doc/man3/CONF_modules_free.pod (revision b0d1725196a7921d003d2c66a14f186abda4176b)
113d40330Schristos=pod
213d40330Schristos
313d40330Schristos=head1 NAME
413d40330Schristos
513d40330SchristosCONF_modules_free, CONF_modules_finish, CONF_modules_unload -
613d40330SchristosOpenSSL configuration cleanup functions
713d40330Schristos
813d40330Schristos=head1 SYNOPSIS
913d40330Schristos
1013d40330Schristos #include <openssl/conf.h>
1113d40330Schristos
1213d40330Schristos void CONF_modules_finish(void);
1313d40330Schristos void CONF_modules_unload(int all);
1413d40330Schristos
15*b0d17251SchristosThe following functions have been deprecated since OpenSSL 1.1.0, and can be
16*b0d17251Schristoshidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value,
17*b0d17251Schristossee L<openssl_user_macros(7)>:
1813d40330Schristos
19*b0d17251Schristos void CONF_modules_free(void);
2013d40330Schristos
2113d40330Schristos=head1 DESCRIPTION
2213d40330Schristos
2313d40330SchristosCONF_modules_free() closes down and frees up all memory allocated by all
2413d40330Schristosconfiguration modules.  Normally, in versions of OpenSSL prior to 1.1.0,
2513d40330Schristosapplications called
2613d40330SchristosCONF_modules_free() at exit to tidy up any configuration performed.
2713d40330Schristos
2813d40330SchristosCONF_modules_finish() calls each configuration modules B<finish> handler
2913d40330Schristosto free up any configuration that module may have performed.
3013d40330Schristos
3113d40330SchristosCONF_modules_unload() finishes and unloads configuration modules. If
3213d40330SchristosB<all> is set to B<0> only modules loaded from DSOs will be unloads. If
33*b0d17251SchristosB<all> is B<1> all modules, including built-in modules will be unloaded.
3413d40330Schristos
3513d40330Schristos=head1 RETURN VALUES
3613d40330Schristos
3713d40330SchristosNone of the functions return a value.
3813d40330Schristos
3913d40330Schristos=head1 SEE ALSO
4013d40330Schristos
4113d40330SchristosL<config(5)>, L<OPENSSL_config(3)>,
42*b0d17251SchristosL<CONF_modules_load_file_ex(3)>
4313d40330Schristos
4413d40330Schristos=head1 HISTORY
4513d40330Schristos
4613d40330SchristosCONF_modules_free() was deprecated in OpenSSL 1.1.0; do not use it.
4713d40330SchristosFor more information see L<OPENSSL_init_crypto(3)>.
4813d40330Schristos
4913d40330Schristos=head1 COPYRIGHT
5013d40330Schristos
51*b0d17251SchristosCopyright 2004-2021 The OpenSSL Project Authors. All Rights Reserved.
5213d40330Schristos
53*b0d17251SchristosLicensed under the Apache License 2.0 (the "License").  You may not use
5413d40330Schristosthis file except in compliance with the License.  You can obtain a copy
5513d40330Schristosin the file LICENSE in the source distribution or at
5613d40330SchristosL<https://www.openssl.org/source/license.html>.
5713d40330Schristos
5813d40330Schristos=cut
59