summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/CONF_modules_load_file.3
diff options
context:
space:
mode:
authorschwarze <>2015-11-11 21:15:15 +0000
committerschwarze <>2015-11-11 21:15:15 +0000
commit22f89c8c27130dce389c2cba215b4cdd0deadd22 (patch)
treedf165a08270ef8df757ccda21dbd1c609633bd3f /src/lib/libcrypto/man/CONF_modules_load_file.3
parent0241f6701aac0e95428b9f0899b07ba086aa7e71 (diff)
downloadopenbsd-22f89c8c27130dce389c2cba215b4cdd0deadd22.tar.gz
openbsd-22f89c8c27130dce389c2cba215b4cdd0deadd22.tar.bz2
openbsd-22f89c8c27130dce389c2cba215b4cdd0deadd22.zip
Convert five more manuals from POD to mdoc.
I found drafts of these in my tree, probably originally from Max Fillinger, that just needed minor polishing.
Diffstat (limited to 'src/lib/libcrypto/man/CONF_modules_load_file.3')
-rw-r--r--src/lib/libcrypto/man/CONF_modules_load_file.382
1 files changed, 82 insertions, 0 deletions
diff --git a/src/lib/libcrypto/man/CONF_modules_load_file.3 b/src/lib/libcrypto/man/CONF_modules_load_file.3
new file mode 100644
index 0000000000..b5de94411d
--- /dev/null
+++ b/src/lib/libcrypto/man/CONF_modules_load_file.3
@@ -0,0 +1,82 @@
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.