From a883c02faa2549c98256577fd881af17b95444cf Mon Sep 17 00:00:00 2001 From: Richard Levitte Date: Wed, 10 Jul 2019 23:11:27 +0200 Subject: [PATCH] Add internal function ossl_algorithm_do_all() This function is used to traverse all the implementations provided by one provider, or all implementation for a specific operation across all loaded providers, or both, and execute a given function for each occurence. This will be used by ossl_method_construct(), but also by information processing functions. Reviewed-by: Paul Dale (Merged from https://github.com/openssl/openssl/pull/9356) --- crypto/build.info | 3 +- crypto/core_algorithm.c | 75 +++++++++++++++++++++ doc/internal/man3/ossl_algorithm_do_all.pod | 63 +++++++++++++++++ include/internal/core.h | 7 ++ include/openssl/core_numbers.h | 3 + 5 files changed, 150 insertions(+), 1 deletion(-) create mode 100644 crypto/core_algorithm.c create mode 100644 doc/internal/man3/ossl_algorithm_do_all.pod diff --git a/crypto/build.info b/crypto/build.info index 088ec87310..3f9eb52bb6 100644 --- a/crypto/build.info +++ b/crypto/build.info @@ -59,7 +59,8 @@ IF[{- !$disabled{asm} && $config{processor} ne '386' -}] ENDIF # The Core -$CORE_COMMON=provider_core.c provider_predefined.c core_fetch.c core_namemap.c +$CORE_COMMON=provider_core.c provider_predefined.c \ + core_fetch.c core_algorithm.c core_namemap.c SOURCE[../libcrypto]=$CORE_COMMON provider_conf.c SOURCE[../providers/fips]=$CORE_COMMON diff --git a/crypto/core_algorithm.c b/crypto/core_algorithm.c new file mode 100644 index 0000000000..f88a0458ec --- /dev/null +++ b/crypto/core_algorithm.c @@ -0,0 +1,75 @@ +/* + * Copyright 2019 The OpenSSL Project Authors. All Rights Reserved. + * + * 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 + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include +#include +#include "internal/core.h" +#include "internal/property.h" +#include "internal/provider.h" + +struct algorithm_data_st { + OPENSSL_CTX *libctx; + int operation_id; /* May be zero for finding them all */ + void (*fn)(OSSL_PROVIDER *, const OSSL_ALGORITHM *, int no_store, + void *data); + void *data; +}; + +static int algorithm_do_this(OSSL_PROVIDER *provider, void *cbdata) +{ + struct algorithm_data_st *data = cbdata; + int no_store = 0; /* Assume caching is ok */ + int first_operation = 1; + int last_operation = OSSL_OP__HIGHEST; + int cur_operation; + int ok = 0; + + if (data->operation_id != 0) + first_operation = last_operation = data->operation_id; + + for (cur_operation = first_operation; + cur_operation <= last_operation; + cur_operation++) { + const OSSL_ALGORITHM *map = + ossl_provider_query_operation(provider, data->operation_id, + &no_store); + + if (map == NULL) + break; + + ok = 1; /* As long as we've found *something* */ + while (map->algorithm_name != NULL) { + const OSSL_ALGORITHM *thismap = map++; + + data->fn(provider, thismap, no_store, data->data); + } + } + + return ok; +} + +void ossl_algorithm_do_all(OPENSSL_CTX *libctx, int operation_id, + OSSL_PROVIDER *provider, + void (*fn)(OSSL_PROVIDER *provider, + const OSSL_ALGORITHM *algo, + int no_store, void *data), + void *data) +{ + struct algorithm_data_st cbdata; + + cbdata.libctx = libctx; + cbdata.operation_id = operation_id; + cbdata.fn = fn; + cbdata.data = data; + + if (provider == NULL) + ossl_provider_forall_loaded(libctx, algorithm_do_this, &cbdata); + else + algorithm_do_this(provider, &cbdata); +} diff --git a/doc/internal/man3/ossl_algorithm_do_all.pod b/doc/internal/man3/ossl_algorithm_do_all.pod new file mode 100644 index 0000000000..6ef85a7259 --- /dev/null +++ b/doc/internal/man3/ossl_algorithm_do_all.pod @@ -0,0 +1,63 @@ +=pod + +=head1 NAME + +ossl_algorithm_do_all - generic algorithm implementation iterator + +=head1 SYNOPSIS + + void ossl_algorithm_do_all(OPENSSL_CTX *libctx, int operation_id, + OSSL_PROVIDER *provider, + void (*fn)(OSSL_PROVIDER *provider, + const OSSL_ALGORITHM *algo, + int no_store, void *data), + void *data) + +=head1 DESCRIPTION + +ossl_algorithm_do_all() looks up every algorithm it can find, given a +library context I, an operation identity I and a +provider I. +I may be NULL to signify that the default library context should +be used. +I may be zero to signify that all kinds of operations +will be looked up. +I may be NULL to signify that all loaded providers will be +queried. + +For each implementation found, the function I is called with the +I for the implementation, the algorithm descriptor I, +the flag I indicating whether the algorithm descriptor may +be remembered or not, and the caller I that was passed to +ossl_algorithm_do_all(). + +=head1 RETURN VALUES + +ossl_algorithm_do_all() doesn't return any value. + +=head1 NOTES + +The function described here are mainly useful for discovery, and +possibly display of what has been discovered, for example an +application that wants to display the loaded providers and what they +may offer, but also for constructors, such as +L. + +=head1 SEE ALSO + +L, L + +=head1 HISTORY + +This functionality was added to OpenSSL 3.0. + +=head1 COPYRIGHT + +Copyright 2019 The OpenSSL Project Authors. All Rights Reserved. + +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 in the file +LICENSE in the source distribution or at +L. + +=cut diff --git a/include/internal/core.h b/include/internal/core.h index 3f0cdfaeff..bd2f9a0989 100644 --- a/include/internal/core.h +++ b/include/internal/core.h @@ -51,4 +51,11 @@ void *ossl_method_construct(OPENSSL_CTX *ctx, int operation_id, int force_cache, OSSL_METHOD_CONSTRUCT_METHOD *mcm, void *mcm_data); +void ossl_algorithm_do_all(OPENSSL_CTX *libctx, int operation_id, + OSSL_PROVIDER *provider, + void (*fn)(OSSL_PROVIDER *provider, + const OSSL_ALGORITHM *algo, + int no_store, void *data), + void *data); + #endif diff --git a/include/openssl/core_numbers.h b/include/openssl/core_numbers.h index f45b8f1084..905094d09a 100644 --- a/include/openssl/core_numbers.h +++ b/include/openssl/core_numbers.h @@ -324,6 +324,9 @@ OSSL_CORE_MAKE_FUNC(void *, OP_keyexch_dupctx, (void *ctx)) OSSL_CORE_MAKE_FUNC(int, OP_keyexch_set_params, (void *ctx, OSSL_PARAM params[])) +/* Highest known operation number */ +# define OSSL_OP__HIGHEST 3 + # ifdef __cplusplus } # endif -- 2.39.2