summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/lib/libcrypto/man/openssl.cnf.5108
1 files changed, 2 insertions, 106 deletions
diff --git a/src/lib/libcrypto/man/openssl.cnf.5 b/src/lib/libcrypto/man/openssl.cnf.5
index eda4829ab6..05295cbbaf 100644
--- a/src/lib/libcrypto/man/openssl.cnf.5
+++ b/src/lib/libcrypto/man/openssl.cnf.5
@@ -1,4 +1,4 @@
1.\" $OpenBSD: openssl.cnf.5,v 1.9 2023/10/21 14:05:49 tb Exp $ 1.\" $OpenBSD: openssl.cnf.5,v 1.10 2023/11/19 10:23:53 tb Exp $
2.\" full merge up to: OpenSSL man5/config b53338cb Feb 28 12:30:28 2017 +0100 2.\" full merge up to: OpenSSL man5/config b53338cb Feb 28 12:30:28 2017 +0100
3.\" selective merge up to: OpenSSL a8c5ed81 Jul 18 13:57:25 2017 -0400 3.\" selective merge up to: OpenSSL a8c5ed81 Jul 18 13:57:25 2017 -0400
4.\" 4.\"
@@ -50,7 +50,7 @@
50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
51.\" OF THE POSSIBILITY OF SUCH DAMAGE. 51.\" OF THE POSSIBILITY OF SUCH DAMAGE.
52.\" 52.\"
53.Dd $Mdocdate: October 21 2023 $ 53.Dd $Mdocdate: November 19 2023 $
54.Dt OPENSSL.CNF 5 54.Dt OPENSSL.CNF 5
55.Os 55.Os
56.Sh NAME 56.Sh NAME
@@ -192,13 +192,9 @@ openssl_conf = openssl_init
192 192
193[openssl_init] 193[openssl_init]
194oid_section = new_oids 194oid_section = new_oids
195engines = engine_section
196 195
197[new_oids] 196[new_oids]
198\&... new oids here ... 197\&... new oids here ...
199
200[engine_section]
201\&... engine stuff here ...
202.Ed 198.Ed
203.Pp 199.Pp
204The features of each configuration module are described below. 200The features of each configuration module are described below.
@@ -228,106 +224,6 @@ comma and the numerical OID form.
228For example: 224For example:
229.Pp 225.Pp
230.Dl shortName = some object long name, 1.2.3.4 226.Dl shortName = some object long name, 1.2.3.4
231.Ss Engine Configuration Module
232This ENGINE configuration module has the name
233.Ic engines .
234The value of this variable points to a section containing further ENGINE
235configuration information.
236.Pp
237The section pointed to by
238.Ic engines
239is a table of engine names (though see
240.Ic engine_id
241below) and further sections containing configuration information
242specific to each ENGINE.
243.Pp
244Each ENGINE specific section is used to set default algorithms, load
245dynamic ENGINEs, perform initialization and send ctrls.
246The actual operation performed depends on the command
247name which is the name of the name value pair.
248The currently supported commands are listed below.
249.Pp
250For example:
251.Bd -literal -offset indent
252[engine_section]
253# Configure ENGINE named "foo"
254foo = foo_section
255# Configure ENGINE named "bar"
256bar = bar_section
257
258[foo_section]
259\&... foo ENGINE specific commands ...
260
261[bar_section]
262\&... "bar" ENGINE specific commands ...
263.Ed
264.Pp
265The command
266.Ic engine_id
267is used to give the ENGINE name.
268If used, this command must be first.
269For example:
270.Bd -literal -offset indent
271[engine_section]
272# This would normally handle an ENGINE named "foo"
273foo = foo_section
274
275[foo_section]
276# Override default name and use "myfoo" instead.
277engine_id = myfoo
278.Ed
279.Pp
280The command
281.Ic dynamic_path
282loads and adds an ENGINE from the given path.
283It is equivalent to sending the ctrls
284.Sy SO_PATH
285with the path argument followed by
286.Sy LIST_ADD
287with value 2 and
288.Sy LOAD
289to the dynamic ENGINE.
290If this is not the required behaviour then alternative ctrls can be sent
291directly to the dynamic ENGINE using ctrl commands.
292.Pp
293The command
294.Ic init
295determines whether to initialize the ENGINE.
296If the value is 0, the ENGINE will not be initialized.
297If it is 1, an attempt is made to initialized the ENGINE immediately.
298If the
299.Ic init
300command is not present, then an attempt will be made to initialize
301the ENGINE after all commands in its section have been processed.
302.Pp
303The command
304.Ic default_algorithms
305sets the default algorithms an ENGINE will supply using the functions
306.Xr ENGINE_set_default_string 3 .
307.Pp
308If the name matches none of the above command names, it is assumed
309to be a ctrl command which is sent to the ENGINE.
310The value of the command is the argument to the ctrl command.
311If the value is the string
312.Cm EMPTY ,
313then no value is sent to the command.
314.Pp
315For example:
316.Bd -literal -offset indent
317[engine_section]
318# Configure ENGINE named "foo"
319foo = foo_section
320
321[foo_section]
322# Load engine from DSO
323dynamic_path = /some/path/fooengine.so
324# A foo specific ctrl.
325some_ctrl = some_value
326# Another ctrl that doesn't take a value.
327other_ctrl = EMPTY
328# Supply all default algorithms
329default_algorithms = ALL
330.Ed
331.Sh FILES 227.Sh FILES
332.Bl -tag -width /etc/ssl/openssl.cnf -compact 228.Bl -tag -width /etc/ssl/openssl.cnf -compact
333.It Pa /etc/ssl/openssl.cnf 229.It Pa /etc/ssl/openssl.cnf