summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2021-09-30 09:44:10 +0200
committerRichard Levitte <levitte@openssl.org>2021-10-27 12:46:15 +0200
commit6853bfc9ccd9583c47b3fb17f40b39ff11c19524 (patch)
treee4a92d16ec4f2597af65743b2d3189baeb9dbedd /doc
parent203ef4d7bfa65813dfa6fd49fb84c787e22b8c0c (diff)
EVP: Add the internal function evp_generic_fetch_from_prov()
This function leverages the generic possibility to fetch EVP methods from a specific provider. Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/16725) (cherry picked from commit 2fd3392c8f4e2f3481fa4d7e6a683dc19c6c1cd2)
Diffstat (limited to 'doc')
-rw-r--r--doc/internal/man3/evp_generic_fetch.pod18
1 files changed, 16 insertions, 2 deletions
diff --git a/doc/internal/man3/evp_generic_fetch.pod b/doc/internal/man3/evp_generic_fetch.pod
index bc9a3a0770..b23d2ec0ea 100644
--- a/doc/internal/man3/evp_generic_fetch.pod
+++ b/doc/internal/man3/evp_generic_fetch.pod
@@ -2,7 +2,7 @@
=head1 NAME
-evp_generic_fetch, evp_generic_fetch_by_number
+evp_generic_fetch, evp_generic_fetch_by_number, evp_generic_fetch_from_prov
- generic algorithm fetchers and method creators for EVP
=head1 SYNOPSIS
@@ -29,6 +29,15 @@ evp_generic_fetch, evp_generic_fetch_by_number
void *method_data,
int (*up_ref_method)(void *),
void (*free_method)(void *));
+ void *evp_generic_fetch_from_prov(OSSL_PROVIDER *prov, int operation_id,
+ int name_id, const char *properties,
+ void *(*new_method)(int name_id,
+ const OSSL_DISPATCH *fns,
+ OSSL_PROVIDER *prov,
+ void *method_data),
+ void *method_data,
+ int (*up_ref_method)(void *),
+ void (*free_method)(void *));
=head1 DESCRIPTION
@@ -42,9 +51,14 @@ but takes a numeric I<name_id> instead of a name.
I<name_id> must always be nonzero; as a matter of fact, it being zero
is considered a programming error.
This is meant to be used when one method needs to fetch an associated
-other method, and is typically called from inside the given function
+method, and is typically called from inside the given function
I<new_method>.
+evp_generic_fetch_from_prov() does the same thing as evp_generic_fetch(),
+but limits the search of methods to the provider given with I<prov>.
+This is meant to be used when one method needs to fetch an associated
+method in the same provider.
+
The three functions I<new_method>, I<up_ref_method>, and
I<free_method> are supposed to: