1.Dd $Mdocdate: November 11 2015 $ 2.Dt CONF_MODULES_LOAD_FILE 3 3.Os 4.Sh NAME 5.Nm CONF_modules_load_file , 6.Nm CONF_modules_load 7.Nd OpenSSL configuration functions 8.Sh SYNOPSIS 9.In openssl/conf.h 10.Ft int 11.Fo CONF_modules_load_file 12.Fa "const char *filename" 13.Fa "const char *appname" 14.Fa "unsigned long flags" 15.Fc 16.Ft int 17.Fo CONF_modules_load 18.Fa "const CONF *cnf" 19.Fa "const char *appname" 20.Fa "unsigned long flags" 21.Fc 22.Sh DESCRIPTION 23The function 24.Fn CONF_modules_load_file 25configures OpenSSL using file 26.Fa filename 27and application name 28.Fa appname . 29If 30.Fa filename 31is 32.Dv NULL , 33the standard OpenSSL configuration file is used. 34If 35.Fa appname 36is 37.Dv NULL , 38the standard OpenSSL application name 39.Qq openssl_conf 40is used. 41The behaviour can be cutomized using 42.Fa flags . 43.Pp 44.Fn CONF_modules_load 45is idential to 46.Fn CONF_modules_load_file 47except it reads configuration information from 48.Fa cnf . 49.Pp 50The following 51.Fa flags 52are currently recognized: 53.Bl -tag -width Ds 54.It Dv CONF_MFLAGS_IGNORE_ERRORS 55Ignore errors returned by individual configuration modules. 56By default, the first module error is considered fatal and no further 57modules are loaded. 58.It Dv CONF_MFLAGS_SILENT 59Do not add any error information. 60By default, all module errors add error information to the error queue. 61.It Dv CONF_MFLAGS_NO_DSO 62Disable loading of configuration modules from DSOs. 63.It Dv CONF_MFLAGS_IGNORE_MISSING_FILE 64Let 65.Fn CONF_modules_load_file 66ignore missing configuration files. 67By default, a missing configuration file returns an error. 68.El 69.Sh RETURN VALUES 70These functions return 1 for success and zero or a negative value for 71failure. 72If module errors are not ignored, the return code will reflect the return 73value of the failing module (this will always be zero or negative). 74.Sh SEE ALSO 75.Xr CONF_free 3 , 76.Xr ERR 3 , 77.Xr OPENSSL_config 3 78.Sh HISTORY 79.Fn CONF_modules_load_file 80and 81.Fn CONF_modules_load 82first appeared in OpenSSL 0.9.7. 83