diff options
author | Michael Baentsch <info@baentsch.ch> | 2021-01-13 11:06:13 +0100 |
---|---|---|
committer | Matt Caswell <matt@openssl.org> | 2021-01-14 17:33:47 +0000 |
commit | 3bc061eb0a990a95d35c462b9206bdf74905cfa2 (patch) | |
tree | e5a8ac7d81994ec627be81768639dae24546d675 /doc/man7/OSSL_PROVIDER-default.pod | |
parent | b11ba50fd9bd3c33e1627ca5c64f08b403e88173 (diff) |
Enhance default provider documentation
Bring Wiki and man page documentation in line regarding default provider
fall-back behaviour.
Fixes #13844
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/13859)
Diffstat (limited to 'doc/man7/OSSL_PROVIDER-default.pod')
-rw-r--r-- | doc/man7/OSSL_PROVIDER-default.pod | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/doc/man7/OSSL_PROVIDER-default.pod b/doc/man7/OSSL_PROVIDER-default.pod index 96144e2260..472bff65fd 100644 --- a/doc/man7/OSSL_PROVIDER-default.pod +++ b/doc/man7/OSSL_PROVIDER-default.pod @@ -7,8 +7,19 @@ OSSL_PROVIDER-default - OpenSSL default provider =head1 DESCRIPTION The OpenSSL default provider supplies the majority of OpenSSL's diverse -algorithm implementations. It also acts as a fallback when no other -provider has been loaded. +algorithm implementations. If an application doesn't specify anything else +explicitly (e.g. in the application or via config), then this is the +provider that will be used as fallback: It is loaded automatically the +first time that an algorithm is fetched from a provider or a function +acting on providers is called and no other provider has been loaded yet. + +If an attempt to load a provider has already been made (whether successful +or not) then the default provider won't be loaded automatically. Therefore +if the default provider is to be used in conjunction with other providers +then it must be loaded explicitly. Automatic loading of the default +provider only occurs a maximum of once; if the default provider is +explicitly unloaded then the default provider will not be automatically +loaded again. =head2 Properties |