2 * Copyright 2019-2024 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
11 #include <openssl/core.h>
12 #include <openssl/core_dispatch.h>
13 #include <openssl/core_names.h>
14 #include <openssl/provider.h>
15 #include <openssl/params.h>
16 #include <openssl/opensslv.h>
17 #include "crypto/cryptlib.h"
19 #include "crypto/decoder.h" /* ossl_decoder_store_cache_flush */
20 #include "crypto/encoder.h" /* ossl_encoder_store_cache_flush */
21 #include "crypto/store.h" /* ossl_store_loader_store_cache_flush */
23 #include "crypto/evp.h" /* evp_method_store_cache_flush */
24 #include "crypto/rand.h"
25 #include "internal/nelem.h"
26 #include "internal/thread_once.h"
27 #include "internal/provider.h"
28 #include "internal/refcount.h"
29 #include "internal/bio.h"
30 #include "internal/core.h"
31 #include "provider_local.h"
32 #include "crypto/context.h"
34 # include <openssl/self_test.h>
38 * This file defines and uses a number of different structures:
40 * OSSL_PROVIDER (provider_st): Used to represent all information related to a
41 * single instance of a provider.
43 * provider_store_st: Holds information about the collection of providers that
44 * are available within the current library context (OSSL_LIB_CTX). It also
45 * holds configuration information about providers that could be loaded at some
48 * OSSL_PROVIDER_CHILD_CB: An instance of this structure holds the callbacks
49 * that have been registered for a child library context and the associated
50 * provider that registered those callbacks.
52 * Where a child library context exists then it has its own instance of the
53 * provider store. Each provider that exists in the parent provider store, has
54 * an associated child provider in the child library context's provider store.
55 * As providers get activated or deactivated this needs to be mirrored in the
56 * associated child providers.
61 * There are a number of different locks used in this file and it is important
62 * to understand how they should be used in order to avoid deadlocks.
64 * Fields within a structure can often be "write once" on creation, and then
65 * "read many". Creation of a structure is done by a single thread, and
66 * therefore no lock is required for the "write once/read many" fields. It is
67 * safe for multiple threads to read these fields without a lock, because they
68 * will never be changed.
70 * However some fields may be changed after a structure has been created and
71 * shared between multiple threads. Where this is the case a lock is required.
73 * The locks available are:
75 * The provider flag_lock: Used to control updates to the various provider
76 * "flags" (flag_initialized and flag_activated).
78 * The provider activatecnt_lock: Used to control updates to the provider
81 * The provider optbits_lock: Used to control access to the provider's
82 * operation_bits and operation_bits_sz fields.
84 * The store default_path_lock: Used to control access to the provider store's
85 * default search path value (default_path)
87 * The store lock: Used to control the stack of provider's held within the
88 * provider store, as well as the stack of registered child provider callbacks.
90 * As a general rule-of-thumb it is best to:
91 * - keep the scope of the code that is protected by a lock to the absolute
93 * - try to keep the scope of the lock to within a single function (i.e. avoid
94 * making calls to other functions while holding a lock);
95 * - try to only ever hold one lock at a time.
97 * Unfortunately, it is not always possible to stick to the above guidelines.
98 * Where they are not adhered to there is always a danger of inadvertently
99 * introducing the possibility of deadlock. The following rules MUST be adhered
100 * to in order to avoid that:
101 * - Holding multiple locks at the same time is only allowed for the
102 * provider store lock, the provider activatecnt_lock and the provider flag_lock.
103 * - When holding multiple locks they must be acquired in the following order of
105 * 1) provider store lock
106 * 2) provider flag_lock
107 * 3) provider activatecnt_lock
108 * - When releasing locks they must be released in the reverse order to which
110 * - No locks may be held when making an upcall. NOTE: Some common functions
111 * can make upcalls as part of their normal operation. If you need to call
112 * some other function while holding a lock make sure you know whether it
113 * will make any upcalls or not. For example ossl_provider_up_ref() can call
114 * ossl_provider_up_ref_parent() which can call the c_prov_up_ref() upcall.
115 * - It is permissible to hold the store and flag locks when calling child
116 * provider callbacks. No other locks may be held during such callbacks.
119 static OSSL_PROVIDER *provider_new(const char *name,
120 OSSL_provider_init_fn *init_function,
121 STACK_OF(INFOPAIR) *parameters);
124 * Provider Object structure
125 * =========================
131 int (*create_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata);
132 int (*remove_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata);
133 int (*global_props_cb)(const char *props, void *cbdata);
135 } OSSL_PROVIDER_CHILD_CB;
136 DEFINE_STACK_OF(OSSL_PROVIDER_CHILD_CB)
139 struct provider_store_st; /* Forward declaration */
141 struct ossl_provider_st {
143 unsigned int flag_initialized:1;
144 unsigned int flag_activated:1;
146 /* Getting and setting the flags require synchronization */
147 CRYPTO_RWLOCK *flag_lock;
149 /* OpenSSL library side data */
150 CRYPTO_REF_COUNT refcnt;
151 CRYPTO_RWLOCK *activatecnt_lock; /* For the activatecnt counter */
156 OSSL_provider_init_fn *init_function;
157 STACK_OF(INFOPAIR) *parameters;
158 OSSL_LIB_CTX *libctx; /* The library context this instance is in */
159 struct provider_store_st *store; /* The store this instance belongs to */
162 * In the FIPS module inner provider, this isn't needed, since the
163 * error upcalls are always direct calls to the outer provider.
165 int error_lib; /* ERR library number, one for each provider */
166 # ifndef OPENSSL_NO_ERR
167 ERR_STRING_DATA *error_strings; /* Copy of what the provider gives us */
171 /* Provider side functions */
172 OSSL_FUNC_provider_teardown_fn *teardown;
173 OSSL_FUNC_provider_gettable_params_fn *gettable_params;
174 OSSL_FUNC_provider_get_params_fn *get_params;
175 OSSL_FUNC_provider_get_capabilities_fn *get_capabilities;
176 OSSL_FUNC_provider_self_test_fn *self_test;
177 OSSL_FUNC_provider_query_operation_fn *query_operation;
178 OSSL_FUNC_provider_unquery_operation_fn *unquery_operation;
181 * Cache of bit to indicate of query_operation() has been called on
182 * a specific operation or not.
184 unsigned char *operation_bits;
185 size_t operation_bits_sz;
186 CRYPTO_RWLOCK *opbits_lock;
189 /* Whether this provider is the child of some other provider */
190 const OSSL_CORE_HANDLE *handle;
191 unsigned int ischild:1;
194 /* Provider side data */
196 const OSSL_DISPATCH *dispatch;
198 DEFINE_STACK_OF(OSSL_PROVIDER)
200 static int ossl_provider_cmp(const OSSL_PROVIDER * const *a,
201 const OSSL_PROVIDER * const *b)
203 return strcmp((*a)->name, (*b)->name);
207 * Provider Object store
208 * =====================
210 * The Provider Object store is a library context object, and therefore needs
214 struct provider_store_st {
215 OSSL_LIB_CTX *libctx;
216 STACK_OF(OSSL_PROVIDER) *providers;
217 STACK_OF(OSSL_PROVIDER_CHILD_CB) *child_cbs;
218 CRYPTO_RWLOCK *default_path_lock;
221 OSSL_PROVIDER_INFO *provinfo;
224 unsigned int use_fallbacks:1;
225 unsigned int freeing:1;
229 * provider_deactivate_free() is a wrapper around ossl_provider_deactivate()
230 * and ossl_provider_free(), called as needed.
231 * Since this is only called when the provider store is being emptied, we
232 * don't need to care about any lock.
234 static void provider_deactivate_free(OSSL_PROVIDER *prov)
236 if (prov->flag_activated)
237 ossl_provider_deactivate(prov, 1);
238 ossl_provider_free(prov);
242 static void ossl_provider_child_cb_free(OSSL_PROVIDER_CHILD_CB *cb)
248 static void infopair_free(INFOPAIR *pair)
250 OPENSSL_free(pair->name);
251 OPENSSL_free(pair->value);
255 static INFOPAIR *infopair_copy(const INFOPAIR *src)
257 INFOPAIR *dest = OPENSSL_zalloc(sizeof(*dest));
261 if (src->name != NULL) {
262 dest->name = OPENSSL_strdup(src->name);
263 if (dest->name == NULL)
266 if (src->value != NULL) {
267 dest->value = OPENSSL_strdup(src->value);
268 if (dest->value == NULL)
273 OPENSSL_free(dest->name);
278 void ossl_provider_info_clear(OSSL_PROVIDER_INFO *info)
280 OPENSSL_free(info->name);
281 OPENSSL_free(info->path);
282 sk_INFOPAIR_pop_free(info->parameters, infopair_free);
285 void ossl_provider_store_free(void *vstore)
287 struct provider_store_st *store = vstore;
293 OPENSSL_free(store->default_path);
294 sk_OSSL_PROVIDER_pop_free(store->providers, provider_deactivate_free);
296 sk_OSSL_PROVIDER_CHILD_CB_pop_free(store->child_cbs,
297 ossl_provider_child_cb_free);
299 CRYPTO_THREAD_lock_free(store->default_path_lock);
300 CRYPTO_THREAD_lock_free(store->lock);
301 for (i = 0; i < store->numprovinfo; i++)
302 ossl_provider_info_clear(&store->provinfo[i]);
303 OPENSSL_free(store->provinfo);
307 void *ossl_provider_store_new(OSSL_LIB_CTX *ctx)
309 struct provider_store_st *store = OPENSSL_zalloc(sizeof(*store));
312 || (store->providers = sk_OSSL_PROVIDER_new(ossl_provider_cmp)) == NULL
313 || (store->default_path_lock = CRYPTO_THREAD_lock_new()) == NULL
315 || (store->child_cbs = sk_OSSL_PROVIDER_CHILD_CB_new_null()) == NULL
317 || (store->lock = CRYPTO_THREAD_lock_new()) == NULL) {
318 ossl_provider_store_free(store);
322 store->use_fallbacks = 1;
327 static struct provider_store_st *get_provider_store(OSSL_LIB_CTX *libctx)
329 struct provider_store_st *store = NULL;
331 store = ossl_lib_ctx_get_data(libctx, OSSL_LIB_CTX_PROVIDER_STORE_INDEX);
333 ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
337 int ossl_provider_disable_fallback_loading(OSSL_LIB_CTX *libctx)
339 struct provider_store_st *store;
341 if ((store = get_provider_store(libctx)) != NULL) {
342 if (!CRYPTO_THREAD_write_lock(store->lock))
344 store->use_fallbacks = 0;
345 CRYPTO_THREAD_unlock(store->lock);
351 #define BUILTINS_BLOCK_SIZE 10
353 int ossl_provider_info_add_to_store(OSSL_LIB_CTX *libctx,
354 OSSL_PROVIDER_INFO *entry)
356 struct provider_store_st *store = get_provider_store(libctx);
359 if (entry->name == NULL) {
360 ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
365 ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
369 if (!CRYPTO_THREAD_write_lock(store->lock))
371 if (store->provinfosz == 0) {
372 store->provinfo = OPENSSL_zalloc(sizeof(*store->provinfo)
373 * BUILTINS_BLOCK_SIZE);
374 if (store->provinfo == NULL)
376 store->provinfosz = BUILTINS_BLOCK_SIZE;
377 } else if (store->numprovinfo == store->provinfosz) {
378 OSSL_PROVIDER_INFO *tmpbuiltins;
379 size_t newsz = store->provinfosz + BUILTINS_BLOCK_SIZE;
381 tmpbuiltins = OPENSSL_realloc(store->provinfo,
382 sizeof(*store->provinfo) * newsz);
383 if (tmpbuiltins == NULL)
385 store->provinfo = tmpbuiltins;
386 store->provinfosz = newsz;
388 store->provinfo[store->numprovinfo] = *entry;
389 store->numprovinfo++;
393 CRYPTO_THREAD_unlock(store->lock);
397 OSSL_PROVIDER *ossl_provider_find(OSSL_LIB_CTX *libctx, const char *name,
398 ossl_unused int noconfig)
400 struct provider_store_st *store = NULL;
401 OSSL_PROVIDER *prov = NULL;
403 if ((store = get_provider_store(libctx)) != NULL) {
404 OSSL_PROVIDER tmpl = { 0, };
407 #if !defined(FIPS_MODULE) && !defined(OPENSSL_NO_AUTOLOAD_CONFIG)
409 * Make sure any providers are loaded from config before we try to find
413 if (ossl_lib_ctx_is_default(libctx))
414 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL);
418 tmpl.name = (char *)name;
419 if (!CRYPTO_THREAD_write_lock(store->lock))
421 sk_OSSL_PROVIDER_sort(store->providers);
422 if ((i = sk_OSSL_PROVIDER_find(store->providers, &tmpl)) != -1)
423 prov = sk_OSSL_PROVIDER_value(store->providers, i);
424 CRYPTO_THREAD_unlock(store->lock);
425 if (prov != NULL && !ossl_provider_up_ref(prov))
433 * Provider Object methods
434 * =======================
437 static OSSL_PROVIDER *provider_new(const char *name,
438 OSSL_provider_init_fn *init_function,
439 STACK_OF(INFOPAIR) *parameters)
441 OSSL_PROVIDER *prov = NULL;
443 if ((prov = OPENSSL_zalloc(sizeof(*prov))) == NULL)
445 if (!CRYPTO_NEW_REF(&prov->refcnt, 1)) {
449 if ((prov->activatecnt_lock = CRYPTO_THREAD_lock_new()) == NULL) {
450 ossl_provider_free(prov);
451 ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
455 if ((prov->opbits_lock = CRYPTO_THREAD_lock_new()) == NULL
456 || (prov->flag_lock = CRYPTO_THREAD_lock_new()) == NULL
457 || (prov->parameters = sk_INFOPAIR_deep_copy(parameters,
459 infopair_free)) == NULL) {
460 ossl_provider_free(prov);
461 ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
464 if ((prov->name = OPENSSL_strdup(name)) == NULL) {
465 ossl_provider_free(prov);
469 prov->init_function = init_function;
474 int ossl_provider_up_ref(OSSL_PROVIDER *prov)
478 if (CRYPTO_UP_REF(&prov->refcnt, &ref) <= 0)
483 if (!ossl_provider_up_ref_parent(prov, 0)) {
484 ossl_provider_free(prov);
494 static int provider_up_ref_intern(OSSL_PROVIDER *prov, int activate)
497 return ossl_provider_activate(prov, 1, 0);
499 return ossl_provider_up_ref(prov);
502 static int provider_free_intern(OSSL_PROVIDER *prov, int deactivate)
505 return ossl_provider_deactivate(prov, 1);
507 ossl_provider_free(prov);
513 * We assume that the requested provider does not already exist in the store.
514 * The caller should check. If it does exist then adding it to the store later
517 OSSL_PROVIDER *ossl_provider_new(OSSL_LIB_CTX *libctx, const char *name,
518 OSSL_provider_init_fn *init_function,
519 OSSL_PARAM *params, int noconfig)
521 struct provider_store_st *store = NULL;
522 OSSL_PROVIDER_INFO template;
523 OSSL_PROVIDER *prov = NULL;
525 if ((store = get_provider_store(libctx)) == NULL)
528 memset(&template, 0, sizeof(template));
529 if (init_function == NULL) {
530 const OSSL_PROVIDER_INFO *p;
533 /* Check if this is a predefined builtin provider */
534 for (p = ossl_predefined_providers; p->name != NULL; p++) {
535 if (strcmp(p->name, name) == 0) {
540 if (p->name == NULL) {
541 /* Check if this is a user added provider */
542 if (!CRYPTO_THREAD_read_lock(store->lock))
544 for (i = 0, p = store->provinfo; i < store->numprovinfo; p++, i++) {
545 if (strcmp(p->name, name) == 0) {
550 CRYPTO_THREAD_unlock(store->lock);
553 template.init = init_function;
556 if (params != NULL) {
559 template.parameters = sk_INFOPAIR_new_null();
560 if (template.parameters == NULL)
563 for (i = 0; params[i].key != NULL; i++) {
564 if (params[i].data_type != OSSL_PARAM_UTF8_STRING)
566 if (ossl_provider_info_add_parameter(&template, params[i].key,
567 (char *)params[i].data) <= 0) {
568 sk_INFOPAIR_pop_free(template.parameters, infopair_free);
574 /* provider_new() generates an error, so no need here */
575 prov = provider_new(name, template.init, template.parameters);
576 if (!ossl_provider_set_module_path(prov, template.path)) {
577 ossl_provider_free(prov);
581 if (params != NULL) /* We copied the parameters, let's free them */
582 sk_INFOPAIR_pop_free(template.parameters, infopair_free);
587 prov->libctx = libctx;
589 prov->error_lib = ERR_get_next_error_library();
593 * At this point, the provider is only partially "loaded". To be
594 * fully "loaded", ossl_provider_activate() must also be called and it must
595 * then be added to the provider store.
601 /* Assumes that the store lock is held */
602 static int create_provider_children(OSSL_PROVIDER *prov)
606 struct provider_store_st *store = prov->store;
607 OSSL_PROVIDER_CHILD_CB *child_cb;
610 max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
611 for (i = 0; i < max; i++) {
613 * This is newly activated (activatecnt == 1), so we need to
614 * create child providers as necessary.
616 child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
617 ret &= child_cb->create_cb((OSSL_CORE_HANDLE *)prov, child_cb->cbdata);
624 int ossl_provider_add_to_store(OSSL_PROVIDER *prov, OSSL_PROVIDER **actualprov,
625 int retain_fallbacks)
627 struct provider_store_st *store;
629 OSSL_PROVIDER tmpl = { 0, };
630 OSSL_PROVIDER *actualtmp = NULL;
632 if (actualprov != NULL)
635 if ((store = get_provider_store(prov->libctx)) == NULL)
638 if (!CRYPTO_THREAD_write_lock(store->lock))
641 tmpl.name = (char *)prov->name;
642 idx = sk_OSSL_PROVIDER_find(store->providers, &tmpl);
646 actualtmp = sk_OSSL_PROVIDER_value(store->providers, idx);
649 if (sk_OSSL_PROVIDER_push(store->providers, prov) == 0)
652 if (!create_provider_children(prov)) {
653 sk_OSSL_PROVIDER_delete_ptr(store->providers, prov);
656 if (!retain_fallbacks)
657 store->use_fallbacks = 0;
660 CRYPTO_THREAD_unlock(store->lock);
662 if (actualprov != NULL) {
663 if (!ossl_provider_up_ref(actualtmp)) {
664 ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
668 *actualprov = actualtmp;
673 * The provider is already in the store. Probably two threads
674 * independently initialised their own provider objects with the same
675 * name and raced to put them in the store. This thread lost. We
676 * deactivate the one we just created and use the one that already
678 * If we get here then we know we did not create provider children
679 * above, so we inform ossl_provider_deactivate not to attempt to remove
682 ossl_provider_deactivate(prov, 0);
683 ossl_provider_free(prov);
688 * This can be done outside the lock. We tolerate other threads getting
689 * the wrong result briefly when creating OSSL_DECODER_CTXs.
691 ossl_decoder_cache_flush(prov->libctx);
698 CRYPTO_THREAD_unlock(store->lock);
702 void ossl_provider_free(OSSL_PROVIDER *prov)
707 CRYPTO_DOWN_REF(&prov->refcnt, &ref);
710 * When the refcount drops to zero, we clean up the provider.
711 * Note that this also does teardown, which may seem late,
712 * considering that init happens on first activation. However,
713 * there may be other structures hanging on to the provider after
714 * the last deactivation and may therefore need full access to the
715 * provider's services. Therefore, we deinit late.
718 if (prov->flag_initialized) {
719 ossl_provider_teardown(prov);
720 #ifndef OPENSSL_NO_ERR
722 if (prov->error_strings != NULL) {
723 ERR_unload_strings(prov->error_lib, prov->error_strings);
724 OPENSSL_free(prov->error_strings);
725 prov->error_strings = NULL;
729 OPENSSL_free(prov->operation_bits);
730 prov->operation_bits = NULL;
731 prov->operation_bits_sz = 0;
732 prov->flag_initialized = 0;
737 * We deregister thread handling whether or not the provider was
738 * initialized. If init was attempted but was not successful then
739 * the provider may still have registered a thread handler.
741 ossl_init_thread_deregister(prov);
742 DSO_free(prov->module);
744 OPENSSL_free(prov->name);
745 OPENSSL_free(prov->path);
746 sk_INFOPAIR_pop_free(prov->parameters, infopair_free);
747 CRYPTO_THREAD_lock_free(prov->opbits_lock);
748 CRYPTO_THREAD_lock_free(prov->flag_lock);
749 CRYPTO_THREAD_lock_free(prov->activatecnt_lock);
750 CRYPTO_FREE_REF(&prov->refcnt);
754 else if (prov->ischild) {
755 ossl_provider_free_parent(prov, 0);
762 int ossl_provider_set_module_path(OSSL_PROVIDER *prov, const char *module_path)
764 OPENSSL_free(prov->path);
766 if (module_path == NULL)
768 if ((prov->path = OPENSSL_strdup(module_path)) != NULL)
773 static int infopair_add(STACK_OF(INFOPAIR) **infopairsk, const char *name,
776 INFOPAIR *pair = NULL;
778 if ((pair = OPENSSL_zalloc(sizeof(*pair))) == NULL
779 || (pair->name = OPENSSL_strdup(name)) == NULL
780 || (pair->value = OPENSSL_strdup(value)) == NULL)
783 if ((*infopairsk == NULL
784 && (*infopairsk = sk_INFOPAIR_new_null()) == NULL)
785 || sk_INFOPAIR_push(*infopairsk, pair) <= 0) {
786 ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
794 OPENSSL_free(pair->name);
795 OPENSSL_free(pair->value);
801 int ossl_provider_add_parameter(OSSL_PROVIDER *prov,
802 const char *name, const char *value)
804 return infopair_add(&prov->parameters, name, value);
807 int ossl_provider_info_add_parameter(OSSL_PROVIDER_INFO *provinfo,
811 return infopair_add(&provinfo->parameters, name, value);
815 * Provider activation.
817 * What "activation" means depends on the provider form; for built in
818 * providers (in the library or the application alike), the provider
819 * can already be considered to be loaded, all that's needed is to
820 * initialize it. However, for dynamically loadable provider modules,
821 * we must first load that module.
823 * Built in modules are distinguished from dynamically loaded modules
824 * with an already assigned init function.
826 static const OSSL_DISPATCH *core_dispatch; /* Define further down */
828 int OSSL_PROVIDER_set_default_search_path(OSSL_LIB_CTX *libctx,
831 struct provider_store_st *store;
835 p = OPENSSL_strdup(path);
839 if ((store = get_provider_store(libctx)) != NULL
840 && CRYPTO_THREAD_write_lock(store->default_path_lock)) {
841 OPENSSL_free(store->default_path);
842 store->default_path = p;
843 CRYPTO_THREAD_unlock(store->default_path_lock);
850 const char *OSSL_PROVIDER_get0_default_search_path(OSSL_LIB_CTX *libctx)
852 struct provider_store_st *store;
855 if ((store = get_provider_store(libctx)) != NULL
856 && CRYPTO_THREAD_read_lock(store->default_path_lock)) {
857 path = store->default_path;
858 CRYPTO_THREAD_unlock(store->default_path_lock);
864 * Internal version that doesn't affect the store flags, and thereby avoid
865 * locking. Direct callers must remember to set the store flags when
868 static int provider_init(OSSL_PROVIDER *prov)
870 const OSSL_DISPATCH *provider_dispatch = NULL;
871 void *tmp_provctx = NULL; /* safety measure */
872 #ifndef OPENSSL_NO_ERR
874 OSSL_FUNC_provider_get_reason_strings_fn *p_get_reason_strings = NULL;
879 if (!ossl_assert(!prov->flag_initialized)) {
880 ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
885 * If the init function isn't set, it indicates that this provider is
888 if (prov->init_function == NULL) {
892 if (prov->module == NULL) {
893 char *allocated_path = NULL;
894 const char *module_path = NULL;
895 char *merged_path = NULL;
896 const char *load_dir = NULL;
897 char *allocated_load_dir = NULL;
898 struct provider_store_st *store;
900 if ((prov->module = DSO_new()) == NULL) {
901 /* DSO_new() generates an error already */
905 if ((store = get_provider_store(prov->libctx)) == NULL
906 || !CRYPTO_THREAD_read_lock(store->default_path_lock))
909 if (store->default_path != NULL) {
910 allocated_load_dir = OPENSSL_strdup(store->default_path);
911 CRYPTO_THREAD_unlock(store->default_path_lock);
912 if (allocated_load_dir == NULL)
914 load_dir = allocated_load_dir;
916 CRYPTO_THREAD_unlock(store->default_path_lock);
919 if (load_dir == NULL) {
920 load_dir = ossl_safe_getenv("OPENSSL_MODULES");
921 if (load_dir == NULL)
922 load_dir = MODULESDIR;
925 DSO_ctrl(prov->module, DSO_CTRL_SET_FLAGS,
926 DSO_FLAG_NAME_TRANSLATION_EXT_ONLY, NULL);
928 module_path = prov->path;
929 if (module_path == NULL)
930 module_path = allocated_path =
931 DSO_convert_filename(prov->module, prov->name);
932 if (module_path != NULL)
933 merged_path = DSO_merge(prov->module, module_path, load_dir);
935 if (merged_path == NULL
936 || (DSO_load(prov->module, merged_path, NULL, 0)) == NULL) {
937 DSO_free(prov->module);
941 OPENSSL_free(merged_path);
942 OPENSSL_free(allocated_path);
943 OPENSSL_free(allocated_load_dir);
946 if (prov->module == NULL) {
947 /* DSO has already recorded errors, this is just a tracepoint */
948 ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_DSO_LIB,
949 "name=%s", prov->name);
953 prov->init_function = (OSSL_provider_init_fn *)
954 DSO_bind_func(prov->module, "OSSL_provider_init");
958 /* Check for and call the initialise function for the provider. */
959 if (prov->init_function == NULL) {
960 ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_UNSUPPORTED,
961 "name=%s, provider has no provider init function",
966 if (!prov->init_function((OSSL_CORE_HANDLE *)prov, core_dispatch,
967 &provider_dispatch, &tmp_provctx)) {
968 ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_INIT_FAIL,
969 "name=%s", prov->name);
972 prov->provctx = tmp_provctx;
973 prov->dispatch = provider_dispatch;
975 if (provider_dispatch != NULL) {
976 for (; provider_dispatch->function_id != 0; provider_dispatch++) {
977 switch (provider_dispatch->function_id) {
978 case OSSL_FUNC_PROVIDER_TEARDOWN:
980 OSSL_FUNC_provider_teardown(provider_dispatch);
982 case OSSL_FUNC_PROVIDER_GETTABLE_PARAMS:
983 prov->gettable_params =
984 OSSL_FUNC_provider_gettable_params(provider_dispatch);
986 case OSSL_FUNC_PROVIDER_GET_PARAMS:
988 OSSL_FUNC_provider_get_params(provider_dispatch);
990 case OSSL_FUNC_PROVIDER_SELF_TEST:
992 OSSL_FUNC_provider_self_test(provider_dispatch);
994 case OSSL_FUNC_PROVIDER_GET_CAPABILITIES:
995 prov->get_capabilities =
996 OSSL_FUNC_provider_get_capabilities(provider_dispatch);
998 case OSSL_FUNC_PROVIDER_QUERY_OPERATION:
999 prov->query_operation =
1000 OSSL_FUNC_provider_query_operation(provider_dispatch);
1002 case OSSL_FUNC_PROVIDER_UNQUERY_OPERATION:
1003 prov->unquery_operation =
1004 OSSL_FUNC_provider_unquery_operation(provider_dispatch);
1006 #ifndef OPENSSL_NO_ERR
1007 # ifndef FIPS_MODULE
1008 case OSSL_FUNC_PROVIDER_GET_REASON_STRINGS:
1009 p_get_reason_strings =
1010 OSSL_FUNC_provider_get_reason_strings(provider_dispatch);
1018 #ifndef OPENSSL_NO_ERR
1019 # ifndef FIPS_MODULE
1020 if (p_get_reason_strings != NULL) {
1021 const OSSL_ITEM *reasonstrings = p_get_reason_strings(prov->provctx);
1025 * ERR_load_strings() handles ERR_STRING_DATA rather than OSSL_ITEM,
1026 * although they are essentially the same type.
1027 * Furthermore, ERR_load_strings() patches the array's error number
1028 * with the error library number, so we need to make a copy of that
1032 while (reasonstrings[cnt].id != 0) {
1033 if (ERR_GET_LIB(reasonstrings[cnt].id) != 0)
1037 cnt++; /* One for the terminating item */
1039 /* Allocate one extra item for the "library" name */
1040 prov->error_strings =
1041 OPENSSL_zalloc(sizeof(ERR_STRING_DATA) * (cnt + 1));
1042 if (prov->error_strings == NULL)
1046 * Set the "library" name.
1048 prov->error_strings[0].error = ERR_PACK(prov->error_lib, 0, 0);
1049 prov->error_strings[0].string = prov->name;
1051 * Copy reasonstrings item 0..cnt-1 to prov->error_trings positions
1054 for (cnt2 = 1; cnt2 <= cnt; cnt2++) {
1055 prov->error_strings[cnt2].error = (int)reasonstrings[cnt2-1].id;
1056 prov->error_strings[cnt2].string = reasonstrings[cnt2-1].ptr;
1059 ERR_load_strings(prov->error_lib, prov->error_strings);
1064 /* With this flag set, this provider has become fully "loaded". */
1065 prov->flag_initialized = 1;
1073 * Deactivate a provider. If upcalls is 0 then we suppress any upcalls to a
1074 * parent provider. If removechildren is 0 then we suppress any calls to remove
1076 * Return -1 on failure and the activation count on success
1078 static int provider_deactivate(OSSL_PROVIDER *prov, int upcalls,
1082 struct provider_store_st *store;
1088 if (!ossl_assert(prov != NULL))
1092 * No need to lock if we've got no store because we've not been shared with
1095 store = get_provider_store(prov->libctx);
1099 if (lock && !CRYPTO_THREAD_read_lock(store->lock))
1101 if (lock && !CRYPTO_THREAD_write_lock(prov->flag_lock)) {
1102 CRYPTO_THREAD_unlock(store->lock);
1106 CRYPTO_atomic_add(&prov->activatecnt, -1, &count, prov->activatecnt_lock);
1108 if (count >= 1 && prov->ischild && upcalls) {
1110 * We have had a direct activation in this child libctx so we need to
1111 * now down the ref count in the parent provider. We do the actual down
1112 * ref outside of the flag_lock, since it could involve getting other
1120 prov->flag_activated = 0;
1127 if (removechildren && store != NULL) {
1128 int i, max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1129 OSSL_PROVIDER_CHILD_CB *child_cb;
1131 for (i = 0; i < max; i++) {
1132 child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1133 child_cb->remove_cb((OSSL_CORE_HANDLE *)prov, child_cb->cbdata);
1138 CRYPTO_THREAD_unlock(prov->flag_lock);
1139 CRYPTO_THREAD_unlock(store->lock);
1141 * This can be done outside the lock. We tolerate other threads getting
1142 * the wrong result briefly when creating OSSL_DECODER_CTXs.
1146 ossl_decoder_cache_flush(prov->libctx);
1151 ossl_provider_free_parent(prov, 1);
1154 /* We don't deinit here, that's done in ossl_provider_free() */
1159 * Activate a provider.
1160 * Return -1 on failure and the activation count on success
1162 static int provider_activate(OSSL_PROVIDER *prov, int lock, int upcalls)
1165 struct provider_store_st *store;
1168 store = prov->store;
1170 * If the provider hasn't been added to the store, then we don't need
1171 * any locks because we've not shared it with other threads.
1173 if (store == NULL) {
1175 if (!provider_init(prov))
1180 if (prov->ischild && upcalls && !ossl_provider_up_ref_parent(prov, 1))
1184 if (lock && !CRYPTO_THREAD_read_lock(store->lock)) {
1186 if (prov->ischild && upcalls)
1187 ossl_provider_free_parent(prov, 1);
1192 if (lock && !CRYPTO_THREAD_write_lock(prov->flag_lock)) {
1193 CRYPTO_THREAD_unlock(store->lock);
1195 if (prov->ischild && upcalls)
1196 ossl_provider_free_parent(prov, 1);
1200 if (CRYPTO_atomic_add(&prov->activatecnt, 1, &count, prov->activatecnt_lock)) {
1201 prov->flag_activated = 1;
1203 if (count == 1 && store != NULL) {
1204 ret = create_provider_children(prov);
1208 CRYPTO_THREAD_unlock(prov->flag_lock);
1209 CRYPTO_THREAD_unlock(store->lock);
1211 * This can be done outside the lock. We tolerate other threads getting
1212 * the wrong result briefly when creating OSSL_DECODER_CTXs.
1216 ossl_decoder_cache_flush(prov->libctx);
1226 static int provider_flush_store_cache(const OSSL_PROVIDER *prov)
1228 struct provider_store_st *store;
1231 if ((store = get_provider_store(prov->libctx)) == NULL)
1234 if (!CRYPTO_THREAD_read_lock(store->lock))
1236 freeing = store->freeing;
1237 CRYPTO_THREAD_unlock(store->lock);
1241 = evp_method_store_cache_flush(prov->libctx)
1243 + ossl_encoder_store_cache_flush(prov->libctx)
1244 + ossl_decoder_store_cache_flush(prov->libctx)
1245 + ossl_store_loader_store_cache_flush(prov->libctx)
1258 static int provider_remove_store_methods(OSSL_PROVIDER *prov)
1260 struct provider_store_st *store;
1263 if ((store = get_provider_store(prov->libctx)) == NULL)
1266 if (!CRYPTO_THREAD_read_lock(store->lock))
1268 freeing = store->freeing;
1269 CRYPTO_THREAD_unlock(store->lock);
1274 if (!CRYPTO_THREAD_write_lock(prov->opbits_lock))
1276 OPENSSL_free(prov->operation_bits);
1277 prov->operation_bits = NULL;
1278 prov->operation_bits_sz = 0;
1279 CRYPTO_THREAD_unlock(prov->opbits_lock);
1281 acc = evp_method_store_remove_all_provided(prov)
1283 + ossl_encoder_store_remove_all_provided(prov)
1284 + ossl_decoder_store_remove_all_provided(prov)
1285 + ossl_store_loader_store_remove_all_provided(prov)
1298 int ossl_provider_activate(OSSL_PROVIDER *prov, int upcalls, int aschild)
1306 * If aschild is true, then we only actually do the activation if the
1307 * provider is a child. If its not, this is still success.
1309 if (aschild && !prov->ischild)
1312 if ((count = provider_activate(prov, 1, upcalls)) > 0)
1313 return count == 1 ? provider_flush_store_cache(prov) : 1;
1318 int ossl_provider_deactivate(OSSL_PROVIDER *prov, int removechildren)
1323 || (count = provider_deactivate(prov, 1, removechildren)) < 0)
1325 return count == 0 ? provider_remove_store_methods(prov) : 1;
1328 void *ossl_provider_ctx(const OSSL_PROVIDER *prov)
1330 return prov != NULL ? prov->provctx : NULL;
1334 * This function only does something once when store->use_fallbacks == 1,
1335 * and then sets store->use_fallbacks = 0, so the second call and so on is
1336 * effectively a no-op.
1338 static int provider_activate_fallbacks(struct provider_store_st *store)
1341 int activated_fallback_count = 0;
1343 const OSSL_PROVIDER_INFO *p;
1345 if (!CRYPTO_THREAD_read_lock(store->lock))
1347 use_fallbacks = store->use_fallbacks;
1348 CRYPTO_THREAD_unlock(store->lock);
1352 if (!CRYPTO_THREAD_write_lock(store->lock))
1354 /* Check again, just in case another thread changed it */
1355 use_fallbacks = store->use_fallbacks;
1356 if (!use_fallbacks) {
1357 CRYPTO_THREAD_unlock(store->lock);
1361 for (p = ossl_predefined_providers; p->name != NULL; p++) {
1362 OSSL_PROVIDER *prov = NULL;
1364 if (!p->is_fallback)
1367 * We use the internal constructor directly here,
1368 * otherwise we get a call loop
1370 prov = provider_new(p->name, p->init, NULL);
1373 prov->libctx = store->libctx;
1375 prov->error_lib = ERR_get_next_error_library();
1379 * We are calling provider_activate while holding the store lock. This
1380 * means the init function will be called while holding a lock. Normally
1381 * we try to avoid calling a user callback while holding a lock.
1382 * However, fallbacks are never third party providers so we accept this.
1384 if (provider_activate(prov, 0, 0) < 0) {
1385 ossl_provider_free(prov);
1388 prov->store = store;
1389 if (sk_OSSL_PROVIDER_push(store->providers, prov) == 0) {
1390 ossl_provider_free(prov);
1393 activated_fallback_count++;
1396 if (activated_fallback_count > 0) {
1397 store->use_fallbacks = 0;
1401 CRYPTO_THREAD_unlock(store->lock);
1405 int ossl_provider_doall_activated(OSSL_LIB_CTX *ctx,
1406 int (*cb)(OSSL_PROVIDER *provider,
1410 int ret = 0, curr, max, ref = 0;
1411 struct provider_store_st *store = get_provider_store(ctx);
1412 STACK_OF(OSSL_PROVIDER) *provs = NULL;
1414 #if !defined(FIPS_MODULE) && !defined(OPENSSL_NO_AUTOLOAD_CONFIG)
1416 * Make sure any providers are loaded from config before we try to use
1419 if (ossl_lib_ctx_is_default(ctx))
1420 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL);
1425 if (!provider_activate_fallbacks(store))
1429 * Under lock, grab a copy of the provider list and up_ref each
1430 * provider so that they don't disappear underneath us.
1432 if (!CRYPTO_THREAD_read_lock(store->lock))
1434 provs = sk_OSSL_PROVIDER_dup(store->providers);
1435 if (provs == NULL) {
1436 CRYPTO_THREAD_unlock(store->lock);
1439 max = sk_OSSL_PROVIDER_num(provs);
1441 * We work backwards through the stack so that we can safely delete items
1444 for (curr = max - 1; curr >= 0; curr--) {
1445 OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1447 if (!CRYPTO_THREAD_read_lock(prov->flag_lock))
1449 if (prov->flag_activated) {
1451 * We call CRYPTO_UP_REF directly rather than ossl_provider_up_ref
1452 * to avoid upping the ref count on the parent provider, which we
1453 * must not do while holding locks.
1455 if (CRYPTO_UP_REF(&prov->refcnt, &ref) <= 0) {
1456 CRYPTO_THREAD_unlock(prov->flag_lock);
1460 * It's already activated, but we up the activated count to ensure
1461 * it remains activated until after we've called the user callback.
1462 * In theory this could mean the parent provider goes inactive,
1463 * whilst still activated in the child for a short period. That's ok.
1465 if (!CRYPTO_atomic_add(&prov->activatecnt, 1, &ref,
1466 prov->activatecnt_lock)) {
1467 CRYPTO_DOWN_REF(&prov->refcnt, &ref);
1468 CRYPTO_THREAD_unlock(prov->flag_lock);
1472 sk_OSSL_PROVIDER_delete(provs, curr);
1475 CRYPTO_THREAD_unlock(prov->flag_lock);
1477 CRYPTO_THREAD_unlock(store->lock);
1480 * Now, we sweep through all providers not under lock
1482 for (curr = 0; curr < max; curr++) {
1483 OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1485 if (!cb(prov, cbdata)) {
1496 CRYPTO_THREAD_unlock(store->lock);
1499 * The pop_free call doesn't do what we want on an error condition. We
1500 * either start from the first item in the stack, or part way through if
1501 * we only processed some of the items.
1503 for (curr++; curr < max; curr++) {
1504 OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1506 if (!CRYPTO_atomic_add(&prov->activatecnt, -1, &ref,
1507 prov->activatecnt_lock)) {
1513 * Looks like we need to deactivate properly. We could just have
1514 * done this originally, but it involves taking a write lock so
1515 * we avoid it. We up the count again and do a full deactivation
1517 if (CRYPTO_atomic_add(&prov->activatecnt, 1, &ref,
1518 prov->activatecnt_lock))
1519 provider_deactivate(prov, 0, 1);
1524 * As above where we did the up-ref, we don't call ossl_provider_free
1525 * to avoid making upcalls. There should always be at least one ref
1526 * to the provider in the store, so this should never drop to 0.
1528 if (!CRYPTO_DOWN_REF(&prov->refcnt, &ref)) {
1533 * Not much we can do if this assert ever fails. So we don't use
1538 sk_OSSL_PROVIDER_free(provs);
1542 int OSSL_PROVIDER_available(OSSL_LIB_CTX *libctx, const char *name)
1544 OSSL_PROVIDER *prov = NULL;
1546 struct provider_store_st *store = get_provider_store(libctx);
1548 if (store == NULL || !provider_activate_fallbacks(store))
1551 prov = ossl_provider_find(libctx, name, 0);
1553 if (!CRYPTO_THREAD_read_lock(prov->flag_lock))
1555 available = prov->flag_activated;
1556 CRYPTO_THREAD_unlock(prov->flag_lock);
1557 ossl_provider_free(prov);
1562 /* Getters of Provider Object data */
1563 const char *ossl_provider_name(const OSSL_PROVIDER *prov)
1568 const DSO *ossl_provider_dso(const OSSL_PROVIDER *prov)
1570 return prov->module;
1573 const char *ossl_provider_module_name(const OSSL_PROVIDER *prov)
1578 return DSO_get_filename(prov->module);
1582 const char *ossl_provider_module_path(const OSSL_PROVIDER *prov)
1587 /* FIXME: Ensure it's a full path */
1588 return DSO_get_filename(prov->module);
1592 void *ossl_provider_prov_ctx(const OSSL_PROVIDER *prov)
1595 return prov->provctx;
1600 const OSSL_DISPATCH *ossl_provider_get0_dispatch(const OSSL_PROVIDER *prov)
1603 return prov->dispatch;
1608 OSSL_LIB_CTX *ossl_provider_libctx(const OSSL_PROVIDER *prov)
1610 return prov != NULL ? prov->libctx : NULL;
1613 /* Wrappers around calls to the provider */
1614 void ossl_provider_teardown(const OSSL_PROVIDER *prov)
1616 if (prov->teardown != NULL
1621 prov->teardown(prov->provctx);
1624 const OSSL_PARAM *ossl_provider_gettable_params(const OSSL_PROVIDER *prov)
1626 return prov->gettable_params == NULL
1627 ? NULL : prov->gettable_params(prov->provctx);
1630 int ossl_provider_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
1632 return prov->get_params == NULL
1633 ? 0 : prov->get_params(prov->provctx, params);
1636 int ossl_provider_self_test(const OSSL_PROVIDER *prov)
1640 if (prov->self_test == NULL)
1642 ret = prov->self_test(prov->provctx);
1644 (void)provider_remove_store_methods((OSSL_PROVIDER *)prov);
1648 int ossl_provider_get_capabilities(const OSSL_PROVIDER *prov,
1649 const char *capability,
1653 return prov->get_capabilities == NULL
1654 ? 1 : prov->get_capabilities(prov->provctx, capability, cb, arg);
1657 const OSSL_ALGORITHM *ossl_provider_query_operation(const OSSL_PROVIDER *prov,
1661 const OSSL_ALGORITHM *res;
1663 if (prov->query_operation == NULL)
1665 res = prov->query_operation(prov->provctx, operation_id, no_cache);
1666 #if defined(OPENSSL_NO_CACHED_FETCH)
1667 /* Forcing the non-caching of queries */
1668 if (no_cache != NULL)
1674 void ossl_provider_unquery_operation(const OSSL_PROVIDER *prov,
1676 const OSSL_ALGORITHM *algs)
1678 if (prov->unquery_operation != NULL)
1679 prov->unquery_operation(prov->provctx, operation_id, algs);
1682 int ossl_provider_set_operation_bit(OSSL_PROVIDER *provider, size_t bitnum)
1684 size_t byte = bitnum / 8;
1685 unsigned char bit = (1 << (bitnum % 8)) & 0xFF;
1687 if (!CRYPTO_THREAD_write_lock(provider->opbits_lock))
1689 if (provider->operation_bits_sz <= byte) {
1690 unsigned char *tmp = OPENSSL_realloc(provider->operation_bits,
1694 CRYPTO_THREAD_unlock(provider->opbits_lock);
1697 provider->operation_bits = tmp;
1698 memset(provider->operation_bits + provider->operation_bits_sz,
1699 '\0', byte + 1 - provider->operation_bits_sz);
1700 provider->operation_bits_sz = byte + 1;
1702 provider->operation_bits[byte] |= bit;
1703 CRYPTO_THREAD_unlock(provider->opbits_lock);
1707 int ossl_provider_test_operation_bit(OSSL_PROVIDER *provider, size_t bitnum,
1710 size_t byte = bitnum / 8;
1711 unsigned char bit = (1 << (bitnum % 8)) & 0xFF;
1713 if (!ossl_assert(result != NULL)) {
1714 ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
1719 if (!CRYPTO_THREAD_read_lock(provider->opbits_lock))
1721 if (provider->operation_bits_sz > byte)
1722 *result = ((provider->operation_bits[byte] & bit) != 0);
1723 CRYPTO_THREAD_unlock(provider->opbits_lock);
1728 const OSSL_CORE_HANDLE *ossl_provider_get_parent(OSSL_PROVIDER *prov)
1730 return prov->handle;
1733 int ossl_provider_is_child(const OSSL_PROVIDER *prov)
1735 return prov->ischild;
1738 int ossl_provider_set_child(OSSL_PROVIDER *prov, const OSSL_CORE_HANDLE *handle)
1740 prov->handle = handle;
1746 int ossl_provider_default_props_update(OSSL_LIB_CTX *libctx, const char *props)
1749 struct provider_store_st *store = NULL;
1751 OSSL_PROVIDER_CHILD_CB *child_cb;
1753 if ((store = get_provider_store(libctx)) == NULL)
1756 if (!CRYPTO_THREAD_read_lock(store->lock))
1759 max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1760 for (i = 0; i < max; i++) {
1761 child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1762 child_cb->global_props_cb(props, child_cb->cbdata);
1765 CRYPTO_THREAD_unlock(store->lock);
1770 static int ossl_provider_register_child_cb(const OSSL_CORE_HANDLE *handle,
1772 const OSSL_CORE_HANDLE *provider,
1775 const OSSL_CORE_HANDLE *provider,
1777 int (*global_props_cb)(
1783 * This is really an OSSL_PROVIDER that we created and cast to
1784 * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1786 OSSL_PROVIDER *thisprov = (OSSL_PROVIDER *)handle;
1787 OSSL_PROVIDER *prov;
1788 OSSL_LIB_CTX *libctx = thisprov->libctx;
1789 struct provider_store_st *store = NULL;
1790 int ret = 0, i, max;
1791 OSSL_PROVIDER_CHILD_CB *child_cb;
1792 char *propsstr = NULL;
1794 if ((store = get_provider_store(libctx)) == NULL)
1797 child_cb = OPENSSL_malloc(sizeof(*child_cb));
1798 if (child_cb == NULL)
1800 child_cb->prov = thisprov;
1801 child_cb->create_cb = create_cb;
1802 child_cb->remove_cb = remove_cb;
1803 child_cb->global_props_cb = global_props_cb;
1804 child_cb->cbdata = cbdata;
1806 if (!CRYPTO_THREAD_write_lock(store->lock)) {
1807 OPENSSL_free(child_cb);
1810 propsstr = evp_get_global_properties_str(libctx, 0);
1812 if (propsstr != NULL) {
1813 global_props_cb(propsstr, cbdata);
1814 OPENSSL_free(propsstr);
1816 max = sk_OSSL_PROVIDER_num(store->providers);
1817 for (i = 0; i < max; i++) {
1820 prov = sk_OSSL_PROVIDER_value(store->providers, i);
1822 if (!CRYPTO_THREAD_read_lock(prov->flag_lock))
1824 activated = prov->flag_activated;
1825 CRYPTO_THREAD_unlock(prov->flag_lock);
1827 * We hold the store lock while calling the user callback. This means
1828 * that the user callback must be short and simple and not do anything
1829 * likely to cause a deadlock. We don't hold the flag_lock during this
1830 * call. In theory this means that another thread could deactivate it
1831 * while we are calling create. This is ok because the other thread
1832 * will also call remove_cb, but won't be able to do so until we release
1835 if (activated && !create_cb((OSSL_CORE_HANDLE *)prov, cbdata))
1840 ret = sk_OSSL_PROVIDER_CHILD_CB_push(store->child_cbs, child_cb);
1842 if (i != max || ret <= 0) {
1843 /* Failed during creation. Remove everything we just added */
1844 for (; i >= 0; i--) {
1845 prov = sk_OSSL_PROVIDER_value(store->providers, i);
1846 remove_cb((OSSL_CORE_HANDLE *)prov, cbdata);
1848 OPENSSL_free(child_cb);
1851 CRYPTO_THREAD_unlock(store->lock);
1856 static void ossl_provider_deregister_child_cb(const OSSL_CORE_HANDLE *handle)
1859 * This is really an OSSL_PROVIDER that we created and cast to
1860 * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1862 OSSL_PROVIDER *thisprov = (OSSL_PROVIDER *)handle;
1863 OSSL_LIB_CTX *libctx = thisprov->libctx;
1864 struct provider_store_st *store = NULL;
1866 OSSL_PROVIDER_CHILD_CB *child_cb;
1868 if ((store = get_provider_store(libctx)) == NULL)
1871 if (!CRYPTO_THREAD_write_lock(store->lock))
1873 max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1874 for (i = 0; i < max; i++) {
1875 child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1876 if (child_cb->prov == thisprov) {
1877 /* Found an entry */
1878 sk_OSSL_PROVIDER_CHILD_CB_delete(store->child_cbs, i);
1879 OPENSSL_free(child_cb);
1883 CRYPTO_THREAD_unlock(store->lock);
1888 * Core functions for the provider
1889 * ===============================
1891 * This is the set of functions that the core makes available to the provider
1895 * This returns a list of Provider Object parameters with their types, for
1896 * discovery. We do not expect that many providers will use this, but one
1899 static const OSSL_PARAM param_types[] = {
1900 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_VERSION, OSSL_PARAM_UTF8_PTR, NULL, 0),
1901 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_PROV_NAME, OSSL_PARAM_UTF8_PTR,
1904 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_MODULE_FILENAME, OSSL_PARAM_UTF8_PTR,
1911 * Forward declare all the functions that are provided aa dispatch.
1912 * This ensures that the compiler will complain if they aren't defined
1913 * with the correct signature.
1915 static OSSL_FUNC_core_gettable_params_fn core_gettable_params;
1916 static OSSL_FUNC_core_get_params_fn core_get_params;
1917 static OSSL_FUNC_core_get_libctx_fn core_get_libctx;
1918 static OSSL_FUNC_core_thread_start_fn core_thread_start;
1920 static OSSL_FUNC_core_new_error_fn core_new_error;
1921 static OSSL_FUNC_core_set_error_debug_fn core_set_error_debug;
1922 static OSSL_FUNC_core_vset_error_fn core_vset_error;
1923 static OSSL_FUNC_core_set_error_mark_fn core_set_error_mark;
1924 static OSSL_FUNC_core_clear_last_error_mark_fn core_clear_last_error_mark;
1925 static OSSL_FUNC_core_pop_error_to_mark_fn core_pop_error_to_mark;
1926 OSSL_FUNC_BIO_new_file_fn ossl_core_bio_new_file;
1927 OSSL_FUNC_BIO_new_membuf_fn ossl_core_bio_new_mem_buf;
1928 OSSL_FUNC_BIO_read_ex_fn ossl_core_bio_read_ex;
1929 OSSL_FUNC_BIO_write_ex_fn ossl_core_bio_write_ex;
1930 OSSL_FUNC_BIO_gets_fn ossl_core_bio_gets;
1931 OSSL_FUNC_BIO_puts_fn ossl_core_bio_puts;
1932 OSSL_FUNC_BIO_up_ref_fn ossl_core_bio_up_ref;
1933 OSSL_FUNC_BIO_free_fn ossl_core_bio_free;
1934 OSSL_FUNC_BIO_vprintf_fn ossl_core_bio_vprintf;
1935 OSSL_FUNC_BIO_vsnprintf_fn BIO_vsnprintf;
1936 static OSSL_FUNC_self_test_cb_fn core_self_test_get_callback;
1937 static OSSL_FUNC_get_entropy_fn rand_get_entropy;
1938 static OSSL_FUNC_get_user_entropy_fn rand_get_user_entropy;
1939 static OSSL_FUNC_cleanup_entropy_fn rand_cleanup_entropy;
1940 static OSSL_FUNC_cleanup_user_entropy_fn rand_cleanup_user_entropy;
1941 static OSSL_FUNC_get_nonce_fn rand_get_nonce;
1942 static OSSL_FUNC_get_user_nonce_fn rand_get_user_nonce;
1943 static OSSL_FUNC_cleanup_nonce_fn rand_cleanup_nonce;
1944 static OSSL_FUNC_cleanup_user_nonce_fn rand_cleanup_user_nonce;
1946 OSSL_FUNC_CRYPTO_malloc_fn CRYPTO_malloc;
1947 OSSL_FUNC_CRYPTO_zalloc_fn CRYPTO_zalloc;
1948 OSSL_FUNC_CRYPTO_free_fn CRYPTO_free;
1949 OSSL_FUNC_CRYPTO_clear_free_fn CRYPTO_clear_free;
1950 OSSL_FUNC_CRYPTO_realloc_fn CRYPTO_realloc;
1951 OSSL_FUNC_CRYPTO_clear_realloc_fn CRYPTO_clear_realloc;
1952 OSSL_FUNC_CRYPTO_secure_malloc_fn CRYPTO_secure_malloc;
1953 OSSL_FUNC_CRYPTO_secure_zalloc_fn CRYPTO_secure_zalloc;
1954 OSSL_FUNC_CRYPTO_secure_free_fn CRYPTO_secure_free;
1955 OSSL_FUNC_CRYPTO_secure_clear_free_fn CRYPTO_secure_clear_free;
1956 OSSL_FUNC_CRYPTO_secure_allocated_fn CRYPTO_secure_allocated;
1957 OSSL_FUNC_OPENSSL_cleanse_fn OPENSSL_cleanse;
1959 OSSL_FUNC_provider_register_child_cb_fn ossl_provider_register_child_cb;
1960 OSSL_FUNC_provider_deregister_child_cb_fn ossl_provider_deregister_child_cb;
1961 static OSSL_FUNC_provider_name_fn core_provider_get0_name;
1962 static OSSL_FUNC_provider_get0_provider_ctx_fn core_provider_get0_provider_ctx;
1963 static OSSL_FUNC_provider_get0_dispatch_fn core_provider_get0_dispatch;
1964 static OSSL_FUNC_provider_up_ref_fn core_provider_up_ref_intern;
1965 static OSSL_FUNC_provider_free_fn core_provider_free_intern;
1966 static OSSL_FUNC_core_obj_add_sigid_fn core_obj_add_sigid;
1967 static OSSL_FUNC_core_obj_create_fn core_obj_create;
1970 static const OSSL_PARAM *core_gettable_params(const OSSL_CORE_HANDLE *handle)
1975 static int core_get_params(const OSSL_CORE_HANDLE *handle, OSSL_PARAM params[])
1980 * We created this object originally and we know it is actually an
1981 * OSSL_PROVIDER *, so the cast is safe
1983 OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
1985 if ((p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_CORE_VERSION)) != NULL)
1986 OSSL_PARAM_set_utf8_ptr(p, OPENSSL_VERSION_STR);
1987 if ((p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_CORE_PROV_NAME)) != NULL)
1988 OSSL_PARAM_set_utf8_ptr(p, prov->name);
1991 if ((p = OSSL_PARAM_locate(params,
1992 OSSL_PROV_PARAM_CORE_MODULE_FILENAME)) != NULL)
1993 OSSL_PARAM_set_utf8_ptr(p, ossl_provider_module_path(prov));
1996 if (prov->parameters == NULL)
1999 for (i = 0; i < sk_INFOPAIR_num(prov->parameters); i++) {
2000 INFOPAIR *pair = sk_INFOPAIR_value(prov->parameters, i);
2002 if ((p = OSSL_PARAM_locate(params, pair->name)) != NULL)
2003 OSSL_PARAM_set_utf8_ptr(p, pair->value);
2008 static OPENSSL_CORE_CTX *core_get_libctx(const OSSL_CORE_HANDLE *handle)
2011 * We created this object originally and we know it is actually an
2012 * OSSL_PROVIDER *, so the cast is safe
2014 OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
2017 * Using ossl_provider_libctx would be wrong as that returns
2018 * NULL for |prov| == NULL and NULL libctx has a special meaning
2019 * that does not apply here. Here |prov| == NULL can happen only in
2020 * case of a coding error.
2022 assert(prov != NULL);
2023 return (OPENSSL_CORE_CTX *)prov->libctx;
2026 static int core_thread_start(const OSSL_CORE_HANDLE *handle,
2027 OSSL_thread_stop_handler_fn handfn,
2031 * We created this object originally and we know it is actually an
2032 * OSSL_PROVIDER *, so the cast is safe
2034 OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
2036 return ossl_init_thread_start(prov, arg, handfn);
2040 * The FIPS module inner provider doesn't implement these. They aren't
2041 * needed there, since the FIPS module upcalls are always the outer provider
2046 * These error functions should use |handle| to select the proper
2047 * library context to report in the correct error stack if error
2048 * stacks become tied to the library context.
2049 * We cannot currently do that since there's no support for it in the
2052 static void core_new_error(const OSSL_CORE_HANDLE *handle)
2057 static void core_set_error_debug(const OSSL_CORE_HANDLE *handle,
2058 const char *file, int line, const char *func)
2060 ERR_set_debug(file, line, func);
2063 static void core_vset_error(const OSSL_CORE_HANDLE *handle,
2064 uint32_t reason, const char *fmt, va_list args)
2067 * We created this object originally and we know it is actually an
2068 * OSSL_PROVIDER *, so the cast is safe
2070 OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
2073 * If the uppermost 8 bits are non-zero, it's an OpenSSL library
2074 * error and will be treated as such. Otherwise, it's a new style
2075 * provider error and will be treated as such.
2077 if (ERR_GET_LIB(reason) != 0) {
2078 ERR_vset_error(ERR_GET_LIB(reason), ERR_GET_REASON(reason), fmt, args);
2080 ERR_vset_error(prov->error_lib, (int)reason, fmt, args);
2084 static int core_set_error_mark(const OSSL_CORE_HANDLE *handle)
2086 return ERR_set_mark();
2089 static int core_clear_last_error_mark(const OSSL_CORE_HANDLE *handle)
2091 return ERR_clear_last_mark();
2094 static int core_pop_error_to_mark(const OSSL_CORE_HANDLE *handle)
2096 return ERR_pop_to_mark();
2099 static void core_self_test_get_callback(OPENSSL_CORE_CTX *libctx,
2100 OSSL_CALLBACK **cb, void **cbarg)
2102 OSSL_SELF_TEST_get_callback((OSSL_LIB_CTX *)libctx, cb, cbarg);
2105 static size_t rand_get_entropy(const OSSL_CORE_HANDLE *handle,
2106 unsigned char **pout, int entropy,
2107 size_t min_len, size_t max_len)
2109 return ossl_rand_get_entropy((OSSL_LIB_CTX *)core_get_libctx(handle),
2110 pout, entropy, min_len, max_len);
2113 static size_t rand_get_user_entropy(const OSSL_CORE_HANDLE *handle,
2114 unsigned char **pout, int entropy,
2115 size_t min_len, size_t max_len)
2117 return ossl_rand_get_user_entropy((OSSL_LIB_CTX *)core_get_libctx(handle),
2118 pout, entropy, min_len, max_len);
2121 static void rand_cleanup_entropy(const OSSL_CORE_HANDLE *handle,
2122 unsigned char *buf, size_t len)
2124 ossl_rand_cleanup_entropy((OSSL_LIB_CTX *)core_get_libctx(handle),
2128 static void rand_cleanup_user_entropy(const OSSL_CORE_HANDLE *handle,
2129 unsigned char *buf, size_t len)
2131 ossl_rand_cleanup_user_entropy((OSSL_LIB_CTX *)core_get_libctx(handle),
2135 static size_t rand_get_nonce(const OSSL_CORE_HANDLE *handle,
2136 unsigned char **pout,
2137 size_t min_len, size_t max_len,
2138 const void *salt, size_t salt_len)
2140 return ossl_rand_get_nonce((OSSL_LIB_CTX *)core_get_libctx(handle),
2141 pout, min_len, max_len, salt, salt_len);
2144 static size_t rand_get_user_nonce(const OSSL_CORE_HANDLE *handle,
2145 unsigned char **pout,
2146 size_t min_len, size_t max_len,
2147 const void *salt, size_t salt_len)
2149 return ossl_rand_get_user_nonce((OSSL_LIB_CTX *)core_get_libctx(handle),
2150 pout, min_len, max_len, salt, salt_len);
2153 static void rand_cleanup_nonce(const OSSL_CORE_HANDLE *handle,
2154 unsigned char *buf, size_t len)
2156 ossl_rand_cleanup_nonce((OSSL_LIB_CTX *)core_get_libctx(handle),
2160 static void rand_cleanup_user_nonce(const OSSL_CORE_HANDLE *handle,
2161 unsigned char *buf, size_t len)
2163 ossl_rand_cleanup_user_nonce((OSSL_LIB_CTX *)core_get_libctx(handle),
2167 static const char *core_provider_get0_name(const OSSL_CORE_HANDLE *prov)
2169 return OSSL_PROVIDER_get0_name((const OSSL_PROVIDER *)prov);
2172 static void *core_provider_get0_provider_ctx(const OSSL_CORE_HANDLE *prov)
2174 return OSSL_PROVIDER_get0_provider_ctx((const OSSL_PROVIDER *)prov);
2177 static const OSSL_DISPATCH *
2178 core_provider_get0_dispatch(const OSSL_CORE_HANDLE *prov)
2180 return OSSL_PROVIDER_get0_dispatch((const OSSL_PROVIDER *)prov);
2183 static int core_provider_up_ref_intern(const OSSL_CORE_HANDLE *prov,
2186 return provider_up_ref_intern((OSSL_PROVIDER *)prov, activate);
2189 static int core_provider_free_intern(const OSSL_CORE_HANDLE *prov,
2192 return provider_free_intern((OSSL_PROVIDER *)prov, deactivate);
2195 static int core_obj_add_sigid(const OSSL_CORE_HANDLE *prov,
2196 const char *sign_name, const char *digest_name,
2197 const char *pkey_name)
2199 int sign_nid = OBJ_txt2nid(sign_name);
2200 int digest_nid = NID_undef;
2201 int pkey_nid = OBJ_txt2nid(pkey_name);
2203 if (digest_name != NULL && digest_name[0] != '\0'
2204 && (digest_nid = OBJ_txt2nid(digest_name)) == NID_undef)
2207 if (sign_nid == NID_undef)
2211 * Check if it already exists. This is a success if so (even if we don't
2212 * have nids for the digest/pkey)
2214 if (OBJ_find_sigid_algs(sign_nid, NULL, NULL))
2217 if (pkey_nid == NID_undef)
2220 return OBJ_add_sigid(sign_nid, digest_nid, pkey_nid);
2223 static int core_obj_create(const OSSL_CORE_HANDLE *prov, const char *oid,
2224 const char *sn, const char *ln)
2226 /* Check if it already exists and create it if not */
2227 return OBJ_txt2nid(oid) != NID_undef
2228 || OBJ_create(oid, sn, ln) != NID_undef;
2230 #endif /* FIPS_MODULE */
2233 * Functions provided by the core.
2235 static const OSSL_DISPATCH core_dispatch_[] = {
2236 { OSSL_FUNC_CORE_GETTABLE_PARAMS, (void (*)(void))core_gettable_params },
2237 { OSSL_FUNC_CORE_GET_PARAMS, (void (*)(void))core_get_params },
2238 { OSSL_FUNC_CORE_GET_LIBCTX, (void (*)(void))core_get_libctx },
2239 { OSSL_FUNC_CORE_THREAD_START, (void (*)(void))core_thread_start },
2241 { OSSL_FUNC_CORE_NEW_ERROR, (void (*)(void))core_new_error },
2242 { OSSL_FUNC_CORE_SET_ERROR_DEBUG, (void (*)(void))core_set_error_debug },
2243 { OSSL_FUNC_CORE_VSET_ERROR, (void (*)(void))core_vset_error },
2244 { OSSL_FUNC_CORE_SET_ERROR_MARK, (void (*)(void))core_set_error_mark },
2245 { OSSL_FUNC_CORE_CLEAR_LAST_ERROR_MARK,
2246 (void (*)(void))core_clear_last_error_mark },
2247 { OSSL_FUNC_CORE_POP_ERROR_TO_MARK, (void (*)(void))core_pop_error_to_mark },
2248 { OSSL_FUNC_BIO_NEW_FILE, (void (*)(void))ossl_core_bio_new_file },
2249 { OSSL_FUNC_BIO_NEW_MEMBUF, (void (*)(void))ossl_core_bio_new_mem_buf },
2250 { OSSL_FUNC_BIO_READ_EX, (void (*)(void))ossl_core_bio_read_ex },
2251 { OSSL_FUNC_BIO_WRITE_EX, (void (*)(void))ossl_core_bio_write_ex },
2252 { OSSL_FUNC_BIO_GETS, (void (*)(void))ossl_core_bio_gets },
2253 { OSSL_FUNC_BIO_PUTS, (void (*)(void))ossl_core_bio_puts },
2254 { OSSL_FUNC_BIO_CTRL, (void (*)(void))ossl_core_bio_ctrl },
2255 { OSSL_FUNC_BIO_UP_REF, (void (*)(void))ossl_core_bio_up_ref },
2256 { OSSL_FUNC_BIO_FREE, (void (*)(void))ossl_core_bio_free },
2257 { OSSL_FUNC_BIO_VPRINTF, (void (*)(void))ossl_core_bio_vprintf },
2258 { OSSL_FUNC_BIO_VSNPRINTF, (void (*)(void))BIO_vsnprintf },
2259 { OSSL_FUNC_SELF_TEST_CB, (void (*)(void))core_self_test_get_callback },
2260 { OSSL_FUNC_GET_ENTROPY, (void (*)(void))rand_get_entropy },
2261 { OSSL_FUNC_GET_USER_ENTROPY, (void (*)(void))rand_get_user_entropy },
2262 { OSSL_FUNC_CLEANUP_ENTROPY, (void (*)(void))rand_cleanup_entropy },
2263 { OSSL_FUNC_CLEANUP_USER_ENTROPY, (void (*)(void))rand_cleanup_user_entropy },
2264 { OSSL_FUNC_GET_NONCE, (void (*)(void))rand_get_nonce },
2265 { OSSL_FUNC_GET_USER_NONCE, (void (*)(void))rand_get_user_nonce },
2266 { OSSL_FUNC_CLEANUP_NONCE, (void (*)(void))rand_cleanup_nonce },
2267 { OSSL_FUNC_CLEANUP_USER_NONCE, (void (*)(void))rand_cleanup_user_nonce },
2269 { OSSL_FUNC_CRYPTO_MALLOC, (void (*)(void))CRYPTO_malloc },
2270 { OSSL_FUNC_CRYPTO_ZALLOC, (void (*)(void))CRYPTO_zalloc },
2271 { OSSL_FUNC_CRYPTO_FREE, (void (*)(void))CRYPTO_free },
2272 { OSSL_FUNC_CRYPTO_CLEAR_FREE, (void (*)(void))CRYPTO_clear_free },
2273 { OSSL_FUNC_CRYPTO_REALLOC, (void (*)(void))CRYPTO_realloc },
2274 { OSSL_FUNC_CRYPTO_CLEAR_REALLOC, (void (*)(void))CRYPTO_clear_realloc },
2275 { OSSL_FUNC_CRYPTO_SECURE_MALLOC, (void (*)(void))CRYPTO_secure_malloc },
2276 { OSSL_FUNC_CRYPTO_SECURE_ZALLOC, (void (*)(void))CRYPTO_secure_zalloc },
2277 { OSSL_FUNC_CRYPTO_SECURE_FREE, (void (*)(void))CRYPTO_secure_free },
2278 { OSSL_FUNC_CRYPTO_SECURE_CLEAR_FREE,
2279 (void (*)(void))CRYPTO_secure_clear_free },
2280 { OSSL_FUNC_CRYPTO_SECURE_ALLOCATED,
2281 (void (*)(void))CRYPTO_secure_allocated },
2282 { OSSL_FUNC_OPENSSL_CLEANSE, (void (*)(void))OPENSSL_cleanse },
2284 { OSSL_FUNC_PROVIDER_REGISTER_CHILD_CB,
2285 (void (*)(void))ossl_provider_register_child_cb },
2286 { OSSL_FUNC_PROVIDER_DEREGISTER_CHILD_CB,
2287 (void (*)(void))ossl_provider_deregister_child_cb },
2288 { OSSL_FUNC_PROVIDER_NAME,
2289 (void (*)(void))core_provider_get0_name },
2290 { OSSL_FUNC_PROVIDER_GET0_PROVIDER_CTX,
2291 (void (*)(void))core_provider_get0_provider_ctx },
2292 { OSSL_FUNC_PROVIDER_GET0_DISPATCH,
2293 (void (*)(void))core_provider_get0_dispatch },
2294 { OSSL_FUNC_PROVIDER_UP_REF,
2295 (void (*)(void))core_provider_up_ref_intern },
2296 { OSSL_FUNC_PROVIDER_FREE,
2297 (void (*)(void))core_provider_free_intern },
2298 { OSSL_FUNC_CORE_OBJ_ADD_SIGID, (void (*)(void))core_obj_add_sigid },
2299 { OSSL_FUNC_CORE_OBJ_CREATE, (void (*)(void))core_obj_create },
2303 static const OSSL_DISPATCH *core_dispatch = core_dispatch_;