diff options
author | Neil Horman <nhorman@openssl.org> | 2023-12-01 14:02:09 -0500 |
---|---|---|
committer | Neil Horman <nhorman@openssl.org> | 2023-12-21 09:22:40 -0500 |
commit | 506ff20662a228b17840f0b49865a927a45c2908 (patch) | |
tree | fa99ab163899cb138800889aea431aa364c588ee /doc | |
parent | 5528bfbc647c68b6e03262099830ddd1c49dfa23 (diff) | |
download | openssl-506ff20662a228b17840f0b49865a927a45c2908.tar.gz |
Make the activate setting more intuitive
Currently, a provider is activated from our config file using the
activate parameter. However, the presence of the config parameter is
sufficient to trigger activation, leading to a counterintuitive
situation in which setting "activate = 0" still activates the provider
Make activation more intuitive by requiring that activate be set to one
of yes|true|1 to trigger activation. Any other value, as well as
omitting the parameter entirely, prevents activation (and also maintains
backward compatibility.
It seems a bit heavyweight to create a test specifically to validate the
plurality of these settings. Instead, modify the exiting openssl config
files in the test directory to use variants of these settings, and
augment the default.cnf file to include a provider section that is
explicitly disabled
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/22906)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man5/config.pod | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/man5/config.pod b/doc/man5/config.pod index 8d312c661f..96eaa6ffd3 100644 --- a/doc/man5/config.pod +++ b/doc/man5/config.pod @@ -265,8 +265,11 @@ Specifies the pathname of the module (typically a shared library) to load. =item B<activate> -If present, the module is activated. The value assigned to this name is not -significant. +If present and set to one of the values yes, on, true or 1, then the associated +provider will be activated. Conversely, setting this value to no, off, false, or +0 will prevent the provider from being activated. Settings can be given in lower +or uppercase. Setting activate to any other setting, or omitting a setting +value will result in an error. =back |