diff options
Diffstat (limited to 'upstream/debian-unstable/man7/provider-storemgmt.7ssl')
| -rw-r--r-- | upstream/debian-unstable/man7/provider-storemgmt.7ssl | 30 |
1 files changed, 27 insertions, 3 deletions
diff --git a/upstream/debian-unstable/man7/provider-storemgmt.7ssl b/upstream/debian-unstable/man7/provider-storemgmt.7ssl index 9ed00b6e..42fdfe16 100644 --- a/upstream/debian-unstable/man7/provider-storemgmt.7ssl +++ b/upstream/debian-unstable/man7/provider-storemgmt.7ssl @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PROVIDER-STOREMGMT 7SSL" -.TH PROVIDER-STOREMGMT 7SSL 2024-02-03 3.1.5 OpenSSL +.TH PROVIDER-STOREMGMT 7SSL 2024-04-04 3.2.2-dev OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -86,6 +86,14 @@ provider\-storemgmt \- The OSSL_STORE library <\-> 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[], +\& OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg); .Ve .SH DESCRIPTION .IX Header "DESCRIPTION" @@ -123,7 +131,7 @@ For example, the "function" \fBOSSL_FUNC_store_attach()\fR has these: \&\fBOSSL_DISPATCH\fR\|(3) arrays are indexed by numbers that are provided as macros in \fBopenssl\-core_dispatch.h\fR\|(7), as follows: .PP -.Vb 8 +.Vb 10 \& OSSL_FUNC_store_open OSSL_FUNC_STORE_OPEN \& OSSL_FUNC_store_attach OSSL_FUNC_STORE_ATTACH \& OSSL_FUNC_store_settable_ctx_params OSSL_FUNC_STORE_SETTABLE_CTX_PARAMS @@ -132,6 +140,8 @@ in \fBopenssl\-core_dispatch.h\fR\|(7), as follows: \& OSSL_FUNC_store_eof OSSL_FUNC_STORE_EOF \& 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 .Ve .SS Functions .IX Subsection "Functions" @@ -175,6 +185,18 @@ supports the type of the object and provides an import function. \&\fBOSSL_FUNC_store_export_object()\fR should export the object of size \fIobjref_sz\fR referenced by \fIobjref\fR as an \fBOSSL_PARAM\fR\|(3) array and pass that to the \&\fIexport_cb\fR as well as the given \fIexport_cbarg\fR. +.PP +\&\fBOSSL_FUNC_store_delete()\fR deletes the object identified by the \fIuri\fR. The +implementation is entirely responsible for the interpretation of the URI. In +case a passphrase needs to be prompted to remove an object, \fIpw_cb\fR should be +called. +.PP +\&\fBOSSL_FUNC_store_open_ex()\fR is an extended variant of \fBOSSL_FUNC_store_open()\fR. If +the provider does not implement this function the code internally falls back to +use the original \fBOSSL_FUNC_store_open()\fR. +This variant additionally accepts an \fBOSSL_PARAM\fR\|(3) object and a \fIpw_cb\fR +callback that can be used to request a passphrase in cases where the whole +store needs to be unlocked before performing any load operation. .SS "Load Parameters" .IX Subsection "Load Parameters" .IP """expect"" (\fBOSSL_STORE_PARAM_EXPECT\fR) <integer>" 4 @@ -235,9 +257,11 @@ search for a certificate by issuer+serial, both the "issuer" and the .SH HISTORY .IX Header "HISTORY" The STORE interface was introduced in OpenSSL 3.0. +.PP +\&\fBOSSL_FUNC_store_delete()\fR callback was added in OpenSSL 3.2 .SH COPYRIGHT .IX Header "COPYRIGHT" -Copyright 2020\-2022 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2020\-2023 The OpenSSL Project Authors. All Rights Reserved. .PP Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy |