xref: /freebsd-src/crypto/openssl/doc/man3/OPENSSL_load_builtin_modules.pod (revision e71b70530d95c4f34d8bdbd78d1242df1ba4a945)
1*e71b7053SJung-uk Kim=pod
2*e71b7053SJung-uk Kim
3*e71b7053SJung-uk Kim=head1 NAME
4*e71b7053SJung-uk Kim
5*e71b7053SJung-uk KimOPENSSL_load_builtin_modules, ASN1_add_oid_module, ENGINE_add_conf_module - add standard configuration modules
6*e71b7053SJung-uk Kim
7*e71b7053SJung-uk Kim=head1 SYNOPSIS
8*e71b7053SJung-uk Kim
9*e71b7053SJung-uk Kim #include <openssl/conf.h>
10*e71b7053SJung-uk Kim
11*e71b7053SJung-uk Kim void OPENSSL_load_builtin_modules(void);
12*e71b7053SJung-uk Kim void ASN1_add_oid_module(void);
13*e71b7053SJung-uk Kim void ENGINE_add_conf_module(void);
14*e71b7053SJung-uk Kim
15*e71b7053SJung-uk Kim=head1 DESCRIPTION
16*e71b7053SJung-uk Kim
17*e71b7053SJung-uk KimThe function OPENSSL_load_builtin_modules() adds all the standard OpenSSL
18*e71b7053SJung-uk Kimconfiguration modules to the internal list. They can then be used by the
19*e71b7053SJung-uk KimOpenSSL configuration code.
20*e71b7053SJung-uk Kim
21*e71b7053SJung-uk KimASN1_add_oid_module() adds just the ASN1 OBJECT module.
22*e71b7053SJung-uk Kim
23*e71b7053SJung-uk KimENGINE_add_conf_module() adds just the ENGINE configuration module.
24*e71b7053SJung-uk Kim
25*e71b7053SJung-uk Kim=head1 NOTES
26*e71b7053SJung-uk Kim
27*e71b7053SJung-uk KimIf the simple configuration function OPENSSL_config() is called then
28*e71b7053SJung-uk KimOPENSSL_load_builtin_modules() is called automatically.
29*e71b7053SJung-uk Kim
30*e71b7053SJung-uk KimApplications which use the configuration functions directly will need to
31*e71b7053SJung-uk Kimcall OPENSSL_load_builtin_modules() themselves I<before> any other
32*e71b7053SJung-uk Kimconfiguration code.
33*e71b7053SJung-uk Kim
34*e71b7053SJung-uk KimApplications should call OPENSSL_load_builtin_modules() to load all
35*e71b7053SJung-uk Kimconfiguration modules instead of adding modules selectively: otherwise
36*e71b7053SJung-uk Kimfunctionality may be missing from the application if an when new
37*e71b7053SJung-uk Kimmodules are added.
38*e71b7053SJung-uk Kim
39*e71b7053SJung-uk Kim=head1 RETURN VALUES
40*e71b7053SJung-uk Kim
41*e71b7053SJung-uk KimNone of the functions return a value.
42*e71b7053SJung-uk Kim
43*e71b7053SJung-uk Kim=head1 SEE ALSO
44*e71b7053SJung-uk Kim
45*e71b7053SJung-uk KimL<config(5)>, L<OPENSSL_config(3)>
46*e71b7053SJung-uk Kim
47*e71b7053SJung-uk Kim=head1 COPYRIGHT
48*e71b7053SJung-uk Kim
49*e71b7053SJung-uk KimCopyright 2004-2018 The OpenSSL Project Authors. All Rights Reserved.
50*e71b7053SJung-uk Kim
51*e71b7053SJung-uk KimLicensed under the OpenSSL license (the "License").  You may not use
52*e71b7053SJung-uk Kimthis file except in compliance with the License.  You can obtain a copy
53*e71b7053SJung-uk Kimin the file LICENSE in the source distribution or at
54*e71b7053SJung-uk KimL<https://www.openssl.org/source/license.html>.
55*e71b7053SJung-uk Kim
56*e71b7053SJung-uk Kim=cut
57