diff options
author | Simo Sorce <simo@redhat.com> | 2023-09-14 16:55:32 -0400 |
---|---|---|
committer | Dmitry Belyavskiy <beldmit@gmail.com> | 2023-09-19 12:24:07 +0200 |
commit | e40d538ad72c8e496b1dfe7d93c6002ce48351f5 (patch) | |
tree | cb9cfc60f5ba64508c3c9d5a06ccaa66190d32e0 /doc | |
parent | 64129008fb822758778f7dd29cec6a0a4582e4d2 (diff) |
Add provider documentation for the new open_ex
Signed-off-by: Simo Sorce <simo@redhat.com>
Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/20131)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man7/provider-storemgmt.pod | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/man7/provider-storemgmt.pod b/doc/man7/provider-storemgmt.pod index c58df619db..a8ce43c4bb 100644 --- a/doc/man7/provider-storemgmt.pod +++ b/doc/man7/provider-storemgmt.pod @@ -27,6 +27,10 @@ provider-storemgmt - The OSSL_STORE library E<lt>-E<gt> provider functions int OSSL_FUNC_store_export_object (void *loaderctx, const void *objref, size_t objref_sz, OSSL_CALLBACK *export_cb, void *export_cbarg); + void *OSSL_FUNC_store_open_ex(void *provctx, const char *uri, + const OSSL_PARAM params[], + OSSL_PASSPHRASE_CALLBACK *pw_cb, + void *pw_cbarg); int OSSL_FUNC_store_delete(void *provctx, const char *uri, const OSSL_PARAM params[], @@ -75,6 +79,7 @@ in L<openssl-core_dispatch.h(7)>, as follows: OSSL_FUNC_store_close OSSL_FUNC_STORE_CLOSE OSSL_FUNC_store_export_object OSSL_FUNC_STORE_EXPORT_OBJECT OSSL_FUNC_store_delete OSSL_FUNC_STORE_DELETE + OSSL_FUNC_store_open_ex OSSL_FUNC_STORE_OPEN_EX =head2 Functions @@ -124,6 +129,13 @@ implementation is entirely responsible for the interpretation of the URI. In case a passphrase needs to be prompted to remove an object, I<pw_cb> should be called. +OSSL_FUNC_store_open_ex() is an extended variant of OSSL_FUNC_store_open(). If +the provider does not implement this function the code internally falls back to +use the original OSSL_FUNC_store_open(). +This variant additionally accepts an L<OSSL_PARAM(3)> object and a I<pw_cb> +callback that can be used to request a passphrase in cases where the whole +store needs to be unlocked before performing any load operation. + =head2 Load Parameters =over 4 |