1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948 CONF_modules_load_file, CONF_modules_load - OpenSSL configuration functions
6*2175Sjp161948
7*2175Sjp161948=head1 SYNOPSIS
8*2175Sjp161948
9*2175Sjp161948 #include <openssl/conf.h>
10*2175Sjp161948
11*2175Sjp161948 int CONF_modules_load_file(const char *filename, const char *appname,
12*2175Sjp161948			   unsigned long flags);
13*2175Sjp161948 int CONF_modules_load(const CONF *cnf, const char *appname,
14*2175Sjp161948		      unsigned long flags);
15*2175Sjp161948
16*2175Sjp161948=head1 DESCRIPTION
17*2175Sjp161948
18*2175Sjp161948The function CONF_modules_load_file() configures OpenSSL using file
19*2175Sjp161948B<filename> and application name B<appname>. If B<filename> is NULL
20*2175Sjp161948the standard OpenSSL configuration file is used. If B<appname> is
21*2175Sjp161948NULL the standard OpenSSL application name B<openssl_conf> is used.
22*2175Sjp161948The behaviour can be cutomized using B<flags>.
23*2175Sjp161948
24*2175Sjp161948CONF_modules_load() is idential to CONF_modules_load_file() except it
25*2175Sjp161948read configuration information from B<cnf>.
26*2175Sjp161948
27*2175Sjp161948=head1 NOTES
28*2175Sjp161948
29*2175Sjp161948The following B<flags> are currently recognized:
30*2175Sjp161948
31*2175Sjp161948B<CONF_MFLAGS_IGNORE_ERRORS> if set errors returned by individual
32*2175Sjp161948configuration modules are ignored. If not set the first module error is
33*2175Sjp161948considered fatal and no further modules are loads.
34*2175Sjp161948
35*2175Sjp161948Normally any modules errors will add error information to the error queue. If
36*2175Sjp161948B<CONF_MFLAGS_SILENT> is set no error information is added.
37*2175Sjp161948
38*2175Sjp161948If B<CONF_MFLAGS_NO_DSO> is set configuration module loading from DSOs is
39*2175Sjp161948disabled.
40*2175Sjp161948
41*2175Sjp161948B<CONF_MFLAGS_IGNORE_MISSING_FILE> if set will make CONF_load_modules_file()
42*2175Sjp161948ignore missing configuration files. Normally a missing configuration file
43*2175Sjp161948return an error.
44*2175Sjp161948
45*2175Sjp161948=head1 RETURN VALUE
46*2175Sjp161948
47*2175Sjp161948These functions return 1 for success and a zero or negative value for
48*2175Sjp161948failure. If module errors are not ignored the return code will reflect the
49*2175Sjp161948return value of the failing module (this will always be zero or negative).
50*2175Sjp161948
51*2175Sjp161948=head1 SEE ALSO
52*2175Sjp161948
53*2175Sjp161948L<conf(5)|conf(5)>, L<OPENSSL_config(3)|OPENSSL_config(3)>,
54*2175Sjp161948L<CONF_free(3), CONF_free(3)>, L<err(3),err(3)>
55*2175Sjp161948
56*2175Sjp161948=head1 HISTORY
57*2175Sjp161948
58*2175Sjp161948CONF_modules_load_file and CONF_modules_load first appeared in OpenSSL 0.9.7.
59*2175Sjp161948
60*2175Sjp161948=cut
61