diff options
author | Matt Caswell <matt@openssl.org> | 2021-06-21 17:09:32 +0100 |
---|---|---|
committer | Matt Caswell <matt@openssl.org> | 2021-06-24 14:48:15 +0100 |
commit | 29d46e09ce0e66b5dc8faecfa48d5f667217302e (patch) | |
tree | 7cd66055a32e613c6e62253622cfd2ab32e2d0ee /doc/internal | |
parent | b7248964a40d272bb2edc7d2f94b9ce35c804cff (diff) |
Update documentation following updates to the provider code
Reviewed-by: Paul Dale <pauli@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15854)
Diffstat (limited to 'doc/internal')
-rw-r--r-- | doc/internal/man3/ossl_provider_new.pod | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/doc/internal/man3/ossl_provider_new.pod b/doc/internal/man3/ossl_provider_new.pod index 0a76135281..928cc9b844 100644 --- a/doc/internal/man3/ossl_provider_new.pod +++ b/doc/internal/man3/ossl_provider_new.pod @@ -9,7 +9,7 @@ ossl_provider_add_parameter, ossl_provider_set_child, ossl_provider_get_parent, ossl_provider_up_ref_parent, ossl_provider_free_parent, ossl_provider_default_props_update, ossl_provider_get0_dispatch, ossl_provider_init_as_child, -ossl_provider_activate, ossl_provider_deactivate, +ossl_provider_activate, ossl_provider_deactivate, ossl_provider_add_to_store, ossl_provider_ctx, ossl_provider_doall_activated, ossl_provider_name, ossl_provider_dso, @@ -53,8 +53,9 @@ 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 upcalls); + int ossl_provider_activate(OSSL_PROVIDER *prov, int upcalls, int aschild); int ossl_provider_deactivate(OSSL_PROVIDER *prov); + int ossl_provider_add_to_store(OSSL_PROVIDER *prov, int retain_fallbacks); /* Return pointer to the provider's context */ void *ossl_provider_ctx(const OSSL_PROVIDER *prov); @@ -218,12 +219,18 @@ be located in that module, and called. =back If I<upcalls> is nonzero then, if this is a child provider, upcalls to the -parent libctx will be made to inform it of an up-ref. +parent libctx will be made to inform it of an up-ref. If I<aschild> is nonzero +then the provider will only be activated if it is a child provider. Otherwise +no action is taken and ossl_provider_activate() returns success. 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. +ossl_provider_add_to_store() adds the provider I<prov> to the provider store and +makes it available to other threads. This will prevent future automatic loading +of fallback providers, unless I<retain_fallbacks> is true. + ossl_provider_ctx() returns a context created by the provider. Outside of the provider, it's completely opaque, but it needs to be passed back to some of the provider functions. @@ -336,8 +343,8 @@ called for any activated providers. ossl_provider_set_module_path(), ossl_provider_set_fallback(), ossl_provider_activate(), ossl_provider_activate_leave_fallbacks() and -ossl_provider_deactivate(), ossl_provider_default_props_update() return 1 on -success, or 0 on error. +ossl_provider_deactivate(), ossl_provider_add_to_store(), +ossl_provider_default_props_update() return 1 on success, or 0 on error. ossl_provider_name(), ossl_provider_dso(), ossl_provider_module_name(), and ossl_provider_module_path() return a |