diff options
author | Pauli <ppzgs1@gmail.com> | 2021-02-18 09:16:26 +1000 |
---|---|---|
committer | Pauli <ppzgs1@gmail.com> | 2021-02-23 23:24:41 +1000 |
commit | 299f5ff3b5f2a5a9b5666e36a6a01fc430de9198 (patch) | |
tree | a522f985b02749c53b628f193c767de3c9fb93f6 /doc/internal | |
parent | 332a245c04dff95f81cfa1f77e0f8a935794f5ee (diff) |
provider: add option to load a provider without disabling the fallbacks.
Add an argument to PROVIDER_try_load() that permits a provider to be
loaded without changing the fallback status. This is useful when an
additional provider needs to be loaded without perturbing any other setup.
E.g. adding mock providers as part of unit testing.
Reviewed-by: Tim Hudson <tjh@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/13652)
Diffstat (limited to 'doc/internal')
-rw-r--r-- | doc/internal/man3/ossl_provider_new.pod | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/internal/man3/ossl_provider_new.pod b/doc/internal/man3/ossl_provider_new.pod index d01673e767..d74ce57fef 100644 --- a/doc/internal/man3/ossl_provider_new.pod +++ b/doc/internal/man3/ossl_provider_new.pod @@ -40,7 +40,7 @@ ossl_provider_get_capabilities * Activate the Provider * If the Provider is a module, the module will be loaded */ - int ossl_provider_activate(OSSL_PROVIDER *prov); + int ossl_provider_activate(OSSL_PROVIDER *prov, int retain_fallbacks); int ossl_provider_deactivate(OSSL_PROVIDER *prov); /* Check if provider is available (activated) */ int ossl_provider_available(OSSL_PROVIDER *prov); @@ -178,6 +178,9 @@ be located in that module, and called. =back +If I<retain_fallbacks> is zero, fallbacks are disabled. If it is nonzero, +fallbacks are left unchanged. + ossl_provider_deactivate() "deactivates" the provider for the given provider object I<prov> by decrementing its activation count. When that count reaches zero, the activation flag is cleared. @@ -277,8 +280,8 @@ it has been incremented. ossl_provider_free() doesn't return any value. ossl_provider_set_module_path(), ossl_provider_set_fallback(), -ossl_provider_activate() and ossl_provider_deactivate() return 1 on -success, or 0 on error. +ossl_provider_activate(), ossl_provider_activate_leave_fallbacks() and +ossl_provider_deactivate() return 1 on success, or 0 on error. ossl_provider_available() return 1 if the provider is available, otherwise 0. |