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