2 * Copyright 2019-2022 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)) {
450 if ((prov
->activatecnt_lock
= CRYPTO_THREAD_lock_new()) == NULL
) {
451 ossl_provider_free(prov
);
452 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_CRYPTO_LIB
);
457 if ((prov
->opbits_lock
= CRYPTO_THREAD_lock_new()) == NULL
458 || (prov
->flag_lock
= CRYPTO_THREAD_lock_new()) == NULL
459 || (prov
->parameters
= sk_INFOPAIR_deep_copy(parameters
,
461 infopair_free
)) == NULL
) {
462 ossl_provider_free(prov
);
463 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_CRYPTO_LIB
);
466 if ((prov
->name
= OPENSSL_strdup(name
)) == NULL
) {
467 ossl_provider_free(prov
);
471 prov
->init_function
= init_function
;
476 int ossl_provider_up_ref(OSSL_PROVIDER
*prov
)
480 if (CRYPTO_UP_REF(&prov
->refcnt
, &ref
) <= 0)
485 if (!ossl_provider_up_ref_parent(prov
, 0)) {
486 ossl_provider_free(prov
);
496 static int provider_up_ref_intern(OSSL_PROVIDER
*prov
, int activate
)
499 return ossl_provider_activate(prov
, 1, 0);
501 return ossl_provider_up_ref(prov
);
504 static int provider_free_intern(OSSL_PROVIDER
*prov
, int deactivate
)
507 return ossl_provider_deactivate(prov
, 1);
509 ossl_provider_free(prov
);
515 * We assume that the requested provider does not already exist in the store.
516 * The caller should check. If it does exist then adding it to the store later
519 OSSL_PROVIDER
*ossl_provider_new(OSSL_LIB_CTX
*libctx
, const char *name
,
520 OSSL_provider_init_fn
*init_function
,
521 OSSL_PARAM
*params
, int noconfig
)
523 struct provider_store_st
*store
= NULL
;
524 OSSL_PROVIDER_INFO
template;
525 OSSL_PROVIDER
*prov
= NULL
;
527 if ((store
= get_provider_store(libctx
)) == NULL
)
530 memset(&template, 0, sizeof(template));
531 if (init_function
== NULL
) {
532 const OSSL_PROVIDER_INFO
*p
;
535 /* Check if this is a predefined builtin provider */
536 for (p
= ossl_predefined_providers
; p
->name
!= NULL
; p
++) {
537 if (strcmp(p
->name
, name
) == 0) {
542 if (p
->name
== NULL
) {
543 /* Check if this is a user added provider */
544 if (!CRYPTO_THREAD_read_lock(store
->lock
))
546 for (i
= 0, p
= store
->provinfo
; i
< store
->numprovinfo
; p
++, i
++) {
547 if (strcmp(p
->name
, name
) == 0) {
552 CRYPTO_THREAD_unlock(store
->lock
);
555 template.init
= init_function
;
558 if (params
!= NULL
) {
561 template.parameters
= sk_INFOPAIR_new_null();
562 if (template.parameters
== NULL
)
565 for (i
= 0; params
[i
].key
!= NULL
; i
++) {
566 if (params
[i
].data_type
!= OSSL_PARAM_UTF8_STRING
)
568 if (ossl_provider_info_add_parameter(&template, params
[i
].key
,
569 (char *)params
[i
].data
) <= 0)
574 /* provider_new() generates an error, so no need here */
575 prov
= provider_new(name
, template.init
, template.parameters
);
577 if (params
!= NULL
) /* We copied the parameters, let's free them */
578 sk_INFOPAIR_pop_free(template.parameters
, infopair_free
);
583 prov
->libctx
= libctx
;
585 prov
->error_lib
= ERR_get_next_error_library();
589 * At this point, the provider is only partially "loaded". To be
590 * fully "loaded", ossl_provider_activate() must also be called and it must
591 * then be added to the provider store.
597 /* Assumes that the store lock is held */
598 static int create_provider_children(OSSL_PROVIDER
*prov
)
602 struct provider_store_st
*store
= prov
->store
;
603 OSSL_PROVIDER_CHILD_CB
*child_cb
;
606 max
= sk_OSSL_PROVIDER_CHILD_CB_num(store
->child_cbs
);
607 for (i
= 0; i
< max
; i
++) {
609 * This is newly activated (activatecnt == 1), so we need to
610 * create child providers as necessary.
612 child_cb
= sk_OSSL_PROVIDER_CHILD_CB_value(store
->child_cbs
, i
);
613 ret
&= child_cb
->create_cb((OSSL_CORE_HANDLE
*)prov
, child_cb
->cbdata
);
620 int ossl_provider_add_to_store(OSSL_PROVIDER
*prov
, OSSL_PROVIDER
**actualprov
,
621 int retain_fallbacks
)
623 struct provider_store_st
*store
;
625 OSSL_PROVIDER tmpl
= { 0, };
626 OSSL_PROVIDER
*actualtmp
= NULL
;
628 if (actualprov
!= NULL
)
631 if ((store
= get_provider_store(prov
->libctx
)) == NULL
)
634 if (!CRYPTO_THREAD_write_lock(store
->lock
))
637 tmpl
.name
= (char *)prov
->name
;
638 idx
= sk_OSSL_PROVIDER_find(store
->providers
, &tmpl
);
642 actualtmp
= sk_OSSL_PROVIDER_value(store
->providers
, idx
);
645 if (sk_OSSL_PROVIDER_push(store
->providers
, prov
) == 0)
648 if (!create_provider_children(prov
)) {
649 sk_OSSL_PROVIDER_delete_ptr(store
->providers
, prov
);
652 if (!retain_fallbacks
)
653 store
->use_fallbacks
= 0;
656 CRYPTO_THREAD_unlock(store
->lock
);
658 if (actualprov
!= NULL
) {
659 if (!ossl_provider_up_ref(actualtmp
)) {
660 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_CRYPTO_LIB
);
664 *actualprov
= actualtmp
;
669 * The provider is already in the store. Probably two threads
670 * independently initialised their own provider objects with the same
671 * name and raced to put them in the store. This thread lost. We
672 * deactivate the one we just created and use the one that already
674 * If we get here then we know we did not create provider children
675 * above, so we inform ossl_provider_deactivate not to attempt to remove
678 ossl_provider_deactivate(prov
, 0);
679 ossl_provider_free(prov
);
684 * This can be done outside the lock. We tolerate other threads getting
685 * the wrong result briefly when creating OSSL_DECODER_CTXs.
687 ossl_decoder_cache_flush(prov
->libctx
);
694 CRYPTO_THREAD_unlock(store
->lock
);
698 void ossl_provider_free(OSSL_PROVIDER
*prov
)
703 CRYPTO_DOWN_REF(&prov
->refcnt
, &ref
);
706 * When the refcount drops to zero, we clean up the provider.
707 * Note that this also does teardown, which may seem late,
708 * considering that init happens on first activation. However,
709 * there may be other structures hanging on to the provider after
710 * the last deactivation and may therefore need full access to the
711 * provider's services. Therefore, we deinit late.
714 if (prov
->flag_initialized
) {
715 ossl_provider_teardown(prov
);
716 #ifndef OPENSSL_NO_ERR
718 if (prov
->error_strings
!= NULL
) {
719 ERR_unload_strings(prov
->error_lib
, prov
->error_strings
);
720 OPENSSL_free(prov
->error_strings
);
721 prov
->error_strings
= NULL
;
725 OPENSSL_free(prov
->operation_bits
);
726 prov
->operation_bits
= NULL
;
727 prov
->operation_bits_sz
= 0;
728 prov
->flag_initialized
= 0;
733 * We deregister thread handling whether or not the provider was
734 * initialized. If init was attempted but was not successful then
735 * the provider may still have registered a thread handler.
737 ossl_init_thread_deregister(prov
);
738 DSO_free(prov
->module
);
740 OPENSSL_free(prov
->name
);
741 OPENSSL_free(prov
->path
);
742 sk_INFOPAIR_pop_free(prov
->parameters
, infopair_free
);
743 CRYPTO_THREAD_lock_free(prov
->opbits_lock
);
744 CRYPTO_THREAD_lock_free(prov
->flag_lock
);
746 CRYPTO_THREAD_lock_free(prov
->activatecnt_lock
);
748 CRYPTO_FREE_REF(&prov
->refcnt
);
752 else if (prov
->ischild
) {
753 ossl_provider_free_parent(prov
, 0);
760 int ossl_provider_set_module_path(OSSL_PROVIDER
*prov
, const char *module_path
)
762 OPENSSL_free(prov
->path
);
764 if (module_path
== NULL
)
766 if ((prov
->path
= OPENSSL_strdup(module_path
)) != NULL
)
771 static int infopair_add(STACK_OF(INFOPAIR
) **infopairsk
, const char *name
,
774 INFOPAIR
*pair
= NULL
;
776 if ((pair
= OPENSSL_zalloc(sizeof(*pair
))) == NULL
777 || (pair
->name
= OPENSSL_strdup(name
)) == NULL
778 || (pair
->value
= OPENSSL_strdup(value
)) == NULL
)
781 if ((*infopairsk
== NULL
782 && (*infopairsk
= sk_INFOPAIR_new_null()) == NULL
)
783 || sk_INFOPAIR_push(*infopairsk
, pair
) <= 0) {
784 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_CRYPTO_LIB
);
792 OPENSSL_free(pair
->name
);
793 OPENSSL_free(pair
->value
);
799 int ossl_provider_add_parameter(OSSL_PROVIDER
*prov
,
800 const char *name
, const char *value
)
802 return infopair_add(&prov
->parameters
, name
, value
);
805 int ossl_provider_info_add_parameter(OSSL_PROVIDER_INFO
*provinfo
,
809 return infopair_add(&provinfo
->parameters
, name
, value
);
813 * Provider activation.
815 * What "activation" means depends on the provider form; for built in
816 * providers (in the library or the application alike), the provider
817 * can already be considered to be loaded, all that's needed is to
818 * initialize it. However, for dynamically loadable provider modules,
819 * we must first load that module.
821 * Built in modules are distinguished from dynamically loaded modules
822 * with an already assigned init function.
824 static const OSSL_DISPATCH
*core_dispatch
; /* Define further down */
826 int OSSL_PROVIDER_set_default_search_path(OSSL_LIB_CTX
*libctx
,
829 struct provider_store_st
*store
;
833 p
= OPENSSL_strdup(path
);
837 if ((store
= get_provider_store(libctx
)) != NULL
838 && CRYPTO_THREAD_write_lock(store
->default_path_lock
)) {
839 OPENSSL_free(store
->default_path
);
840 store
->default_path
= p
;
841 CRYPTO_THREAD_unlock(store
->default_path_lock
);
848 const char *OSSL_PROVIDER_get0_default_search_path(OSSL_LIB_CTX
*libctx
)
850 struct provider_store_st
*store
;
853 if ((store
= get_provider_store(libctx
)) != NULL
854 && CRYPTO_THREAD_read_lock(store
->default_path_lock
)) {
855 path
= store
->default_path
;
856 CRYPTO_THREAD_unlock(store
->default_path_lock
);
862 * Internal version that doesn't affect the store flags, and thereby avoid
863 * locking. Direct callers must remember to set the store flags when
866 static int provider_init(OSSL_PROVIDER
*prov
)
868 const OSSL_DISPATCH
*provider_dispatch
= NULL
;
869 void *tmp_provctx
= NULL
; /* safety measure */
870 #ifndef OPENSSL_NO_ERR
872 OSSL_FUNC_provider_get_reason_strings_fn
*p_get_reason_strings
= NULL
;
877 if (!ossl_assert(!prov
->flag_initialized
)) {
878 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_INTERNAL_ERROR
);
883 * If the init function isn't set, it indicates that this provider is
886 if (prov
->init_function
== NULL
) {
890 if (prov
->module
== NULL
) {
891 char *allocated_path
= NULL
;
892 const char *module_path
= NULL
;
893 char *merged_path
= NULL
;
894 const char *load_dir
= NULL
;
895 char *allocated_load_dir
= NULL
;
896 struct provider_store_st
*store
;
898 if ((prov
->module
= DSO_new()) == NULL
) {
899 /* DSO_new() generates an error already */
903 if ((store
= get_provider_store(prov
->libctx
)) == NULL
904 || !CRYPTO_THREAD_read_lock(store
->default_path_lock
))
907 if (store
->default_path
!= NULL
) {
908 allocated_load_dir
= OPENSSL_strdup(store
->default_path
);
909 CRYPTO_THREAD_unlock(store
->default_path_lock
);
910 if (allocated_load_dir
== NULL
)
912 load_dir
= allocated_load_dir
;
914 CRYPTO_THREAD_unlock(store
->default_path_lock
);
917 if (load_dir
== NULL
) {
918 load_dir
= ossl_safe_getenv("OPENSSL_MODULES");
919 if (load_dir
== NULL
)
920 load_dir
= MODULESDIR
;
923 DSO_ctrl(prov
->module
, DSO_CTRL_SET_FLAGS
,
924 DSO_FLAG_NAME_TRANSLATION_EXT_ONLY
, NULL
);
926 module_path
= prov
->path
;
927 if (module_path
== NULL
)
928 module_path
= allocated_path
=
929 DSO_convert_filename(prov
->module
, prov
->name
);
930 if (module_path
!= NULL
)
931 merged_path
= DSO_merge(prov
->module
, module_path
, load_dir
);
933 if (merged_path
== NULL
934 || (DSO_load(prov
->module
, merged_path
, NULL
, 0)) == NULL
) {
935 DSO_free(prov
->module
);
939 OPENSSL_free(merged_path
);
940 OPENSSL_free(allocated_path
);
941 OPENSSL_free(allocated_load_dir
);
944 if (prov
->module
== NULL
) {
945 /* DSO has already recorded errors, this is just a tracepoint */
946 ERR_raise_data(ERR_LIB_CRYPTO
, ERR_R_DSO_LIB
,
947 "name=%s", prov
->name
);
951 prov
->init_function
= (OSSL_provider_init_fn
*)
952 DSO_bind_func(prov
->module
, "OSSL_provider_init");
956 /* Check for and call the initialise function for the provider. */
957 if (prov
->init_function
== NULL
) {
958 ERR_raise_data(ERR_LIB_CRYPTO
, ERR_R_UNSUPPORTED
,
959 "name=%s, provider has no provider init function",
964 if (!prov
->init_function((OSSL_CORE_HANDLE
*)prov
, core_dispatch
,
965 &provider_dispatch
, &tmp_provctx
)) {
966 ERR_raise_data(ERR_LIB_CRYPTO
, ERR_R_INIT_FAIL
,
967 "name=%s", prov
->name
);
970 prov
->provctx
= tmp_provctx
;
971 prov
->dispatch
= provider_dispatch
;
973 for (; provider_dispatch
->function_id
!= 0; provider_dispatch
++) {
974 switch (provider_dispatch
->function_id
) {
975 case OSSL_FUNC_PROVIDER_TEARDOWN
:
977 OSSL_FUNC_provider_teardown(provider_dispatch
);
979 case OSSL_FUNC_PROVIDER_GETTABLE_PARAMS
:
980 prov
->gettable_params
=
981 OSSL_FUNC_provider_gettable_params(provider_dispatch
);
983 case OSSL_FUNC_PROVIDER_GET_PARAMS
:
985 OSSL_FUNC_provider_get_params(provider_dispatch
);
987 case OSSL_FUNC_PROVIDER_SELF_TEST
:
989 OSSL_FUNC_provider_self_test(provider_dispatch
);
991 case OSSL_FUNC_PROVIDER_GET_CAPABILITIES
:
992 prov
->get_capabilities
=
993 OSSL_FUNC_provider_get_capabilities(provider_dispatch
);
995 case OSSL_FUNC_PROVIDER_QUERY_OPERATION
:
996 prov
->query_operation
=
997 OSSL_FUNC_provider_query_operation(provider_dispatch
);
999 case OSSL_FUNC_PROVIDER_UNQUERY_OPERATION
:
1000 prov
->unquery_operation
=
1001 OSSL_FUNC_provider_unquery_operation(provider_dispatch
);
1003 #ifndef OPENSSL_NO_ERR
1004 # ifndef FIPS_MODULE
1005 case OSSL_FUNC_PROVIDER_GET_REASON_STRINGS
:
1006 p_get_reason_strings
=
1007 OSSL_FUNC_provider_get_reason_strings(provider_dispatch
);
1014 #ifndef OPENSSL_NO_ERR
1015 # ifndef FIPS_MODULE
1016 if (p_get_reason_strings
!= NULL
) {
1017 const OSSL_ITEM
*reasonstrings
= p_get_reason_strings(prov
->provctx
);
1021 * ERR_load_strings() handles ERR_STRING_DATA rather than OSSL_ITEM,
1022 * although they are essentially the same type.
1023 * Furthermore, ERR_load_strings() patches the array's error number
1024 * with the error library number, so we need to make a copy of that
1028 while (reasonstrings
[cnt
].id
!= 0) {
1029 if (ERR_GET_LIB(reasonstrings
[cnt
].id
) != 0)
1033 cnt
++; /* One for the terminating item */
1035 /* Allocate one extra item for the "library" name */
1036 prov
->error_strings
=
1037 OPENSSL_zalloc(sizeof(ERR_STRING_DATA
) * (cnt
+ 1));
1038 if (prov
->error_strings
== NULL
)
1042 * Set the "library" name.
1044 prov
->error_strings
[0].error
= ERR_PACK(prov
->error_lib
, 0, 0);
1045 prov
->error_strings
[0].string
= prov
->name
;
1047 * Copy reasonstrings item 0..cnt-1 to prov->error_trings positions
1050 for (cnt2
= 1; cnt2
<= cnt
; cnt2
++) {
1051 prov
->error_strings
[cnt2
].error
= (int)reasonstrings
[cnt2
-1].id
;
1052 prov
->error_strings
[cnt2
].string
= reasonstrings
[cnt2
-1].ptr
;
1055 ERR_load_strings(prov
->error_lib
, prov
->error_strings
);
1060 /* With this flag set, this provider has become fully "loaded". */
1061 prov
->flag_initialized
= 1;
1069 * Deactivate a provider. If upcalls is 0 then we suppress any upcalls to a
1070 * parent provider. If removechildren is 0 then we suppress any calls to remove
1072 * Return -1 on failure and the activation count on success
1074 static int provider_deactivate(OSSL_PROVIDER
*prov
, int upcalls
,
1078 struct provider_store_st
*store
;
1084 if (!ossl_assert(prov
!= NULL
))
1088 * No need to lock if we've got no store because we've not been shared with
1091 store
= get_provider_store(prov
->libctx
);
1095 if (lock
&& !CRYPTO_THREAD_read_lock(store
->lock
))
1097 if (lock
&& !CRYPTO_THREAD_write_lock(prov
->flag_lock
)) {
1098 CRYPTO_THREAD_unlock(store
->lock
);
1102 CRYPTO_atomic_add(&prov
->activatecnt
, -1, &count
, prov
->activatecnt_lock
);
1104 if (count
>= 1 && prov
->ischild
&& upcalls
) {
1106 * We have had a direct activation in this child libctx so we need to
1107 * now down the ref count in the parent provider. We do the actual down
1108 * ref outside of the flag_lock, since it could involve getting other
1116 prov
->flag_activated
= 0;
1123 if (removechildren
&& store
!= NULL
) {
1124 int i
, max
= sk_OSSL_PROVIDER_CHILD_CB_num(store
->child_cbs
);
1125 OSSL_PROVIDER_CHILD_CB
*child_cb
;
1127 for (i
= 0; i
< max
; i
++) {
1128 child_cb
= sk_OSSL_PROVIDER_CHILD_CB_value(store
->child_cbs
, i
);
1129 child_cb
->remove_cb((OSSL_CORE_HANDLE
*)prov
, child_cb
->cbdata
);
1134 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1135 CRYPTO_THREAD_unlock(store
->lock
);
1137 * This can be done outside the lock. We tolerate other threads getting
1138 * the wrong result briefly when creating OSSL_DECODER_CTXs.
1142 ossl_decoder_cache_flush(prov
->libctx
);
1147 ossl_provider_free_parent(prov
, 1);
1150 /* We don't deinit here, that's done in ossl_provider_free() */
1155 * Activate a provider.
1156 * Return -1 on failure and the activation count on success
1158 static int provider_activate(OSSL_PROVIDER
*prov
, int lock
, int upcalls
)
1161 struct provider_store_st
*store
;
1164 store
= prov
->store
;
1166 * If the provider hasn't been added to the store, then we don't need
1167 * any locks because we've not shared it with other threads.
1169 if (store
== NULL
) {
1171 if (!provider_init(prov
))
1176 if (prov
->ischild
&& upcalls
&& !ossl_provider_up_ref_parent(prov
, 1))
1180 if (lock
&& !CRYPTO_THREAD_read_lock(store
->lock
)) {
1182 if (prov
->ischild
&& upcalls
)
1183 ossl_provider_free_parent(prov
, 1);
1188 if (lock
&& !CRYPTO_THREAD_write_lock(prov
->flag_lock
)) {
1189 CRYPTO_THREAD_unlock(store
->lock
);
1191 if (prov
->ischild
&& upcalls
)
1192 ossl_provider_free_parent(prov
, 1);
1196 if (CRYPTO_atomic_add(&prov
->activatecnt
, 1, &count
, prov
->activatecnt_lock
)) {
1197 prov
->flag_activated
= 1;
1199 if (count
== 1 && store
!= NULL
) {
1200 ret
= create_provider_children(prov
);
1204 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1205 CRYPTO_THREAD_unlock(store
->lock
);
1207 * This can be done outside the lock. We tolerate other threads getting
1208 * the wrong result briefly when creating OSSL_DECODER_CTXs.
1212 ossl_decoder_cache_flush(prov
->libctx
);
1222 static int provider_flush_store_cache(const OSSL_PROVIDER
*prov
)
1224 struct provider_store_st
*store
;
1227 if ((store
= get_provider_store(prov
->libctx
)) == NULL
)
1230 if (!CRYPTO_THREAD_read_lock(store
->lock
))
1232 freeing
= store
->freeing
;
1233 CRYPTO_THREAD_unlock(store
->lock
);
1237 = evp_method_store_cache_flush(prov
->libctx
)
1239 + ossl_encoder_store_cache_flush(prov
->libctx
)
1240 + ossl_decoder_store_cache_flush(prov
->libctx
)
1241 + ossl_store_loader_store_cache_flush(prov
->libctx
)
1254 static int provider_remove_store_methods(OSSL_PROVIDER
*prov
)
1256 struct provider_store_st
*store
;
1259 if ((store
= get_provider_store(prov
->libctx
)) == NULL
)
1262 if (!CRYPTO_THREAD_read_lock(store
->lock
))
1264 freeing
= store
->freeing
;
1265 CRYPTO_THREAD_unlock(store
->lock
);
1270 if (!CRYPTO_THREAD_write_lock(prov
->opbits_lock
))
1272 OPENSSL_free(prov
->operation_bits
);
1273 prov
->operation_bits
= NULL
;
1274 prov
->operation_bits_sz
= 0;
1275 CRYPTO_THREAD_unlock(prov
->opbits_lock
);
1277 acc
= evp_method_store_remove_all_provided(prov
)
1279 + ossl_encoder_store_remove_all_provided(prov
)
1280 + ossl_decoder_store_remove_all_provided(prov
)
1281 + ossl_store_loader_store_remove_all_provided(prov
)
1294 int ossl_provider_activate(OSSL_PROVIDER
*prov
, int upcalls
, int aschild
)
1302 * If aschild is true, then we only actually do the activation if the
1303 * provider is a child. If its not, this is still success.
1305 if (aschild
&& !prov
->ischild
)
1308 if ((count
= provider_activate(prov
, 1, upcalls
)) > 0)
1309 return count
== 1 ? provider_flush_store_cache(prov
) : 1;
1314 int ossl_provider_deactivate(OSSL_PROVIDER
*prov
, int removechildren
)
1319 || (count
= provider_deactivate(prov
, 1, removechildren
)) < 0)
1321 return count
== 0 ? provider_remove_store_methods(prov
) : 1;
1324 void *ossl_provider_ctx(const OSSL_PROVIDER
*prov
)
1326 return prov
!= NULL
? prov
->provctx
: NULL
;
1330 * This function only does something once when store->use_fallbacks == 1,
1331 * and then sets store->use_fallbacks = 0, so the second call and so on is
1332 * effectively a no-op.
1334 static int provider_activate_fallbacks(struct provider_store_st
*store
)
1337 int activated_fallback_count
= 0;
1339 const OSSL_PROVIDER_INFO
*p
;
1341 if (!CRYPTO_THREAD_read_lock(store
->lock
))
1343 use_fallbacks
= store
->use_fallbacks
;
1344 CRYPTO_THREAD_unlock(store
->lock
);
1348 if (!CRYPTO_THREAD_write_lock(store
->lock
))
1350 /* Check again, just in case another thread changed it */
1351 use_fallbacks
= store
->use_fallbacks
;
1352 if (!use_fallbacks
) {
1353 CRYPTO_THREAD_unlock(store
->lock
);
1357 for (p
= ossl_predefined_providers
; p
->name
!= NULL
; p
++) {
1358 OSSL_PROVIDER
*prov
= NULL
;
1360 if (!p
->is_fallback
)
1363 * We use the internal constructor directly here,
1364 * otherwise we get a call loop
1366 prov
= provider_new(p
->name
, p
->init
, NULL
);
1369 prov
->libctx
= store
->libctx
;
1371 prov
->error_lib
= ERR_get_next_error_library();
1375 * We are calling provider_activate while holding the store lock. This
1376 * means the init function will be called while holding a lock. Normally
1377 * we try to avoid calling a user callback while holding a lock.
1378 * However, fallbacks are never third party providers so we accept this.
1380 if (provider_activate(prov
, 0, 0) < 0) {
1381 ossl_provider_free(prov
);
1384 prov
->store
= store
;
1385 if (sk_OSSL_PROVIDER_push(store
->providers
, prov
) == 0) {
1386 ossl_provider_free(prov
);
1389 activated_fallback_count
++;
1392 if (activated_fallback_count
> 0) {
1393 store
->use_fallbacks
= 0;
1397 CRYPTO_THREAD_unlock(store
->lock
);
1401 int ossl_provider_doall_activated(OSSL_LIB_CTX
*ctx
,
1402 int (*cb
)(OSSL_PROVIDER
*provider
,
1406 int ret
= 0, curr
, max
, ref
= 0;
1407 struct provider_store_st
*store
= get_provider_store(ctx
);
1408 STACK_OF(OSSL_PROVIDER
) *provs
= NULL
;
1410 #if !defined(FIPS_MODULE) && !defined(OPENSSL_NO_AUTOLOAD_CONFIG)
1412 * Make sure any providers are loaded from config before we try to use
1415 if (ossl_lib_ctx_is_default(ctx
))
1416 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG
, NULL
);
1421 if (!provider_activate_fallbacks(store
))
1425 * Under lock, grab a copy of the provider list and up_ref each
1426 * provider so that they don't disappear underneath us.
1428 if (!CRYPTO_THREAD_read_lock(store
->lock
))
1430 provs
= sk_OSSL_PROVIDER_dup(store
->providers
);
1431 if (provs
== NULL
) {
1432 CRYPTO_THREAD_unlock(store
->lock
);
1435 max
= sk_OSSL_PROVIDER_num(provs
);
1437 * We work backwards through the stack so that we can safely delete items
1440 for (curr
= max
- 1; curr
>= 0; curr
--) {
1441 OSSL_PROVIDER
*prov
= sk_OSSL_PROVIDER_value(provs
, curr
);
1443 if (!CRYPTO_THREAD_read_lock(prov
->flag_lock
))
1445 if (prov
->flag_activated
) {
1447 * We call CRYPTO_UP_REF directly rather than ossl_provider_up_ref
1448 * to avoid upping the ref count on the parent provider, which we
1449 * must not do while holding locks.
1451 if (CRYPTO_UP_REF(&prov
->refcnt
, &ref
) <= 0) {
1452 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1456 * It's already activated, but we up the activated count to ensure
1457 * it remains activated until after we've called the user callback.
1458 * In theory this could mean the parent provider goes inactive,
1459 * whilst still activated in the child for a short period. That's ok.
1461 if (!CRYPTO_atomic_add(&prov
->activatecnt
, 1, &ref
,
1462 prov
->activatecnt_lock
)) {
1463 CRYPTO_DOWN_REF(&prov
->refcnt
, &ref
);
1464 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1468 sk_OSSL_PROVIDER_delete(provs
, curr
);
1471 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1473 CRYPTO_THREAD_unlock(store
->lock
);
1476 * Now, we sweep through all providers not under lock
1478 for (curr
= 0; curr
< max
; curr
++) {
1479 OSSL_PROVIDER
*prov
= sk_OSSL_PROVIDER_value(provs
, curr
);
1481 if (!cb(prov
, cbdata
)) {
1492 CRYPTO_THREAD_unlock(store
->lock
);
1495 * The pop_free call doesn't do what we want on an error condition. We
1496 * either start from the first item in the stack, or part way through if
1497 * we only processed some of the items.
1499 for (curr
++; curr
< max
; curr
++) {
1500 OSSL_PROVIDER
*prov
= sk_OSSL_PROVIDER_value(provs
, curr
);
1502 if (!CRYPTO_atomic_add(&prov
->activatecnt
, -1, &ref
,
1503 prov
->activatecnt_lock
)) {
1509 * Looks like we need to deactivate properly. We could just have
1510 * done this originally, but it involves taking a write lock so
1511 * we avoid it. We up the count again and do a full deactivation
1513 if (CRYPTO_atomic_add(&prov
->activatecnt
, 1, &ref
,
1514 prov
->activatecnt_lock
))
1515 provider_deactivate(prov
, 0, 1);
1520 * As above where we did the up-ref, we don't call ossl_provider_free
1521 * to avoid making upcalls. There should always be at least one ref
1522 * to the provider in the store, so this should never drop to 0.
1524 if (!CRYPTO_DOWN_REF(&prov
->refcnt
, &ref
)) {
1529 * Not much we can do if this assert ever fails. So we don't use
1534 sk_OSSL_PROVIDER_free(provs
);
1538 int OSSL_PROVIDER_available(OSSL_LIB_CTX
*libctx
, const char *name
)
1540 OSSL_PROVIDER
*prov
= NULL
;
1542 struct provider_store_st
*store
= get_provider_store(libctx
);
1544 if (store
== NULL
|| !provider_activate_fallbacks(store
))
1547 prov
= ossl_provider_find(libctx
, name
, 0);
1549 if (!CRYPTO_THREAD_read_lock(prov
->flag_lock
))
1551 available
= prov
->flag_activated
;
1552 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1553 ossl_provider_free(prov
);
1558 /* Getters of Provider Object data */
1559 const char *ossl_provider_name(const OSSL_PROVIDER
*prov
)
1564 const DSO
*ossl_provider_dso(const OSSL_PROVIDER
*prov
)
1566 return prov
->module
;
1569 const char *ossl_provider_module_name(const OSSL_PROVIDER
*prov
)
1574 return DSO_get_filename(prov
->module
);
1578 const char *ossl_provider_module_path(const OSSL_PROVIDER
*prov
)
1583 /* FIXME: Ensure it's a full path */
1584 return DSO_get_filename(prov
->module
);
1588 void *ossl_provider_prov_ctx(const OSSL_PROVIDER
*prov
)
1591 return prov
->provctx
;
1596 const OSSL_DISPATCH
*ossl_provider_get0_dispatch(const OSSL_PROVIDER
*prov
)
1599 return prov
->dispatch
;
1604 OSSL_LIB_CTX
*ossl_provider_libctx(const OSSL_PROVIDER
*prov
)
1606 return prov
!= NULL
? prov
->libctx
: NULL
;
1609 /* Wrappers around calls to the provider */
1610 void ossl_provider_teardown(const OSSL_PROVIDER
*prov
)
1612 if (prov
->teardown
!= NULL
1617 prov
->teardown(prov
->provctx
);
1620 const OSSL_PARAM
*ossl_provider_gettable_params(const OSSL_PROVIDER
*prov
)
1622 return prov
->gettable_params
== NULL
1623 ? NULL
: prov
->gettable_params(prov
->provctx
);
1626 int ossl_provider_get_params(const OSSL_PROVIDER
*prov
, OSSL_PARAM params
[])
1628 return prov
->get_params
== NULL
1629 ? 0 : prov
->get_params(prov
->provctx
, params
);
1632 int ossl_provider_self_test(const OSSL_PROVIDER
*prov
)
1636 if (prov
->self_test
== NULL
)
1638 ret
= prov
->self_test(prov
->provctx
);
1640 (void)provider_remove_store_methods((OSSL_PROVIDER
*)prov
);
1644 int ossl_provider_get_capabilities(const OSSL_PROVIDER
*prov
,
1645 const char *capability
,
1649 return prov
->get_capabilities
== NULL
1650 ? 1 : prov
->get_capabilities(prov
->provctx
, capability
, cb
, arg
);
1653 const OSSL_ALGORITHM
*ossl_provider_query_operation(const OSSL_PROVIDER
*prov
,
1657 const OSSL_ALGORITHM
*res
;
1659 if (prov
->query_operation
== NULL
)
1661 res
= prov
->query_operation(prov
->provctx
, operation_id
, no_cache
);
1662 #if defined(OPENSSL_NO_CACHED_FETCH)
1663 /* Forcing the non-caching of queries */
1664 if (no_cache
!= NULL
)
1670 void ossl_provider_unquery_operation(const OSSL_PROVIDER
*prov
,
1672 const OSSL_ALGORITHM
*algs
)
1674 if (prov
->unquery_operation
!= NULL
)
1675 prov
->unquery_operation(prov
->provctx
, operation_id
, algs
);
1678 int ossl_provider_set_operation_bit(OSSL_PROVIDER
*provider
, size_t bitnum
)
1680 size_t byte
= bitnum
/ 8;
1681 unsigned char bit
= (1 << (bitnum
% 8)) & 0xFF;
1683 if (!CRYPTO_THREAD_write_lock(provider
->opbits_lock
))
1685 if (provider
->operation_bits_sz
<= byte
) {
1686 unsigned char *tmp
= OPENSSL_realloc(provider
->operation_bits
,
1690 CRYPTO_THREAD_unlock(provider
->opbits_lock
);
1693 provider
->operation_bits
= tmp
;
1694 memset(provider
->operation_bits
+ provider
->operation_bits_sz
,
1695 '\0', byte
+ 1 - provider
->operation_bits_sz
);
1696 provider
->operation_bits_sz
= byte
+ 1;
1698 provider
->operation_bits
[byte
] |= bit
;
1699 CRYPTO_THREAD_unlock(provider
->opbits_lock
);
1703 int ossl_provider_test_operation_bit(OSSL_PROVIDER
*provider
, size_t bitnum
,
1706 size_t byte
= bitnum
/ 8;
1707 unsigned char bit
= (1 << (bitnum
% 8)) & 0xFF;
1709 if (!ossl_assert(result
!= NULL
)) {
1710 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_PASSED_NULL_PARAMETER
);
1715 if (!CRYPTO_THREAD_read_lock(provider
->opbits_lock
))
1717 if (provider
->operation_bits_sz
> byte
)
1718 *result
= ((provider
->operation_bits
[byte
] & bit
) != 0);
1719 CRYPTO_THREAD_unlock(provider
->opbits_lock
);
1724 const OSSL_CORE_HANDLE
*ossl_provider_get_parent(OSSL_PROVIDER
*prov
)
1726 return prov
->handle
;
1729 int ossl_provider_is_child(const OSSL_PROVIDER
*prov
)
1731 return prov
->ischild
;
1734 int ossl_provider_set_child(OSSL_PROVIDER
*prov
, const OSSL_CORE_HANDLE
*handle
)
1736 prov
->handle
= handle
;
1742 int ossl_provider_default_props_update(OSSL_LIB_CTX
*libctx
, const char *props
)
1745 struct provider_store_st
*store
= NULL
;
1747 OSSL_PROVIDER_CHILD_CB
*child_cb
;
1749 if ((store
= get_provider_store(libctx
)) == NULL
)
1752 if (!CRYPTO_THREAD_read_lock(store
->lock
))
1755 max
= sk_OSSL_PROVIDER_CHILD_CB_num(store
->child_cbs
);
1756 for (i
= 0; i
< max
; i
++) {
1757 child_cb
= sk_OSSL_PROVIDER_CHILD_CB_value(store
->child_cbs
, i
);
1758 child_cb
->global_props_cb(props
, child_cb
->cbdata
);
1761 CRYPTO_THREAD_unlock(store
->lock
);
1766 static int ossl_provider_register_child_cb(const OSSL_CORE_HANDLE
*handle
,
1768 const OSSL_CORE_HANDLE
*provider
,
1771 const OSSL_CORE_HANDLE
*provider
,
1773 int (*global_props_cb
)(
1779 * This is really an OSSL_PROVIDER that we created and cast to
1780 * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1782 OSSL_PROVIDER
*thisprov
= (OSSL_PROVIDER
*)handle
;
1783 OSSL_PROVIDER
*prov
;
1784 OSSL_LIB_CTX
*libctx
= thisprov
->libctx
;
1785 struct provider_store_st
*store
= NULL
;
1786 int ret
= 0, i
, max
;
1787 OSSL_PROVIDER_CHILD_CB
*child_cb
;
1788 char *propsstr
= NULL
;
1790 if ((store
= get_provider_store(libctx
)) == NULL
)
1793 child_cb
= OPENSSL_malloc(sizeof(*child_cb
));
1794 if (child_cb
== NULL
)
1796 child_cb
->prov
= thisprov
;
1797 child_cb
->create_cb
= create_cb
;
1798 child_cb
->remove_cb
= remove_cb
;
1799 child_cb
->global_props_cb
= global_props_cb
;
1800 child_cb
->cbdata
= cbdata
;
1802 if (!CRYPTO_THREAD_write_lock(store
->lock
)) {
1803 OPENSSL_free(child_cb
);
1806 propsstr
= evp_get_global_properties_str(libctx
, 0);
1808 if (propsstr
!= NULL
) {
1809 global_props_cb(propsstr
, cbdata
);
1810 OPENSSL_free(propsstr
);
1812 max
= sk_OSSL_PROVIDER_num(store
->providers
);
1813 for (i
= 0; i
< max
; i
++) {
1816 prov
= sk_OSSL_PROVIDER_value(store
->providers
, i
);
1818 if (!CRYPTO_THREAD_read_lock(prov
->flag_lock
))
1820 activated
= prov
->flag_activated
;
1821 CRYPTO_THREAD_unlock(prov
->flag_lock
);
1823 * We hold the store lock while calling the user callback. This means
1824 * that the user callback must be short and simple and not do anything
1825 * likely to cause a deadlock. We don't hold the flag_lock during this
1826 * call. In theory this means that another thread could deactivate it
1827 * while we are calling create. This is ok because the other thread
1828 * will also call remove_cb, but won't be able to do so until we release
1831 if (activated
&& !create_cb((OSSL_CORE_HANDLE
*)prov
, cbdata
))
1836 ret
= sk_OSSL_PROVIDER_CHILD_CB_push(store
->child_cbs
, child_cb
);
1838 if (i
!= max
|| ret
<= 0) {
1839 /* Failed during creation. Remove everything we just added */
1840 for (; i
>= 0; i
--) {
1841 prov
= sk_OSSL_PROVIDER_value(store
->providers
, i
);
1842 remove_cb((OSSL_CORE_HANDLE
*)prov
, cbdata
);
1844 OPENSSL_free(child_cb
);
1847 CRYPTO_THREAD_unlock(store
->lock
);
1852 static void ossl_provider_deregister_child_cb(const OSSL_CORE_HANDLE
*handle
)
1855 * This is really an OSSL_PROVIDER that we created and cast to
1856 * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1858 OSSL_PROVIDER
*thisprov
= (OSSL_PROVIDER
*)handle
;
1859 OSSL_LIB_CTX
*libctx
= thisprov
->libctx
;
1860 struct provider_store_st
*store
= NULL
;
1862 OSSL_PROVIDER_CHILD_CB
*child_cb
;
1864 if ((store
= get_provider_store(libctx
)) == NULL
)
1867 if (!CRYPTO_THREAD_write_lock(store
->lock
))
1869 max
= sk_OSSL_PROVIDER_CHILD_CB_num(store
->child_cbs
);
1870 for (i
= 0; i
< max
; i
++) {
1871 child_cb
= sk_OSSL_PROVIDER_CHILD_CB_value(store
->child_cbs
, i
);
1872 if (child_cb
->prov
== thisprov
) {
1873 /* Found an entry */
1874 sk_OSSL_PROVIDER_CHILD_CB_delete(store
->child_cbs
, i
);
1875 OPENSSL_free(child_cb
);
1879 CRYPTO_THREAD_unlock(store
->lock
);
1884 * Core functions for the provider
1885 * ===============================
1887 * This is the set of functions that the core makes available to the provider
1891 * This returns a list of Provider Object parameters with their types, for
1892 * discovery. We do not expect that many providers will use this, but one
1895 static const OSSL_PARAM param_types
[] = {
1896 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_VERSION
, OSSL_PARAM_UTF8_PTR
, NULL
, 0),
1897 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_PROV_NAME
, OSSL_PARAM_UTF8_PTR
,
1900 OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_MODULE_FILENAME
, OSSL_PARAM_UTF8_PTR
,
1907 * Forward declare all the functions that are provided aa dispatch.
1908 * This ensures that the compiler will complain if they aren't defined
1909 * with the correct signature.
1911 static OSSL_FUNC_core_gettable_params_fn core_gettable_params
;
1912 static OSSL_FUNC_core_get_params_fn core_get_params
;
1913 static OSSL_FUNC_core_get_libctx_fn core_get_libctx
;
1914 static OSSL_FUNC_core_thread_start_fn core_thread_start
;
1916 static OSSL_FUNC_core_new_error_fn core_new_error
;
1917 static OSSL_FUNC_core_set_error_debug_fn core_set_error_debug
;
1918 static OSSL_FUNC_core_vset_error_fn core_vset_error
;
1919 static OSSL_FUNC_core_set_error_mark_fn core_set_error_mark
;
1920 static OSSL_FUNC_core_clear_last_error_mark_fn core_clear_last_error_mark
;
1921 static OSSL_FUNC_core_pop_error_to_mark_fn core_pop_error_to_mark
;
1922 OSSL_FUNC_BIO_new_file_fn ossl_core_bio_new_file
;
1923 OSSL_FUNC_BIO_new_membuf_fn ossl_core_bio_new_mem_buf
;
1924 OSSL_FUNC_BIO_read_ex_fn ossl_core_bio_read_ex
;
1925 OSSL_FUNC_BIO_write_ex_fn ossl_core_bio_write_ex
;
1926 OSSL_FUNC_BIO_gets_fn ossl_core_bio_gets
;
1927 OSSL_FUNC_BIO_puts_fn ossl_core_bio_puts
;
1928 OSSL_FUNC_BIO_up_ref_fn ossl_core_bio_up_ref
;
1929 OSSL_FUNC_BIO_free_fn ossl_core_bio_free
;
1930 OSSL_FUNC_BIO_vprintf_fn ossl_core_bio_vprintf
;
1931 OSSL_FUNC_BIO_vsnprintf_fn BIO_vsnprintf
;
1932 static OSSL_FUNC_self_test_cb_fn core_self_test_get_callback
;
1933 OSSL_FUNC_get_entropy_fn ossl_rand_get_entropy
;
1934 OSSL_FUNC_cleanup_entropy_fn ossl_rand_cleanup_entropy
;
1935 OSSL_FUNC_get_nonce_fn ossl_rand_get_nonce
;
1936 OSSL_FUNC_cleanup_nonce_fn ossl_rand_cleanup_nonce
;
1938 OSSL_FUNC_CRYPTO_malloc_fn CRYPTO_malloc
;
1939 OSSL_FUNC_CRYPTO_zalloc_fn CRYPTO_zalloc
;
1940 OSSL_FUNC_CRYPTO_free_fn CRYPTO_free
;
1941 OSSL_FUNC_CRYPTO_clear_free_fn CRYPTO_clear_free
;
1942 OSSL_FUNC_CRYPTO_realloc_fn CRYPTO_realloc
;
1943 OSSL_FUNC_CRYPTO_clear_realloc_fn CRYPTO_clear_realloc
;
1944 OSSL_FUNC_CRYPTO_secure_malloc_fn CRYPTO_secure_malloc
;
1945 OSSL_FUNC_CRYPTO_secure_zalloc_fn CRYPTO_secure_zalloc
;
1946 OSSL_FUNC_CRYPTO_secure_free_fn CRYPTO_secure_free
;
1947 OSSL_FUNC_CRYPTO_secure_clear_free_fn CRYPTO_secure_clear_free
;
1948 OSSL_FUNC_CRYPTO_secure_allocated_fn CRYPTO_secure_allocated
;
1949 OSSL_FUNC_OPENSSL_cleanse_fn OPENSSL_cleanse
;
1951 OSSL_FUNC_provider_register_child_cb_fn ossl_provider_register_child_cb
;
1952 OSSL_FUNC_provider_deregister_child_cb_fn ossl_provider_deregister_child_cb
;
1953 static OSSL_FUNC_provider_name_fn core_provider_get0_name
;
1954 static OSSL_FUNC_provider_get0_provider_ctx_fn core_provider_get0_provider_ctx
;
1955 static OSSL_FUNC_provider_get0_dispatch_fn core_provider_get0_dispatch
;
1956 static OSSL_FUNC_provider_up_ref_fn core_provider_up_ref_intern
;
1957 static OSSL_FUNC_provider_free_fn core_provider_free_intern
;
1958 static OSSL_FUNC_core_obj_add_sigid_fn core_obj_add_sigid
;
1959 static OSSL_FUNC_core_obj_create_fn core_obj_create
;
1962 static const OSSL_PARAM
*core_gettable_params(const OSSL_CORE_HANDLE
*handle
)
1967 static int core_get_params(const OSSL_CORE_HANDLE
*handle
, OSSL_PARAM params
[])
1972 * We created this object originally and we know it is actually an
1973 * OSSL_PROVIDER *, so the cast is safe
1975 OSSL_PROVIDER
*prov
= (OSSL_PROVIDER
*)handle
;
1977 if ((p
= OSSL_PARAM_locate(params
, OSSL_PROV_PARAM_CORE_VERSION
)) != NULL
)
1978 OSSL_PARAM_set_utf8_ptr(p
, OPENSSL_VERSION_STR
);
1979 if ((p
= OSSL_PARAM_locate(params
, OSSL_PROV_PARAM_CORE_PROV_NAME
)) != NULL
)
1980 OSSL_PARAM_set_utf8_ptr(p
, prov
->name
);
1983 if ((p
= OSSL_PARAM_locate(params
,
1984 OSSL_PROV_PARAM_CORE_MODULE_FILENAME
)) != NULL
)
1985 OSSL_PARAM_set_utf8_ptr(p
, ossl_provider_module_path(prov
));
1988 if (prov
->parameters
== NULL
)
1991 for (i
= 0; i
< sk_INFOPAIR_num(prov
->parameters
); i
++) {
1992 INFOPAIR
*pair
= sk_INFOPAIR_value(prov
->parameters
, i
);
1994 if ((p
= OSSL_PARAM_locate(params
, pair
->name
)) != NULL
)
1995 OSSL_PARAM_set_utf8_ptr(p
, pair
->value
);
2000 static OPENSSL_CORE_CTX
*core_get_libctx(const OSSL_CORE_HANDLE
*handle
)
2003 * We created this object originally and we know it is actually an
2004 * OSSL_PROVIDER *, so the cast is safe
2006 OSSL_PROVIDER
*prov
= (OSSL_PROVIDER
*)handle
;
2009 * Using ossl_provider_libctx would be wrong as that returns
2010 * NULL for |prov| == NULL and NULL libctx has a special meaning
2011 * that does not apply here. Here |prov| == NULL can happen only in
2012 * case of a coding error.
2014 assert(prov
!= NULL
);
2015 return (OPENSSL_CORE_CTX
*)prov
->libctx
;
2018 static int core_thread_start(const OSSL_CORE_HANDLE
*handle
,
2019 OSSL_thread_stop_handler_fn handfn
,
2023 * We created this object originally and we know it is actually an
2024 * OSSL_PROVIDER *, so the cast is safe
2026 OSSL_PROVIDER
*prov
= (OSSL_PROVIDER
*)handle
;
2028 return ossl_init_thread_start(prov
, arg
, handfn
);
2032 * The FIPS module inner provider doesn't implement these. They aren't
2033 * needed there, since the FIPS module upcalls are always the outer provider
2038 * These error functions should use |handle| to select the proper
2039 * library context to report in the correct error stack if error
2040 * stacks become tied to the library context.
2041 * We cannot currently do that since there's no support for it in the
2044 static void core_new_error(const OSSL_CORE_HANDLE
*handle
)
2049 static void core_set_error_debug(const OSSL_CORE_HANDLE
*handle
,
2050 const char *file
, int line
, const char *func
)
2052 ERR_set_debug(file
, line
, func
);
2055 static void core_vset_error(const OSSL_CORE_HANDLE
*handle
,
2056 uint32_t reason
, const char *fmt
, va_list args
)
2059 * We created this object originally and we know it is actually an
2060 * OSSL_PROVIDER *, so the cast is safe
2062 OSSL_PROVIDER
*prov
= (OSSL_PROVIDER
*)handle
;
2065 * If the uppermost 8 bits are non-zero, it's an OpenSSL library
2066 * error and will be treated as such. Otherwise, it's a new style
2067 * provider error and will be treated as such.
2069 if (ERR_GET_LIB(reason
) != 0) {
2070 ERR_vset_error(ERR_GET_LIB(reason
), ERR_GET_REASON(reason
), fmt
, args
);
2072 ERR_vset_error(prov
->error_lib
, (int)reason
, fmt
, args
);
2076 static int core_set_error_mark(const OSSL_CORE_HANDLE
*handle
)
2078 return ERR_set_mark();
2081 static int core_clear_last_error_mark(const OSSL_CORE_HANDLE
*handle
)
2083 return ERR_clear_last_mark();
2086 static int core_pop_error_to_mark(const OSSL_CORE_HANDLE
*handle
)
2088 return ERR_pop_to_mark();
2091 static void core_self_test_get_callback(OPENSSL_CORE_CTX
*libctx
,
2092 OSSL_CALLBACK
**cb
, void **cbarg
)
2094 OSSL_SELF_TEST_get_callback((OSSL_LIB_CTX
*)libctx
, cb
, cbarg
);
2097 static const char *core_provider_get0_name(const OSSL_CORE_HANDLE
*prov
)
2099 return OSSL_PROVIDER_get0_name((const OSSL_PROVIDER
*)prov
);
2102 static void *core_provider_get0_provider_ctx(const OSSL_CORE_HANDLE
*prov
)
2104 return OSSL_PROVIDER_get0_provider_ctx((const OSSL_PROVIDER
*)prov
);
2107 static const OSSL_DISPATCH
*
2108 core_provider_get0_dispatch(const OSSL_CORE_HANDLE
*prov
)
2110 return OSSL_PROVIDER_get0_dispatch((const OSSL_PROVIDER
*)prov
);
2113 static int core_provider_up_ref_intern(const OSSL_CORE_HANDLE
*prov
,
2116 return provider_up_ref_intern((OSSL_PROVIDER
*)prov
, activate
);
2119 static int core_provider_free_intern(const OSSL_CORE_HANDLE
*prov
,
2122 return provider_free_intern((OSSL_PROVIDER
*)prov
, deactivate
);
2125 static int core_obj_add_sigid(const OSSL_CORE_HANDLE
*prov
,
2126 const char *sign_name
, const char *digest_name
,
2127 const char *pkey_name
)
2129 int sign_nid
= OBJ_txt2nid(sign_name
);
2130 int digest_nid
= NID_undef
;
2131 int pkey_nid
= OBJ_txt2nid(pkey_name
);
2133 if (digest_name
!= NULL
&& digest_name
[0] != '\0'
2134 && (digest_nid
= OBJ_txt2nid(digest_name
)) == NID_undef
)
2137 if (sign_nid
== NID_undef
)
2141 * Check if it already exists. This is a success if so (even if we don't
2142 * have nids for the digest/pkey)
2144 if (OBJ_find_sigid_algs(sign_nid
, NULL
, NULL
))
2147 if (pkey_nid
== NID_undef
)
2150 return OBJ_add_sigid(sign_nid
, digest_nid
, pkey_nid
);
2153 static int core_obj_create(const OSSL_CORE_HANDLE
*prov
, const char *oid
,
2154 const char *sn
, const char *ln
)
2156 /* Check if it already exists and create it if not */
2157 return OBJ_txt2nid(oid
) != NID_undef
2158 || OBJ_create(oid
, sn
, ln
) != NID_undef
;
2160 #endif /* FIPS_MODULE */
2163 * Functions provided by the core.
2165 static const OSSL_DISPATCH core_dispatch_
[] = {
2166 { OSSL_FUNC_CORE_GETTABLE_PARAMS
, (void (*)(void))core_gettable_params
},
2167 { OSSL_FUNC_CORE_GET_PARAMS
, (void (*)(void))core_get_params
},
2168 { OSSL_FUNC_CORE_GET_LIBCTX
, (void (*)(void))core_get_libctx
},
2169 { OSSL_FUNC_CORE_THREAD_START
, (void (*)(void))core_thread_start
},
2171 { OSSL_FUNC_CORE_NEW_ERROR
, (void (*)(void))core_new_error
},
2172 { OSSL_FUNC_CORE_SET_ERROR_DEBUG
, (void (*)(void))core_set_error_debug
},
2173 { OSSL_FUNC_CORE_VSET_ERROR
, (void (*)(void))core_vset_error
},
2174 { OSSL_FUNC_CORE_SET_ERROR_MARK
, (void (*)(void))core_set_error_mark
},
2175 { OSSL_FUNC_CORE_CLEAR_LAST_ERROR_MARK
,
2176 (void (*)(void))core_clear_last_error_mark
},
2177 { OSSL_FUNC_CORE_POP_ERROR_TO_MARK
, (void (*)(void))core_pop_error_to_mark
},
2178 { OSSL_FUNC_BIO_NEW_FILE
, (void (*)(void))ossl_core_bio_new_file
},
2179 { OSSL_FUNC_BIO_NEW_MEMBUF
, (void (*)(void))ossl_core_bio_new_mem_buf
},
2180 { OSSL_FUNC_BIO_READ_EX
, (void (*)(void))ossl_core_bio_read_ex
},
2181 { OSSL_FUNC_BIO_WRITE_EX
, (void (*)(void))ossl_core_bio_write_ex
},
2182 { OSSL_FUNC_BIO_GETS
, (void (*)(void))ossl_core_bio_gets
},
2183 { OSSL_FUNC_BIO_PUTS
, (void (*)(void))ossl_core_bio_puts
},
2184 { OSSL_FUNC_BIO_CTRL
, (void (*)(void))ossl_core_bio_ctrl
},
2185 { OSSL_FUNC_BIO_UP_REF
, (void (*)(void))ossl_core_bio_up_ref
},
2186 { OSSL_FUNC_BIO_FREE
, (void (*)(void))ossl_core_bio_free
},
2187 { OSSL_FUNC_BIO_VPRINTF
, (void (*)(void))ossl_core_bio_vprintf
},
2188 { OSSL_FUNC_BIO_VSNPRINTF
, (void (*)(void))BIO_vsnprintf
},
2189 { OSSL_FUNC_SELF_TEST_CB
, (void (*)(void))core_self_test_get_callback
},
2190 { OSSL_FUNC_GET_ENTROPY
, (void (*)(void))ossl_rand_get_entropy
},
2191 { OSSL_FUNC_CLEANUP_ENTROPY
, (void (*)(void))ossl_rand_cleanup_entropy
},
2192 { OSSL_FUNC_GET_NONCE
, (void (*)(void))ossl_rand_get_nonce
},
2193 { OSSL_FUNC_CLEANUP_NONCE
, (void (*)(void))ossl_rand_cleanup_nonce
},
2195 { OSSL_FUNC_CRYPTO_MALLOC
, (void (*)(void))CRYPTO_malloc
},
2196 { OSSL_FUNC_CRYPTO_ZALLOC
, (void (*)(void))CRYPTO_zalloc
},
2197 { OSSL_FUNC_CRYPTO_FREE
, (void (*)(void))CRYPTO_free
},
2198 { OSSL_FUNC_CRYPTO_CLEAR_FREE
, (void (*)(void))CRYPTO_clear_free
},
2199 { OSSL_FUNC_CRYPTO_REALLOC
, (void (*)(void))CRYPTO_realloc
},
2200 { OSSL_FUNC_CRYPTO_CLEAR_REALLOC
, (void (*)(void))CRYPTO_clear_realloc
},
2201 { OSSL_FUNC_CRYPTO_SECURE_MALLOC
, (void (*)(void))CRYPTO_secure_malloc
},
2202 { OSSL_FUNC_CRYPTO_SECURE_ZALLOC
, (void (*)(void))CRYPTO_secure_zalloc
},
2203 { OSSL_FUNC_CRYPTO_SECURE_FREE
, (void (*)(void))CRYPTO_secure_free
},
2204 { OSSL_FUNC_CRYPTO_SECURE_CLEAR_FREE
,
2205 (void (*)(void))CRYPTO_secure_clear_free
},
2206 { OSSL_FUNC_CRYPTO_SECURE_ALLOCATED
,
2207 (void (*)(void))CRYPTO_secure_allocated
},
2208 { OSSL_FUNC_OPENSSL_CLEANSE
, (void (*)(void))OPENSSL_cleanse
},
2210 { OSSL_FUNC_PROVIDER_REGISTER_CHILD_CB
,
2211 (void (*)(void))ossl_provider_register_child_cb
},
2212 { OSSL_FUNC_PROVIDER_DEREGISTER_CHILD_CB
,
2213 (void (*)(void))ossl_provider_deregister_child_cb
},
2214 { OSSL_FUNC_PROVIDER_NAME
,
2215 (void (*)(void))core_provider_get0_name
},
2216 { OSSL_FUNC_PROVIDER_GET0_PROVIDER_CTX
,
2217 (void (*)(void))core_provider_get0_provider_ctx
},
2218 { OSSL_FUNC_PROVIDER_GET0_DISPATCH
,
2219 (void (*)(void))core_provider_get0_dispatch
},
2220 { OSSL_FUNC_PROVIDER_UP_REF
,
2221 (void (*)(void))core_provider_up_ref_intern
},
2222 { OSSL_FUNC_PROVIDER_FREE
,
2223 (void (*)(void))core_provider_free_intern
},
2224 { OSSL_FUNC_CORE_OBJ_ADD_SIGID
, (void (*)(void))core_obj_add_sigid
},
2225 { OSSL_FUNC_CORE_OBJ_CREATE
, (void (*)(void))core_obj_create
},
2229 static const OSSL_DISPATCH
*core_dispatch
= core_dispatch_
;