Fixed typos in documentation and comments
[openssl.git] / crypto / provider_core.c
1 /*
2  * Copyright 2019-2022 The OpenSSL Project Authors. All Rights Reserved.
3  *
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
8  */
9
10 #include <assert.h>
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"
18 #ifndef FIPS_MODULE
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 */
22 #endif
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"
33 #ifndef FIPS_MODULE
34 # include <openssl/self_test.h>
35 #endif
36
37 /*
38  * This file defines and uses a number of different structures:
39  *
40  * OSSL_PROVIDER (provider_st): Used to represent all information related to a
41  * single instance of a provider.
42  *
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
46  * future point.
47  *
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.
51  *
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.
57  *
58  * LOCKING
59  * =======
60  *
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.
63  *
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.
69  *
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.
72  *
73  * The locks available are:
74  *
75  * The provider flag_lock: Used to control updates to the various provider
76  * "flags" (flag_initialized and flag_activated) and associated
77  * "counts" (activatecnt).
78  *
79  * The provider refcnt_lock: Only ever used to control updates to the provider
80  * refcnt value.
81  *
82  * The provider optbits_lock: Used to control access to the provider's
83  * operation_bits and operation_bits_sz fields.
84  *
85  * The store default_path_lock: Used to control access to the provider store's
86  * default search path value (default_path)
87  *
88  * The store lock: Used to control the stack of provider's held within the
89  * provider store, as well as the stack of registered child provider callbacks.
90  *
91  * As a general rule-of-thumb it is best to:
92  *  - keep the scope of the code that is protected by a lock to the absolute
93  *    minimum possible;
94  *  - try to keep the scope of the lock to within a single function (i.e. avoid
95  *    making calls to other functions while holding a lock);
96  *  - try to only ever hold one lock at a time.
97  *
98  * Unfortunately, it is not always possible to stick to the above guidelines.
99  * Where they are not adhered to there is always a danger of inadvertently
100  * introducing the possibility of deadlock. The following rules MUST be adhered
101  * to in order to avoid that:
102  *  - Holding multiple locks at the same time is only allowed for the
103  *    provider store lock, the provider flag_lock and the provider refcnt_lock.
104  *  - When holding multiple locks they must be acquired in the following order of
105  *    precedence:
106  *        1) provider store lock
107  *        2) provider flag_lock
108  *        3) provider refcnt_lock
109  *  - When releasing locks they must be released in the reverse order to which
110  *    they were acquired
111  *  - No locks may be held when making an upcall. NOTE: Some common functions
112  *    can make upcalls as part of their normal operation. If you need to call
113  *    some other function while holding a lock make sure you know whether it
114  *    will make any upcalls or not. For example ossl_provider_up_ref() can call
115  *    ossl_provider_up_ref_parent() which can call the c_prov_up_ref() upcall.
116  *  - It is permissible to hold the store and flag locks when calling child
117  *    provider callbacks. No other locks may be held during such callbacks.
118  */
119
120 static OSSL_PROVIDER *provider_new(const char *name,
121                                    OSSL_provider_init_fn *init_function,
122                                    STACK_OF(INFOPAIR) *parameters);
123
124 /*-
125  * Provider Object structure
126  * =========================
127  */
128
129 #ifndef FIPS_MODULE
130 typedef struct {
131     OSSL_PROVIDER *prov;
132     int (*create_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata);
133     int (*remove_cb)(const OSSL_CORE_HANDLE *provider, void *cbdata);
134     int (*global_props_cb)(const char *props, void *cbdata);
135     void *cbdata;
136 } OSSL_PROVIDER_CHILD_CB;
137 DEFINE_STACK_OF(OSSL_PROVIDER_CHILD_CB)
138 #endif
139
140 struct provider_store_st;        /* Forward declaration */
141
142 struct ossl_provider_st {
143     /* Flag bits */
144     unsigned int flag_initialized:1;
145     unsigned int flag_activated:1;
146
147     /* Getting and setting the flags require synchronization */
148     CRYPTO_RWLOCK *flag_lock;
149
150     /* OpenSSL library side data */
151     CRYPTO_REF_COUNT refcnt;
152     CRYPTO_RWLOCK *refcnt_lock;  /* For the ref counter */
153     int activatecnt;
154     char *name;
155     char *path;
156     DSO *module;
157     OSSL_provider_init_fn *init_function;
158     STACK_OF(INFOPAIR) *parameters;
159     OSSL_LIB_CTX *libctx; /* The library context this instance is in */
160     struct provider_store_st *store; /* The store this instance belongs to */
161 #ifndef FIPS_MODULE
162     /*
163      * In the FIPS module inner provider, this isn't needed, since the
164      * error upcalls are always direct calls to the outer provider.
165      */
166     int error_lib;     /* ERR library number, one for each provider */
167 # ifndef OPENSSL_NO_ERR
168     ERR_STRING_DATA *error_strings; /* Copy of what the provider gives us */
169 # endif
170 #endif
171
172     /* Provider side functions */
173     OSSL_FUNC_provider_teardown_fn *teardown;
174     OSSL_FUNC_provider_gettable_params_fn *gettable_params;
175     OSSL_FUNC_provider_get_params_fn *get_params;
176     OSSL_FUNC_provider_get_capabilities_fn *get_capabilities;
177     OSSL_FUNC_provider_self_test_fn *self_test;
178     OSSL_FUNC_provider_query_operation_fn *query_operation;
179     OSSL_FUNC_provider_unquery_operation_fn *unquery_operation;
180
181     /*
182      * Cache of bit to indicate of query_operation() has been called on
183      * a specific operation or not.
184      */
185     unsigned char *operation_bits;
186     size_t operation_bits_sz;
187     CRYPTO_RWLOCK *opbits_lock;
188
189 #ifndef FIPS_MODULE
190     /* Whether this provider is the child of some other provider */
191     const OSSL_CORE_HANDLE *handle;
192     unsigned int ischild:1;
193 #endif
194
195     /* Provider side data */
196     void *provctx;
197     const OSSL_DISPATCH *dispatch;
198 };
199 DEFINE_STACK_OF(OSSL_PROVIDER)
200
201 static int ossl_provider_cmp(const OSSL_PROVIDER * const *a,
202                              const OSSL_PROVIDER * const *b)
203 {
204     return strcmp((*a)->name, (*b)->name);
205 }
206
207 /*-
208  * Provider Object store
209  * =====================
210  *
211  * The Provider Object store is a library context object, and therefore needs
212  * an index.
213  */
214
215 struct provider_store_st {
216     OSSL_LIB_CTX *libctx;
217     STACK_OF(OSSL_PROVIDER) *providers;
218     STACK_OF(OSSL_PROVIDER_CHILD_CB) *child_cbs;
219     CRYPTO_RWLOCK *default_path_lock;
220     CRYPTO_RWLOCK *lock;
221     char *default_path;
222     OSSL_PROVIDER_INFO *provinfo;
223     size_t numprovinfo;
224     size_t provinfosz;
225     unsigned int use_fallbacks:1;
226     unsigned int freeing:1;
227 };
228
229 /*
230  * provider_deactivate_free() is a wrapper around ossl_provider_deactivate()
231  * and ossl_provider_free(), called as needed.
232  * Since this is only called when the provider store is being emptied, we
233  * don't need to care about any lock.
234  */
235 static void provider_deactivate_free(OSSL_PROVIDER *prov)
236 {
237     if (prov->flag_activated)
238         ossl_provider_deactivate(prov, 1);
239     ossl_provider_free(prov);
240 }
241
242 #ifndef FIPS_MODULE
243 static void ossl_provider_child_cb_free(OSSL_PROVIDER_CHILD_CB *cb)
244 {
245     OPENSSL_free(cb);
246 }
247 #endif
248
249 static void infopair_free(INFOPAIR *pair)
250 {
251     OPENSSL_free(pair->name);
252     OPENSSL_free(pair->value);
253     OPENSSL_free(pair);
254 }
255
256 static INFOPAIR *infopair_copy(const INFOPAIR *src)
257 {
258     INFOPAIR *dest = OPENSSL_zalloc(sizeof(*dest));
259
260     if (dest == NULL)
261         return NULL;
262     if (src->name != NULL) {
263         dest->name = OPENSSL_strdup(src->name);
264         if (dest->name == NULL)
265             goto err;
266     }
267     if (src->value != NULL) {
268         dest->value = OPENSSL_strdup(src->value);
269         if (dest->value == NULL)
270             goto err;
271     }
272     return dest;
273  err:
274     OPENSSL_free(dest->name);
275     OPENSSL_free(dest);
276     return NULL;
277 }
278
279 void ossl_provider_info_clear(OSSL_PROVIDER_INFO *info)
280 {
281     OPENSSL_free(info->name);
282     OPENSSL_free(info->path);
283     sk_INFOPAIR_pop_free(info->parameters, infopair_free);
284 }
285
286 void ossl_provider_store_free(void *vstore)
287 {
288     struct provider_store_st *store = vstore;
289     size_t i;
290
291     if (store == NULL)
292         return;
293     store->freeing = 1;
294     OPENSSL_free(store->default_path);
295     sk_OSSL_PROVIDER_pop_free(store->providers, provider_deactivate_free);
296 #ifndef FIPS_MODULE
297     sk_OSSL_PROVIDER_CHILD_CB_pop_free(store->child_cbs,
298                                        ossl_provider_child_cb_free);
299 #endif
300     CRYPTO_THREAD_lock_free(store->default_path_lock);
301     CRYPTO_THREAD_lock_free(store->lock);
302     for (i = 0; i < store->numprovinfo; i++)
303         ossl_provider_info_clear(&store->provinfo[i]);
304     OPENSSL_free(store->provinfo);
305     OPENSSL_free(store);
306 }
307
308 void *ossl_provider_store_new(OSSL_LIB_CTX *ctx)
309 {
310     struct provider_store_st *store = OPENSSL_zalloc(sizeof(*store));
311
312     if (store == NULL
313         || (store->providers = sk_OSSL_PROVIDER_new(ossl_provider_cmp)) == NULL
314         || (store->default_path_lock = CRYPTO_THREAD_lock_new()) == NULL
315 #ifndef FIPS_MODULE
316         || (store->child_cbs = sk_OSSL_PROVIDER_CHILD_CB_new_null()) == NULL
317 #endif
318         || (store->lock = CRYPTO_THREAD_lock_new()) == NULL) {
319         ossl_provider_store_free(store);
320         return NULL;
321     }
322     store->libctx = ctx;
323     store->use_fallbacks = 1;
324
325     return store;
326 }
327
328 static struct provider_store_st *get_provider_store(OSSL_LIB_CTX *libctx)
329 {
330     struct provider_store_st *store = NULL;
331
332     store = ossl_lib_ctx_get_data(libctx, OSSL_LIB_CTX_PROVIDER_STORE_INDEX);
333     if (store == NULL)
334         ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
335     return store;
336 }
337
338 int ossl_provider_disable_fallback_loading(OSSL_LIB_CTX *libctx)
339 {
340     struct provider_store_st *store;
341
342     if ((store = get_provider_store(libctx)) != NULL) {
343         if (!CRYPTO_THREAD_write_lock(store->lock))
344             return 0;
345         store->use_fallbacks = 0;
346         CRYPTO_THREAD_unlock(store->lock);
347         return 1;
348     }
349     return 0;
350 }
351
352 #define BUILTINS_BLOCK_SIZE     10
353
354 int ossl_provider_info_add_to_store(OSSL_LIB_CTX *libctx,
355                                     OSSL_PROVIDER_INFO *entry)
356 {
357     struct provider_store_st *store = get_provider_store(libctx);
358     int ret = 0;
359
360     if (entry->name == NULL) {
361         ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
362         return 0;
363     }
364
365     if (store == NULL) {
366         ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
367         return 0;
368     }
369
370     if (!CRYPTO_THREAD_write_lock(store->lock))
371         return 0;
372     if (store->provinfosz == 0) {
373         store->provinfo = OPENSSL_zalloc(sizeof(*store->provinfo)
374                                          * BUILTINS_BLOCK_SIZE);
375         if (store->provinfo == NULL)
376             goto err;
377         store->provinfosz = BUILTINS_BLOCK_SIZE;
378     } else if (store->numprovinfo == store->provinfosz) {
379         OSSL_PROVIDER_INFO *tmpbuiltins;
380         size_t newsz = store->provinfosz + BUILTINS_BLOCK_SIZE;
381
382         tmpbuiltins = OPENSSL_realloc(store->provinfo,
383                                       sizeof(*store->provinfo) * newsz);
384         if (tmpbuiltins == NULL)
385             goto err;
386         store->provinfo = tmpbuiltins;
387         store->provinfosz = newsz;
388     }
389     store->provinfo[store->numprovinfo] = *entry;
390     store->numprovinfo++;
391
392     ret = 1;
393  err:
394     CRYPTO_THREAD_unlock(store->lock);
395     return ret;
396 }
397
398 OSSL_PROVIDER *ossl_provider_find(OSSL_LIB_CTX *libctx, const char *name,
399                                   int noconfig)
400 {
401     struct provider_store_st *store = NULL;
402     OSSL_PROVIDER *prov = NULL;
403
404     if ((store = get_provider_store(libctx)) != NULL) {
405         OSSL_PROVIDER tmpl = { 0, };
406         int i;
407
408 #ifndef FIPS_MODULE
409         /*
410          * Make sure any providers are loaded from config before we try to find
411          * them.
412          */
413         if (!noconfig) {
414             if (ossl_lib_ctx_is_default(libctx))
415                 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL);
416         }
417 #endif
418
419         tmpl.name = (char *)name;
420         /*
421          * A "find" operation can sort the stack, and therefore a write lock is
422          * required.
423          */
424         if (!CRYPTO_THREAD_write_lock(store->lock))
425             return NULL;
426         if ((i = sk_OSSL_PROVIDER_find(store->providers, &tmpl)) != -1)
427             prov = sk_OSSL_PROVIDER_value(store->providers, i);
428         CRYPTO_THREAD_unlock(store->lock);
429         if (prov != NULL && !ossl_provider_up_ref(prov))
430             prov = NULL;
431     }
432
433     return prov;
434 }
435
436 /*-
437  * Provider Object methods
438  * =======================
439  */
440
441 static OSSL_PROVIDER *provider_new(const char *name,
442                                    OSSL_provider_init_fn *init_function,
443                                    STACK_OF(INFOPAIR) *parameters)
444 {
445     OSSL_PROVIDER *prov = NULL;
446
447     if ((prov = OPENSSL_zalloc(sizeof(*prov))) == NULL)
448         return NULL;
449 #ifndef HAVE_ATOMICS
450     if ((prov->refcnt_lock = CRYPTO_THREAD_lock_new()) == NULL) {
451         OPENSSL_free(prov);
452         ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
453         return NULL;
454     }
455 #endif
456
457     prov->refcnt = 1; /* 1 One reference to be returned */
458
459     if ((prov->opbits_lock = CRYPTO_THREAD_lock_new()) == NULL
460         || (prov->flag_lock = CRYPTO_THREAD_lock_new()) == NULL
461         || (prov->parameters = sk_INFOPAIR_deep_copy(parameters,
462                                                      infopair_copy,
463                                                      infopair_free)) == NULL) {
464         ossl_provider_free(prov);
465         ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
466         return NULL;
467     }
468     if ((prov->name = OPENSSL_strdup(name)) == NULL) {
469         ossl_provider_free(prov);
470         return NULL;
471     }
472
473     prov->init_function = init_function;
474
475     return prov;
476 }
477
478 int ossl_provider_up_ref(OSSL_PROVIDER *prov)
479 {
480     int ref = 0;
481
482     if (CRYPTO_UP_REF(&prov->refcnt, &ref, prov->refcnt_lock) <= 0)
483         return 0;
484
485 #ifndef FIPS_MODULE
486     if (prov->ischild) {
487         if (!ossl_provider_up_ref_parent(prov, 0)) {
488             ossl_provider_free(prov);
489             return 0;
490         }
491     }
492 #endif
493
494     return ref;
495 }
496
497 #ifndef FIPS_MODULE
498 static int provider_up_ref_intern(OSSL_PROVIDER *prov, int activate)
499 {
500     if (activate)
501         return ossl_provider_activate(prov, 1, 0);
502
503     return ossl_provider_up_ref(prov);
504 }
505
506 static int provider_free_intern(OSSL_PROVIDER *prov, int deactivate)
507 {
508     if (deactivate)
509         return ossl_provider_deactivate(prov, 1);
510
511     ossl_provider_free(prov);
512     return 1;
513 }
514 #endif
515
516 /*
517  * We assume that the requested provider does not already exist in the store.
518  * The caller should check. If it does exist then adding it to the store later
519  * will fail.
520  */
521 OSSL_PROVIDER *ossl_provider_new(OSSL_LIB_CTX *libctx, const char *name,
522                                  OSSL_provider_init_fn *init_function,
523                                  int noconfig)
524 {
525     struct provider_store_st *store = NULL;
526     OSSL_PROVIDER_INFO template;
527     OSSL_PROVIDER *prov = NULL;
528
529     if ((store = get_provider_store(libctx)) == NULL)
530         return NULL;
531
532     memset(&template, 0, sizeof(template));
533     if (init_function == NULL) {
534         const OSSL_PROVIDER_INFO *p;
535         size_t i;
536
537         /* Check if this is a predefined builtin provider */
538         for (p = ossl_predefined_providers; p->name != NULL; p++) {
539             if (strcmp(p->name, name) == 0) {
540                 template = *p;
541                 break;
542             }
543         }
544         if (p->name == NULL) {
545             /* Check if this is a user added builtin provider */
546             if (!CRYPTO_THREAD_read_lock(store->lock))
547                 return NULL;
548             for (i = 0, p = store->provinfo; i < store->numprovinfo; p++, i++) {
549                 if (strcmp(p->name, name) == 0) {
550                     template = *p;
551                     break;
552                 }
553             }
554             CRYPTO_THREAD_unlock(store->lock);
555         }
556     } else {
557         template.init = init_function;
558     }
559
560     /* provider_new() generates an error, so no need here */
561     if ((prov = provider_new(name, template.init, template.parameters)) == NULL)
562         return NULL;
563
564     prov->libctx = libctx;
565 #ifndef FIPS_MODULE
566     prov->error_lib = ERR_get_next_error_library();
567 #endif
568
569     /*
570      * At this point, the provider is only partially "loaded".  To be
571      * fully "loaded", ossl_provider_activate() must also be called and it must
572      * then be added to the provider store.
573      */
574
575     return prov;
576 }
577
578 /* Assumes that the store lock is held */
579 static int create_provider_children(OSSL_PROVIDER *prov)
580 {
581     int ret = 1;
582 #ifndef FIPS_MODULE
583     struct provider_store_st *store = prov->store;
584     OSSL_PROVIDER_CHILD_CB *child_cb;
585     int i, max;
586
587     max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
588     for (i = 0; i < max; i++) {
589         /*
590          * This is newly activated (activatecnt == 1), so we need to
591          * create child providers as necessary.
592          */
593         child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
594         ret &= child_cb->create_cb((OSSL_CORE_HANDLE *)prov, child_cb->cbdata);
595     }
596 #endif
597
598     return ret;
599 }
600
601 int ossl_provider_add_to_store(OSSL_PROVIDER *prov, OSSL_PROVIDER **actualprov,
602                                int retain_fallbacks)
603 {
604     struct provider_store_st *store;
605     int idx;
606     OSSL_PROVIDER tmpl = { 0, };
607     OSSL_PROVIDER *actualtmp = NULL;
608
609     if (actualprov != NULL)
610         *actualprov = NULL;
611
612     if ((store = get_provider_store(prov->libctx)) == NULL)
613         return 0;
614
615     if (!CRYPTO_THREAD_write_lock(store->lock))
616         return 0;
617
618     tmpl.name = (char *)prov->name;
619     idx = sk_OSSL_PROVIDER_find(store->providers, &tmpl);
620     if (idx == -1)
621         actualtmp = prov;
622     else
623         actualtmp = sk_OSSL_PROVIDER_value(store->providers, idx);
624
625     if (idx == -1) {
626         if (sk_OSSL_PROVIDER_push(store->providers, prov) == 0)
627             goto err;
628         prov->store = store;
629         if (!create_provider_children(prov)) {
630             sk_OSSL_PROVIDER_delete_ptr(store->providers, prov);
631             goto err;
632         }
633         if (!retain_fallbacks)
634             store->use_fallbacks = 0;
635     }
636
637     CRYPTO_THREAD_unlock(store->lock);
638
639     if (actualprov != NULL) {
640         if (!ossl_provider_up_ref(actualtmp)) {
641             ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
642             actualtmp = NULL;
643             return 0;
644         }
645         *actualprov = actualtmp;
646     }
647
648     if (idx >= 0) {
649         /*
650          * The provider is already in the store. Probably two threads
651          * independently initialised their own provider objects with the same
652          * name and raced to put them in the store. This thread lost. We
653          * deactivate the one we just created and use the one that already
654          * exists instead.
655          * If we get here then we know we did not create provider children
656          * above, so we inform ossl_provider_deactivate not to attempt to remove
657          * any.
658          */
659         ossl_provider_deactivate(prov, 0);
660         ossl_provider_free(prov);
661     }
662
663     return 1;
664
665  err:
666     CRYPTO_THREAD_unlock(store->lock);
667     return 0;
668 }
669
670 void ossl_provider_free(OSSL_PROVIDER *prov)
671 {
672     if (prov != NULL) {
673         int ref = 0;
674
675         CRYPTO_DOWN_REF(&prov->refcnt, &ref, prov->refcnt_lock);
676
677         /*
678          * When the refcount drops to zero, we clean up the provider.
679          * Note that this also does teardown, which may seem late,
680          * considering that init happens on first activation.  However,
681          * there may be other structures hanging on to the provider after
682          * the last deactivation and may therefore need full access to the
683          * provider's services.  Therefore, we deinit late.
684          */
685         if (ref == 0) {
686             if (prov->flag_initialized) {
687                 ossl_provider_teardown(prov);
688 #ifndef OPENSSL_NO_ERR
689 # ifndef FIPS_MODULE
690                 if (prov->error_strings != NULL) {
691                     ERR_unload_strings(prov->error_lib, prov->error_strings);
692                     OPENSSL_free(prov->error_strings);
693                     prov->error_strings = NULL;
694                 }
695 # endif
696 #endif
697                 OPENSSL_free(prov->operation_bits);
698                 prov->operation_bits = NULL;
699                 prov->operation_bits_sz = 0;
700                 prov->flag_initialized = 0;
701             }
702
703 #ifndef FIPS_MODULE
704             /*
705              * We deregister thread handling whether or not the provider was
706              * initialized. If init was attempted but was not successful then
707              * the provider may still have registered a thread handler.
708              */
709             ossl_init_thread_deregister(prov);
710             DSO_free(prov->module);
711 #endif
712             OPENSSL_free(prov->name);
713             OPENSSL_free(prov->path);
714             sk_INFOPAIR_pop_free(prov->parameters, infopair_free);
715             CRYPTO_THREAD_lock_free(prov->opbits_lock);
716             CRYPTO_THREAD_lock_free(prov->flag_lock);
717 #ifndef HAVE_ATOMICS
718             CRYPTO_THREAD_lock_free(prov->refcnt_lock);
719 #endif
720             OPENSSL_free(prov);
721         }
722 #ifndef FIPS_MODULE
723         else if (prov->ischild) {
724             ossl_provider_free_parent(prov, 0);
725         }
726 #endif
727     }
728 }
729
730 /* Setters */
731 int ossl_provider_set_module_path(OSSL_PROVIDER *prov, const char *module_path)
732 {
733     OPENSSL_free(prov->path);
734     prov->path = NULL;
735     if (module_path == NULL)
736         return 1;
737     if ((prov->path = OPENSSL_strdup(module_path)) != NULL)
738         return 1;
739     return 0;
740 }
741
742 static int infopair_add(STACK_OF(INFOPAIR) **infopairsk, const char *name,
743                         const char *value)
744 {
745     INFOPAIR *pair = NULL;
746
747     if ((pair = OPENSSL_zalloc(sizeof(*pair))) == NULL
748         || (pair->name = OPENSSL_strdup(name)) == NULL
749         || (pair->value = OPENSSL_strdup(value)) == NULL)
750         goto err;
751
752     if ((*infopairsk == NULL
753          && (*infopairsk = sk_INFOPAIR_new_null()) == NULL)
754         || sk_INFOPAIR_push(*infopairsk, pair) <= 0) {
755         ERR_raise(ERR_LIB_CRYPTO, ERR_R_CRYPTO_LIB);
756         goto err;
757     }
758
759     return 1;
760
761  err:
762     if (pair != NULL) {
763         OPENSSL_free(pair->name);
764         OPENSSL_free(pair->value);
765         OPENSSL_free(pair);
766     }
767     return 0;
768 }
769
770 int ossl_provider_add_parameter(OSSL_PROVIDER *prov,
771                                 const char *name, const char *value)
772 {
773     return infopair_add(&prov->parameters, name, value);
774 }
775
776 int ossl_provider_info_add_parameter(OSSL_PROVIDER_INFO *provinfo,
777                                      const char *name,
778                                      const char *value)
779 {
780     return infopair_add(&provinfo->parameters, name, value);
781 }
782
783 /*
784  * Provider activation.
785  *
786  * What "activation" means depends on the provider form; for built in
787  * providers (in the library or the application alike), the provider
788  * can already be considered to be loaded, all that's needed is to
789  * initialize it.  However, for dynamically loadable provider modules,
790  * we must first load that module.
791  *
792  * Built in modules are distinguished from dynamically loaded modules
793  * with an already assigned init function.
794  */
795 static const OSSL_DISPATCH *core_dispatch; /* Define further down */
796
797 int OSSL_PROVIDER_set_default_search_path(OSSL_LIB_CTX *libctx,
798                                           const char *path)
799 {
800     struct provider_store_st *store;
801     char *p = NULL;
802
803     if (path != NULL) {
804         p = OPENSSL_strdup(path);
805         if (p == NULL)
806             return 0;
807     }
808     if ((store = get_provider_store(libctx)) != NULL
809             && CRYPTO_THREAD_write_lock(store->default_path_lock)) {
810         OPENSSL_free(store->default_path);
811         store->default_path = p;
812         CRYPTO_THREAD_unlock(store->default_path_lock);
813         return 1;
814     }
815     OPENSSL_free(p);
816     return 0;
817 }
818
819 const char *OSSL_PROVIDER_get0_default_search_path(OSSL_LIB_CTX *libctx)
820 {
821     struct provider_store_st *store;
822     char *path = NULL;
823
824     if ((store = get_provider_store(libctx)) != NULL
825             && CRYPTO_THREAD_read_lock(store->default_path_lock)) {
826         path = store->default_path;
827         CRYPTO_THREAD_unlock(store->default_path_lock);
828     }
829     return path;
830 }
831
832 /*
833  * Internal version that doesn't affect the store flags, and thereby avoid
834  * locking.  Direct callers must remember to set the store flags when
835  * appropriate.
836  */
837 static int provider_init(OSSL_PROVIDER *prov)
838 {
839     const OSSL_DISPATCH *provider_dispatch = NULL;
840     void *tmp_provctx = NULL;    /* safety measure */
841 #ifndef OPENSSL_NO_ERR
842 # ifndef FIPS_MODULE
843     OSSL_FUNC_provider_get_reason_strings_fn *p_get_reason_strings = NULL;
844 # endif
845 #endif
846     int ok = 0;
847
848     if (!ossl_assert(!prov->flag_initialized)) {
849         ERR_raise(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR);
850         goto end;
851     }
852
853     /*
854      * If the init function isn't set, it indicates that this provider is
855      * a loadable module.
856      */
857     if (prov->init_function == NULL) {
858 #ifdef FIPS_MODULE
859         goto end;
860 #else
861         if (prov->module == NULL) {
862             char *allocated_path = NULL;
863             const char *module_path = NULL;
864             char *merged_path = NULL;
865             const char *load_dir = NULL;
866             char *allocated_load_dir = NULL;
867             struct provider_store_st *store;
868
869             if ((prov->module = DSO_new()) == NULL) {
870                 /* DSO_new() generates an error already */
871                 goto end;
872             }
873
874             if ((store = get_provider_store(prov->libctx)) == NULL
875                     || !CRYPTO_THREAD_read_lock(store->default_path_lock))
876                 goto end;
877
878             if (store->default_path != NULL) {
879                 allocated_load_dir = OPENSSL_strdup(store->default_path);
880                 CRYPTO_THREAD_unlock(store->default_path_lock);
881                 if (allocated_load_dir == NULL)
882                     goto end;
883                 load_dir = allocated_load_dir;
884             } else {
885                 CRYPTO_THREAD_unlock(store->default_path_lock);
886             }
887
888             if (load_dir == NULL) {
889                 load_dir = ossl_safe_getenv("OPENSSL_MODULES");
890                 if (load_dir == NULL)
891                     load_dir = MODULESDIR;
892             }
893
894             DSO_ctrl(prov->module, DSO_CTRL_SET_FLAGS,
895                      DSO_FLAG_NAME_TRANSLATION_EXT_ONLY, NULL);
896
897             module_path = prov->path;
898             if (module_path == NULL)
899                 module_path = allocated_path =
900                     DSO_convert_filename(prov->module, prov->name);
901             if (module_path != NULL)
902                 merged_path = DSO_merge(prov->module, module_path, load_dir);
903
904             if (merged_path == NULL
905                 || (DSO_load(prov->module, merged_path, NULL, 0)) == NULL) {
906                 DSO_free(prov->module);
907                 prov->module = NULL;
908             }
909
910             OPENSSL_free(merged_path);
911             OPENSSL_free(allocated_path);
912             OPENSSL_free(allocated_load_dir);
913         }
914
915         if (prov->module == NULL) {
916             /* DSO has already recorded errors, this is just a tracepoint */
917             ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_DSO_LIB,
918                            "name=%s", prov->name);
919             goto end;
920         }
921
922         prov->init_function = (OSSL_provider_init_fn *)
923             DSO_bind_func(prov->module, "OSSL_provider_init");
924 #endif
925     }
926
927     /* Check for and call the initialise function for the provider. */
928     if (prov->init_function == NULL) {
929         ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_UNSUPPORTED,
930                        "name=%s, provider has no provider init function",
931                        prov->name);
932         goto end;
933     }
934
935     if (!prov->init_function((OSSL_CORE_HANDLE *)prov, core_dispatch,
936                              &provider_dispatch, &tmp_provctx)) {
937         ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_INIT_FAIL,
938                        "name=%s", prov->name);
939         goto end;
940     }
941     prov->provctx = tmp_provctx;
942     prov->dispatch = provider_dispatch;
943
944     for (; provider_dispatch->function_id != 0; provider_dispatch++) {
945         switch (provider_dispatch->function_id) {
946         case OSSL_FUNC_PROVIDER_TEARDOWN:
947             prov->teardown =
948                 OSSL_FUNC_provider_teardown(provider_dispatch);
949             break;
950         case OSSL_FUNC_PROVIDER_GETTABLE_PARAMS:
951             prov->gettable_params =
952                 OSSL_FUNC_provider_gettable_params(provider_dispatch);
953             break;
954         case OSSL_FUNC_PROVIDER_GET_PARAMS:
955             prov->get_params =
956                 OSSL_FUNC_provider_get_params(provider_dispatch);
957             break;
958         case OSSL_FUNC_PROVIDER_SELF_TEST:
959             prov->self_test =
960                 OSSL_FUNC_provider_self_test(provider_dispatch);
961             break;
962         case OSSL_FUNC_PROVIDER_GET_CAPABILITIES:
963             prov->get_capabilities =
964                 OSSL_FUNC_provider_get_capabilities(provider_dispatch);
965             break;
966         case OSSL_FUNC_PROVIDER_QUERY_OPERATION:
967             prov->query_operation =
968                 OSSL_FUNC_provider_query_operation(provider_dispatch);
969             break;
970         case OSSL_FUNC_PROVIDER_UNQUERY_OPERATION:
971             prov->unquery_operation =
972                 OSSL_FUNC_provider_unquery_operation(provider_dispatch);
973             break;
974 #ifndef OPENSSL_NO_ERR
975 # ifndef FIPS_MODULE
976         case OSSL_FUNC_PROVIDER_GET_REASON_STRINGS:
977             p_get_reason_strings =
978                 OSSL_FUNC_provider_get_reason_strings(provider_dispatch);
979             break;
980 # endif
981 #endif
982         }
983     }
984
985 #ifndef OPENSSL_NO_ERR
986 # ifndef FIPS_MODULE
987     if (p_get_reason_strings != NULL) {
988         const OSSL_ITEM *reasonstrings = p_get_reason_strings(prov->provctx);
989         size_t cnt, cnt2;
990
991         /*
992          * ERR_load_strings() handles ERR_STRING_DATA rather than OSSL_ITEM,
993          * although they are essentially the same type.
994          * Furthermore, ERR_load_strings() patches the array's error number
995          * with the error library number, so we need to make a copy of that
996          * array either way.
997          */
998         cnt = 0;
999         while (reasonstrings[cnt].id != 0) {
1000             if (ERR_GET_LIB(reasonstrings[cnt].id) != 0)
1001                 goto end;
1002             cnt++;
1003         }
1004         cnt++;                   /* One for the terminating item */
1005
1006         /* Allocate one extra item for the "library" name */
1007         prov->error_strings =
1008             OPENSSL_zalloc(sizeof(ERR_STRING_DATA) * (cnt + 1));
1009         if (prov->error_strings == NULL)
1010             goto end;
1011
1012         /*
1013          * Set the "library" name.
1014          */
1015         prov->error_strings[0].error = ERR_PACK(prov->error_lib, 0, 0);
1016         prov->error_strings[0].string = prov->name;
1017         /*
1018          * Copy reasonstrings item 0..cnt-1 to prov->error_trings positions
1019          * 1..cnt.
1020          */
1021         for (cnt2 = 1; cnt2 <= cnt; cnt2++) {
1022             prov->error_strings[cnt2].error = (int)reasonstrings[cnt2-1].id;
1023             prov->error_strings[cnt2].string = reasonstrings[cnt2-1].ptr;
1024         }
1025
1026         ERR_load_strings(prov->error_lib, prov->error_strings);
1027     }
1028 # endif
1029 #endif
1030
1031     /* With this flag set, this provider has become fully "loaded". */
1032     prov->flag_initialized = 1;
1033     ok = 1;
1034
1035  end:
1036     return ok;
1037 }
1038
1039 /*
1040  * Deactivate a provider. If upcalls is 0 then we suppress any upcalls to a
1041  * parent provider. If removechildren is 0 then we suppress any calls to remove
1042  * child providers.
1043  * Return -1 on failure and the activation count on success
1044  */
1045 static int provider_deactivate(OSSL_PROVIDER *prov, int upcalls,
1046                                int removechildren)
1047 {
1048     int count;
1049     struct provider_store_st *store;
1050 #ifndef FIPS_MODULE
1051     int freeparent = 0;
1052 #endif
1053     int lock = 1;
1054
1055     if (!ossl_assert(prov != NULL))
1056         return -1;
1057
1058     /*
1059      * No need to lock if we've got no store because we've not been shared with
1060      * other threads.
1061      */
1062     store = get_provider_store(prov->libctx);
1063     if (store == NULL)
1064         lock = 0;
1065
1066     if (lock && !CRYPTO_THREAD_read_lock(store->lock))
1067         return -1;
1068     if (lock && !CRYPTO_THREAD_write_lock(prov->flag_lock)) {
1069         CRYPTO_THREAD_unlock(store->lock);
1070         return -1;
1071     }
1072
1073 #ifndef FIPS_MODULE
1074     if (prov->activatecnt >= 2 && prov->ischild && upcalls) {
1075         /*
1076          * We have had a direct activation in this child libctx so we need to
1077          * now down the ref count in the parent provider. We do the actual down
1078          * ref outside of the flag_lock, since it could involve getting other
1079          * locks.
1080          */
1081         freeparent = 1;
1082     }
1083 #endif
1084
1085     if ((count = --prov->activatecnt) < 1)
1086         prov->flag_activated = 0;
1087 #ifndef FIPS_MODULE
1088     else
1089         removechildren = 0;
1090 #endif
1091
1092 #ifndef FIPS_MODULE
1093     if (removechildren && store != NULL) {
1094         int i, max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1095         OSSL_PROVIDER_CHILD_CB *child_cb;
1096
1097         for (i = 0; i < max; i++) {
1098             child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1099             child_cb->remove_cb((OSSL_CORE_HANDLE *)prov, child_cb->cbdata);
1100         }
1101     }
1102 #endif
1103     if (lock) {
1104         CRYPTO_THREAD_unlock(prov->flag_lock);
1105         CRYPTO_THREAD_unlock(store->lock);
1106     }
1107 #ifndef FIPS_MODULE
1108     if (freeparent)
1109         ossl_provider_free_parent(prov, 1);
1110 #endif
1111
1112     /* We don't deinit here, that's done in ossl_provider_free() */
1113     return count;
1114 }
1115
1116 /*
1117  * Activate a provider.
1118  * Return -1 on failure and the activation count on success
1119  */
1120 static int provider_activate(OSSL_PROVIDER *prov, int lock, int upcalls)
1121 {
1122     int count = -1;
1123     struct provider_store_st *store;
1124     int ret = 1;
1125
1126     store = prov->store;
1127     /*
1128     * If the provider hasn't been added to the store, then we don't need
1129     * any locks because we've not shared it with other threads.
1130     */
1131     if (store == NULL) {
1132         lock = 0;
1133         if (!provider_init(prov))
1134             return -1;
1135     }
1136
1137 #ifndef FIPS_MODULE
1138     if (prov->ischild && upcalls && !ossl_provider_up_ref_parent(prov, 1))
1139         return -1;
1140 #endif
1141
1142     if (lock && !CRYPTO_THREAD_read_lock(store->lock)) {
1143 #ifndef FIPS_MODULE
1144         if (prov->ischild && upcalls)
1145             ossl_provider_free_parent(prov, 1);
1146 #endif
1147         return -1;
1148     }
1149
1150     if (lock && !CRYPTO_THREAD_write_lock(prov->flag_lock)) {
1151         CRYPTO_THREAD_unlock(store->lock);
1152 #ifndef FIPS_MODULE
1153         if (prov->ischild && upcalls)
1154             ossl_provider_free_parent(prov, 1);
1155 #endif
1156         return -1;
1157     }
1158
1159     count = ++prov->activatecnt;
1160     prov->flag_activated = 1;
1161
1162     if (prov->activatecnt == 1 && store != NULL) {
1163         ret = create_provider_children(prov);
1164     }
1165     if (lock) {
1166         CRYPTO_THREAD_unlock(prov->flag_lock);
1167         CRYPTO_THREAD_unlock(store->lock);
1168     }
1169
1170     if (!ret)
1171         return -1;
1172
1173     return count;
1174 }
1175
1176 static int provider_flush_store_cache(const OSSL_PROVIDER *prov)
1177 {
1178     struct provider_store_st *store;
1179     int freeing;
1180
1181     if ((store = get_provider_store(prov->libctx)) == NULL)
1182         return 0;
1183
1184     if (!CRYPTO_THREAD_read_lock(store->lock))
1185         return 0;
1186     freeing = store->freeing;
1187     CRYPTO_THREAD_unlock(store->lock);
1188
1189     if (!freeing) {
1190         int acc
1191             = evp_method_store_cache_flush(prov->libctx)
1192 #ifndef FIPS_MODULE
1193             + ossl_encoder_store_cache_flush(prov->libctx)
1194             + ossl_decoder_store_cache_flush(prov->libctx)
1195             + ossl_store_loader_store_cache_flush(prov->libctx)
1196 #endif
1197             ;
1198
1199 #ifndef FIPS_MODULE
1200         return acc == 4;
1201 #else
1202         return acc == 1;
1203 #endif
1204     }
1205     return 1;
1206 }
1207
1208 static int provider_remove_store_methods(OSSL_PROVIDER *prov)
1209 {
1210     struct provider_store_st *store;
1211     int freeing;
1212
1213     if ((store = get_provider_store(prov->libctx)) == NULL)
1214         return 0;
1215
1216     if (!CRYPTO_THREAD_read_lock(store->lock))
1217         return 0;
1218     freeing = store->freeing;
1219     CRYPTO_THREAD_unlock(store->lock);
1220
1221     if (!freeing) {
1222         int acc;
1223
1224         if (!CRYPTO_THREAD_write_lock(prov->opbits_lock))
1225             return 0;
1226         OPENSSL_free(prov->operation_bits);
1227         prov->operation_bits = NULL;
1228         prov->operation_bits_sz = 0;
1229         CRYPTO_THREAD_unlock(prov->opbits_lock);
1230
1231         acc = evp_method_store_remove_all_provided(prov)
1232 #ifndef FIPS_MODULE
1233             + ossl_encoder_store_remove_all_provided(prov)
1234             + ossl_decoder_store_remove_all_provided(prov)
1235             + ossl_store_loader_store_remove_all_provided(prov)
1236 #endif
1237             ;
1238
1239 #ifndef FIPS_MODULE
1240         return acc == 4;
1241 #else
1242         return acc == 1;
1243 #endif
1244     }
1245     return 1;
1246 }
1247
1248 int ossl_provider_activate(OSSL_PROVIDER *prov, int upcalls, int aschild)
1249 {
1250     int count;
1251
1252     if (prov == NULL)
1253         return 0;
1254 #ifndef FIPS_MODULE
1255     /*
1256      * If aschild is true, then we only actually do the activation if the
1257      * provider is a child. If its not, this is still success.
1258      */
1259     if (aschild && !prov->ischild)
1260         return 1;
1261 #endif
1262     if ((count = provider_activate(prov, 1, upcalls)) > 0)
1263         return count == 1 ? provider_flush_store_cache(prov) : 1;
1264
1265     return 0;
1266 }
1267
1268 int ossl_provider_deactivate(OSSL_PROVIDER *prov, int removechildren)
1269 {
1270     int count;
1271
1272     if (prov == NULL
1273             || (count = provider_deactivate(prov, 1, removechildren)) < 0)
1274         return 0;
1275     return count == 0 ? provider_remove_store_methods(prov) : 1;
1276 }
1277
1278 void *ossl_provider_ctx(const OSSL_PROVIDER *prov)
1279 {
1280     return prov != NULL ? prov->provctx : NULL;
1281 }
1282
1283 /*
1284  * This function only does something once when store->use_fallbacks == 1,
1285  * and then sets store->use_fallbacks = 0, so the second call and so on is
1286  * effectively a no-op.
1287  */
1288 static int provider_activate_fallbacks(struct provider_store_st *store)
1289 {
1290     int use_fallbacks;
1291     int activated_fallback_count = 0;
1292     int ret = 0;
1293     const OSSL_PROVIDER_INFO *p;
1294
1295     if (!CRYPTO_THREAD_read_lock(store->lock))
1296         return 0;
1297     use_fallbacks = store->use_fallbacks;
1298     CRYPTO_THREAD_unlock(store->lock);
1299     if (!use_fallbacks)
1300         return 1;
1301
1302     if (!CRYPTO_THREAD_write_lock(store->lock))
1303         return 0;
1304     /* Check again, just in case another thread changed it */
1305     use_fallbacks = store->use_fallbacks;
1306     if (!use_fallbacks) {
1307         CRYPTO_THREAD_unlock(store->lock);
1308         return 1;
1309     }
1310
1311     for (p = ossl_predefined_providers; p->name != NULL; p++) {
1312         OSSL_PROVIDER *prov = NULL;
1313
1314         if (!p->is_fallback)
1315             continue;
1316         /*
1317          * We use the internal constructor directly here,
1318          * otherwise we get a call loop
1319          */
1320         prov = provider_new(p->name, p->init, NULL);
1321         if (prov == NULL)
1322             goto err;
1323         prov->libctx = store->libctx;
1324 #ifndef FIPS_MODULE
1325         prov->error_lib = ERR_get_next_error_library();
1326 #endif
1327
1328         /*
1329          * We are calling provider_activate while holding the store lock. This
1330          * means the init function will be called while holding a lock. Normally
1331          * we try to avoid calling a user callback while holding a lock.
1332          * However, fallbacks are never third party providers so we accept this.
1333          */
1334         if (provider_activate(prov, 0, 0) < 0) {
1335             ossl_provider_free(prov);
1336             goto err;
1337         }
1338         prov->store = store;
1339         if (sk_OSSL_PROVIDER_push(store->providers, prov) == 0) {
1340             ossl_provider_free(prov);
1341             goto err;
1342         }
1343         activated_fallback_count++;
1344     }
1345
1346     if (activated_fallback_count > 0) {
1347         store->use_fallbacks = 0;
1348         ret = 1;
1349     }
1350  err:
1351     CRYPTO_THREAD_unlock(store->lock);
1352     return ret;
1353 }
1354
1355 int ossl_provider_doall_activated(OSSL_LIB_CTX *ctx,
1356                                   int (*cb)(OSSL_PROVIDER *provider,
1357                                             void *cbdata),
1358                                   void *cbdata)
1359 {
1360     int ret = 0, curr, max, ref = 0;
1361     struct provider_store_st *store = get_provider_store(ctx);
1362     STACK_OF(OSSL_PROVIDER) *provs = NULL;
1363
1364 #ifndef FIPS_MODULE
1365     /*
1366      * Make sure any providers are loaded from config before we try to use
1367      * them.
1368      */
1369     if (ossl_lib_ctx_is_default(ctx))
1370         OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL);
1371 #endif
1372
1373     if (store == NULL)
1374         return 1;
1375     if (!provider_activate_fallbacks(store))
1376         return 0;
1377
1378     /*
1379      * Under lock, grab a copy of the provider list and up_ref each
1380      * provider so that they don't disappear underneath us.
1381      */
1382     if (!CRYPTO_THREAD_read_lock(store->lock))
1383         return 0;
1384     provs = sk_OSSL_PROVIDER_dup(store->providers);
1385     if (provs == NULL) {
1386         CRYPTO_THREAD_unlock(store->lock);
1387         return 0;
1388     }
1389     max = sk_OSSL_PROVIDER_num(provs);
1390     /*
1391      * We work backwards through the stack so that we can safely delete items
1392      * as we go.
1393      */
1394     for (curr = max - 1; curr >= 0; curr--) {
1395         OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1396
1397         if (!CRYPTO_THREAD_write_lock(prov->flag_lock))
1398             goto err_unlock;
1399         if (prov->flag_activated) {
1400             /*
1401              * We call CRYPTO_UP_REF directly rather than ossl_provider_up_ref
1402              * to avoid upping the ref count on the parent provider, which we
1403              * must not do while holding locks.
1404              */
1405             if (CRYPTO_UP_REF(&prov->refcnt, &ref, prov->refcnt_lock) <= 0) {
1406                 CRYPTO_THREAD_unlock(prov->flag_lock);
1407                 goto err_unlock;
1408             }
1409             /*
1410              * It's already activated, but we up the activated count to ensure
1411              * it remains activated until after we've called the user callback.
1412              * We do this with no locking (because we already hold the locks)
1413              * and no upcalls (which must not be called when locks are held). In
1414              * theory this could mean the parent provider goes inactive, whilst
1415              * still activated in the child for a short period. That's ok.
1416              */
1417             if (provider_activate(prov, 0, 0) < 0) {
1418                 CRYPTO_DOWN_REF(&prov->refcnt, &ref, prov->refcnt_lock);
1419                 CRYPTO_THREAD_unlock(prov->flag_lock);
1420                 goto err_unlock;
1421             }
1422         } else {
1423             sk_OSSL_PROVIDER_delete(provs, curr);
1424             max--;
1425         }
1426         CRYPTO_THREAD_unlock(prov->flag_lock);
1427     }
1428     CRYPTO_THREAD_unlock(store->lock);
1429
1430     /*
1431      * Now, we sweep through all providers not under lock
1432      */
1433     for (curr = 0; curr < max; curr++) {
1434         OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1435
1436         if (!cb(prov, cbdata)) {
1437             curr = -1;
1438             goto finish;
1439         }
1440     }
1441     curr = -1;
1442
1443     ret = 1;
1444     goto finish;
1445
1446  err_unlock:
1447     CRYPTO_THREAD_unlock(store->lock);
1448  finish:
1449     /*
1450      * The pop_free call doesn't do what we want on an error condition. We
1451      * either start from the first item in the stack, or part way through if
1452      * we only processed some of the items.
1453      */
1454     for (curr++; curr < max; curr++) {
1455         OSSL_PROVIDER *prov = sk_OSSL_PROVIDER_value(provs, curr);
1456
1457         provider_deactivate(prov, 0, 1);
1458         /*
1459          * As above where we did the up-ref, we don't call ossl_provider_free
1460          * to avoid making upcalls. There should always be at least one ref
1461          * to the provider in the store, so this should never drop to 0.
1462          */
1463         CRYPTO_DOWN_REF(&prov->refcnt, &ref, prov->refcnt_lock);
1464         /*
1465          * Not much we can do if this assert ever fails. So we don't use
1466          * ossl_assert here.
1467          */
1468         assert(ref > 0);
1469     }
1470     sk_OSSL_PROVIDER_free(provs);
1471     return ret;
1472 }
1473
1474 int OSSL_PROVIDER_available(OSSL_LIB_CTX *libctx, const char *name)
1475 {
1476     OSSL_PROVIDER *prov = NULL;
1477     int available = 0;
1478     struct provider_store_st *store = get_provider_store(libctx);
1479
1480     if (store == NULL || !provider_activate_fallbacks(store))
1481         return 0;
1482
1483     prov = ossl_provider_find(libctx, name, 0);
1484     if (prov != NULL) {
1485         if (!CRYPTO_THREAD_read_lock(prov->flag_lock))
1486             return 0;
1487         available = prov->flag_activated;
1488         CRYPTO_THREAD_unlock(prov->flag_lock);
1489         ossl_provider_free(prov);
1490     }
1491     return available;
1492 }
1493
1494 /* Getters of Provider Object data */
1495 const char *ossl_provider_name(const OSSL_PROVIDER *prov)
1496 {
1497     return prov->name;
1498 }
1499
1500 const DSO *ossl_provider_dso(const OSSL_PROVIDER *prov)
1501 {
1502     return prov->module;
1503 }
1504
1505 const char *ossl_provider_module_name(const OSSL_PROVIDER *prov)
1506 {
1507 #ifdef FIPS_MODULE
1508     return NULL;
1509 #else
1510     return DSO_get_filename(prov->module);
1511 #endif
1512 }
1513
1514 const char *ossl_provider_module_path(const OSSL_PROVIDER *prov)
1515 {
1516 #ifdef FIPS_MODULE
1517     return NULL;
1518 #else
1519     /* FIXME: Ensure it's a full path */
1520     return DSO_get_filename(prov->module);
1521 #endif
1522 }
1523
1524 void *ossl_provider_prov_ctx(const OSSL_PROVIDER *prov)
1525 {
1526     if (prov != NULL)
1527         return prov->provctx;
1528
1529     return NULL;
1530 }
1531
1532 const OSSL_DISPATCH *ossl_provider_get0_dispatch(const OSSL_PROVIDER *prov)
1533 {
1534     if (prov != NULL)
1535         return prov->dispatch;
1536
1537     return NULL;
1538 }
1539
1540 OSSL_LIB_CTX *ossl_provider_libctx(const OSSL_PROVIDER *prov)
1541 {
1542     return prov != NULL ? prov->libctx : NULL;
1543 }
1544
1545 /* Wrappers around calls to the provider */
1546 void ossl_provider_teardown(const OSSL_PROVIDER *prov)
1547 {
1548     if (prov->teardown != NULL
1549 #ifndef FIPS_MODULE
1550             && !prov->ischild
1551 #endif
1552        )
1553         prov->teardown(prov->provctx);
1554 }
1555
1556 const OSSL_PARAM *ossl_provider_gettable_params(const OSSL_PROVIDER *prov)
1557 {
1558     return prov->gettable_params == NULL
1559         ? NULL : prov->gettable_params(prov->provctx);
1560 }
1561
1562 int ossl_provider_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
1563 {
1564     return prov->get_params == NULL
1565         ? 0 : prov->get_params(prov->provctx, params);
1566 }
1567
1568 int ossl_provider_self_test(const OSSL_PROVIDER *prov)
1569 {
1570     int ret;
1571
1572     if (prov->self_test == NULL)
1573         return 1;
1574     ret = prov->self_test(prov->provctx);
1575     if (ret == 0)
1576         (void)provider_remove_store_methods((OSSL_PROVIDER *)prov);
1577     return ret;
1578 }
1579
1580 int ossl_provider_get_capabilities(const OSSL_PROVIDER *prov,
1581                                    const char *capability,
1582                                    OSSL_CALLBACK *cb,
1583                                    void *arg)
1584 {
1585     return prov->get_capabilities == NULL
1586         ? 1 : prov->get_capabilities(prov->provctx, capability, cb, arg);
1587 }
1588
1589 const OSSL_ALGORITHM *ossl_provider_query_operation(const OSSL_PROVIDER *prov,
1590                                                     int operation_id,
1591                                                     int *no_cache)
1592 {
1593     const OSSL_ALGORITHM *res;
1594
1595     if (prov->query_operation == NULL)
1596         return NULL;
1597     res = prov->query_operation(prov->provctx, operation_id, no_cache);
1598 #if defined(OPENSSL_NO_CACHED_FETCH)
1599     /* Forcing the non-caching of queries */
1600     if (no_cache != NULL)
1601         *no_cache = 1;
1602 #endif
1603     return res;
1604 }
1605
1606 void ossl_provider_unquery_operation(const OSSL_PROVIDER *prov,
1607                                      int operation_id,
1608                                      const OSSL_ALGORITHM *algs)
1609 {
1610     if (prov->unquery_operation != NULL)
1611         prov->unquery_operation(prov->provctx, operation_id, algs);
1612 }
1613
1614 int ossl_provider_set_operation_bit(OSSL_PROVIDER *provider, size_t bitnum)
1615 {
1616     size_t byte = bitnum / 8;
1617     unsigned char bit = (1 << (bitnum % 8)) & 0xFF;
1618
1619     if (!CRYPTO_THREAD_write_lock(provider->opbits_lock))
1620         return 0;
1621     if (provider->operation_bits_sz <= byte) {
1622         unsigned char *tmp = OPENSSL_realloc(provider->operation_bits,
1623                                              byte + 1);
1624
1625         if (tmp == NULL) {
1626             CRYPTO_THREAD_unlock(provider->opbits_lock);
1627             return 0;
1628         }
1629         provider->operation_bits = tmp;
1630         memset(provider->operation_bits + provider->operation_bits_sz,
1631                '\0', byte + 1 - provider->operation_bits_sz);
1632         provider->operation_bits_sz = byte + 1;
1633     }
1634     provider->operation_bits[byte] |= bit;
1635     CRYPTO_THREAD_unlock(provider->opbits_lock);
1636     return 1;
1637 }
1638
1639 int ossl_provider_test_operation_bit(OSSL_PROVIDER *provider, size_t bitnum,
1640                                      int *result)
1641 {
1642     size_t byte = bitnum / 8;
1643     unsigned char bit = (1 << (bitnum % 8)) & 0xFF;
1644
1645     if (!ossl_assert(result != NULL)) {
1646         ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
1647         return 0;
1648     }
1649
1650     *result = 0;
1651     if (!CRYPTO_THREAD_read_lock(provider->opbits_lock))
1652         return 0;
1653     if (provider->operation_bits_sz > byte)
1654         *result = ((provider->operation_bits[byte] & bit) != 0);
1655     CRYPTO_THREAD_unlock(provider->opbits_lock);
1656     return 1;
1657 }
1658
1659 #ifndef FIPS_MODULE
1660 const OSSL_CORE_HANDLE *ossl_provider_get_parent(OSSL_PROVIDER *prov)
1661 {
1662     return prov->handle;
1663 }
1664
1665 int ossl_provider_is_child(const OSSL_PROVIDER *prov)
1666 {
1667     return prov->ischild;
1668 }
1669
1670 int ossl_provider_set_child(OSSL_PROVIDER *prov, const OSSL_CORE_HANDLE *handle)
1671 {
1672     prov->handle = handle;
1673     prov->ischild = 1;
1674
1675     return 1;
1676 }
1677
1678 int ossl_provider_default_props_update(OSSL_LIB_CTX *libctx, const char *props)
1679 {
1680 #ifndef FIPS_MODULE
1681     struct provider_store_st *store = NULL;
1682     int i, max;
1683     OSSL_PROVIDER_CHILD_CB *child_cb;
1684
1685     if ((store = get_provider_store(libctx)) == NULL)
1686         return 0;
1687
1688     if (!CRYPTO_THREAD_read_lock(store->lock))
1689         return 0;
1690
1691     max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1692     for (i = 0; i < max; i++) {
1693         child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1694         child_cb->global_props_cb(props, child_cb->cbdata);
1695     }
1696
1697     CRYPTO_THREAD_unlock(store->lock);
1698 #endif
1699     return 1;
1700 }
1701
1702 static int ossl_provider_register_child_cb(const OSSL_CORE_HANDLE *handle,
1703                                            int (*create_cb)(
1704                                                const OSSL_CORE_HANDLE *provider,
1705                                                void *cbdata),
1706                                            int (*remove_cb)(
1707                                                const OSSL_CORE_HANDLE *provider,
1708                                                void *cbdata),
1709                                            int (*global_props_cb)(
1710                                                const char *props,
1711                                                void *cbdata),
1712                                            void *cbdata)
1713 {
1714     /*
1715      * This is really an OSSL_PROVIDER that we created and cast to
1716      * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1717      */
1718     OSSL_PROVIDER *thisprov = (OSSL_PROVIDER *)handle;
1719     OSSL_PROVIDER *prov;
1720     OSSL_LIB_CTX *libctx = thisprov->libctx;
1721     struct provider_store_st *store = NULL;
1722     int ret = 0, i, max;
1723     OSSL_PROVIDER_CHILD_CB *child_cb;
1724     char *propsstr = NULL;
1725
1726     if ((store = get_provider_store(libctx)) == NULL)
1727         return 0;
1728
1729     child_cb = OPENSSL_malloc(sizeof(*child_cb));
1730     if (child_cb == NULL)
1731         return 0;
1732     child_cb->prov = thisprov;
1733     child_cb->create_cb = create_cb;
1734     child_cb->remove_cb = remove_cb;
1735     child_cb->global_props_cb = global_props_cb;
1736     child_cb->cbdata = cbdata;
1737
1738     if (!CRYPTO_THREAD_write_lock(store->lock)) {
1739         OPENSSL_free(child_cb);
1740         return 0;
1741     }
1742     propsstr = evp_get_global_properties_str(libctx, 0);
1743
1744     if (propsstr != NULL) {
1745         global_props_cb(propsstr, cbdata);
1746         OPENSSL_free(propsstr);
1747     }
1748     max = sk_OSSL_PROVIDER_num(store->providers);
1749     for (i = 0; i < max; i++) {
1750         int activated;
1751
1752         prov = sk_OSSL_PROVIDER_value(store->providers, i);
1753
1754         if (!CRYPTO_THREAD_read_lock(prov->flag_lock))
1755             break;
1756         activated = prov->flag_activated;
1757         CRYPTO_THREAD_unlock(prov->flag_lock);
1758         /*
1759          * We hold the store lock while calling the user callback. This means
1760          * that the user callback must be short and simple and not do anything
1761          * likely to cause a deadlock. We don't hold the flag_lock during this
1762          * call. In theory this means that another thread could deactivate it
1763          * while we are calling create. This is ok because the other thread
1764          * will also call remove_cb, but won't be able to do so until we release
1765          * the store lock.
1766          */
1767         if (activated && !create_cb((OSSL_CORE_HANDLE *)prov, cbdata))
1768             break;
1769     }
1770     if (i == max) {
1771         /* Success */
1772         ret = sk_OSSL_PROVIDER_CHILD_CB_push(store->child_cbs, child_cb);
1773     }
1774     if (i != max || ret <= 0) {
1775         /* Failed during creation. Remove everything we just added */
1776         for (; i >= 0; i--) {
1777             prov = sk_OSSL_PROVIDER_value(store->providers, i);
1778             remove_cb((OSSL_CORE_HANDLE *)prov, cbdata);
1779         }
1780         OPENSSL_free(child_cb);
1781         ret = 0;
1782     }
1783     CRYPTO_THREAD_unlock(store->lock);
1784
1785     return ret;
1786 }
1787
1788 static void ossl_provider_deregister_child_cb(const OSSL_CORE_HANDLE *handle)
1789 {
1790     /*
1791      * This is really an OSSL_PROVIDER that we created and cast to
1792      * OSSL_CORE_HANDLE originally. Therefore it is safe to cast it back.
1793      */
1794     OSSL_PROVIDER *thisprov = (OSSL_PROVIDER *)handle;
1795     OSSL_LIB_CTX *libctx = thisprov->libctx;
1796     struct provider_store_st *store = NULL;
1797     int i, max;
1798     OSSL_PROVIDER_CHILD_CB *child_cb;
1799
1800     if ((store = get_provider_store(libctx)) == NULL)
1801         return;
1802
1803     if (!CRYPTO_THREAD_write_lock(store->lock))
1804         return;
1805     max = sk_OSSL_PROVIDER_CHILD_CB_num(store->child_cbs);
1806     for (i = 0; i < max; i++) {
1807         child_cb = sk_OSSL_PROVIDER_CHILD_CB_value(store->child_cbs, i);
1808         if (child_cb->prov == thisprov) {
1809             /* Found an entry */
1810             sk_OSSL_PROVIDER_CHILD_CB_delete(store->child_cbs, i);
1811             OPENSSL_free(child_cb);
1812             break;
1813         }
1814     }
1815     CRYPTO_THREAD_unlock(store->lock);
1816 }
1817 #endif
1818
1819 /*-
1820  * Core functions for the provider
1821  * ===============================
1822  *
1823  * This is the set of functions that the core makes available to the provider
1824  */
1825
1826 /*
1827  * This returns a list of Provider Object parameters with their types, for
1828  * discovery.  We do not expect that many providers will use this, but one
1829  * never knows.
1830  */
1831 static const OSSL_PARAM param_types[] = {
1832     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_VERSION, OSSL_PARAM_UTF8_PTR, NULL, 0),
1833     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_PROV_NAME, OSSL_PARAM_UTF8_PTR,
1834                     NULL, 0),
1835 #ifndef FIPS_MODULE
1836     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_CORE_MODULE_FILENAME, OSSL_PARAM_UTF8_PTR,
1837                     NULL, 0),
1838 #endif
1839     OSSL_PARAM_END
1840 };
1841
1842 /*
1843  * Forward declare all the functions that are provided aa dispatch.
1844  * This ensures that the compiler will complain if they aren't defined
1845  * with the correct signature.
1846  */
1847 static OSSL_FUNC_core_gettable_params_fn core_gettable_params;
1848 static OSSL_FUNC_core_get_params_fn core_get_params;
1849 static OSSL_FUNC_core_get_libctx_fn core_get_libctx;
1850 static OSSL_FUNC_core_thread_start_fn core_thread_start;
1851 #ifndef FIPS_MODULE
1852 static OSSL_FUNC_core_new_error_fn core_new_error;
1853 static OSSL_FUNC_core_set_error_debug_fn core_set_error_debug;
1854 static OSSL_FUNC_core_vset_error_fn core_vset_error;
1855 static OSSL_FUNC_core_set_error_mark_fn core_set_error_mark;
1856 static OSSL_FUNC_core_clear_last_error_mark_fn core_clear_last_error_mark;
1857 static OSSL_FUNC_core_pop_error_to_mark_fn core_pop_error_to_mark;
1858 OSSL_FUNC_BIO_new_file_fn ossl_core_bio_new_file;
1859 OSSL_FUNC_BIO_new_membuf_fn ossl_core_bio_new_mem_buf;
1860 OSSL_FUNC_BIO_read_ex_fn ossl_core_bio_read_ex;
1861 OSSL_FUNC_BIO_write_ex_fn ossl_core_bio_write_ex;
1862 OSSL_FUNC_BIO_gets_fn ossl_core_bio_gets;
1863 OSSL_FUNC_BIO_puts_fn ossl_core_bio_puts;
1864 OSSL_FUNC_BIO_up_ref_fn ossl_core_bio_up_ref;
1865 OSSL_FUNC_BIO_free_fn ossl_core_bio_free;
1866 OSSL_FUNC_BIO_vprintf_fn ossl_core_bio_vprintf;
1867 OSSL_FUNC_BIO_vsnprintf_fn BIO_vsnprintf;
1868 static OSSL_FUNC_self_test_cb_fn core_self_test_get_callback;
1869 OSSL_FUNC_get_entropy_fn ossl_rand_get_entropy;
1870 OSSL_FUNC_cleanup_entropy_fn ossl_rand_cleanup_entropy;
1871 OSSL_FUNC_get_nonce_fn ossl_rand_get_nonce;
1872 OSSL_FUNC_cleanup_nonce_fn ossl_rand_cleanup_nonce;
1873 #endif
1874 OSSL_FUNC_CRYPTO_malloc_fn CRYPTO_malloc;
1875 OSSL_FUNC_CRYPTO_zalloc_fn CRYPTO_zalloc;
1876 OSSL_FUNC_CRYPTO_free_fn CRYPTO_free;
1877 OSSL_FUNC_CRYPTO_clear_free_fn CRYPTO_clear_free;
1878 OSSL_FUNC_CRYPTO_realloc_fn CRYPTO_realloc;
1879 OSSL_FUNC_CRYPTO_clear_realloc_fn CRYPTO_clear_realloc;
1880 OSSL_FUNC_CRYPTO_secure_malloc_fn CRYPTO_secure_malloc;
1881 OSSL_FUNC_CRYPTO_secure_zalloc_fn CRYPTO_secure_zalloc;
1882 OSSL_FUNC_CRYPTO_secure_free_fn CRYPTO_secure_free;
1883 OSSL_FUNC_CRYPTO_secure_clear_free_fn CRYPTO_secure_clear_free;
1884 OSSL_FUNC_CRYPTO_secure_allocated_fn CRYPTO_secure_allocated;
1885 OSSL_FUNC_OPENSSL_cleanse_fn OPENSSL_cleanse;
1886 #ifndef FIPS_MODULE
1887 OSSL_FUNC_provider_register_child_cb_fn ossl_provider_register_child_cb;
1888 OSSL_FUNC_provider_deregister_child_cb_fn ossl_provider_deregister_child_cb;
1889 static OSSL_FUNC_provider_name_fn core_provider_get0_name;
1890 static OSSL_FUNC_provider_get0_provider_ctx_fn core_provider_get0_provider_ctx;
1891 static OSSL_FUNC_provider_get0_dispatch_fn core_provider_get0_dispatch;
1892 static OSSL_FUNC_provider_up_ref_fn core_provider_up_ref_intern;
1893 static OSSL_FUNC_provider_free_fn core_provider_free_intern;
1894 static OSSL_FUNC_core_obj_add_sigid_fn core_obj_add_sigid;
1895 static OSSL_FUNC_core_obj_create_fn core_obj_create;
1896 #endif
1897
1898 static const OSSL_PARAM *core_gettable_params(const OSSL_CORE_HANDLE *handle)
1899 {
1900     return param_types;
1901 }
1902
1903 static int core_get_params(const OSSL_CORE_HANDLE *handle, OSSL_PARAM params[])
1904 {
1905     int i;
1906     OSSL_PARAM *p;
1907     /*
1908      * We created this object originally and we know it is actually an
1909      * OSSL_PROVIDER *, so the cast is safe
1910      */
1911     OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
1912
1913     if ((p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_CORE_VERSION)) != NULL)
1914         OSSL_PARAM_set_utf8_ptr(p, OPENSSL_VERSION_STR);
1915     if ((p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_CORE_PROV_NAME)) != NULL)
1916         OSSL_PARAM_set_utf8_ptr(p, prov->name);
1917
1918 #ifndef FIPS_MODULE
1919     if ((p = OSSL_PARAM_locate(params,
1920                                OSSL_PROV_PARAM_CORE_MODULE_FILENAME)) != NULL)
1921         OSSL_PARAM_set_utf8_ptr(p, ossl_provider_module_path(prov));
1922 #endif
1923
1924     if (prov->parameters == NULL)
1925         return 1;
1926
1927     for (i = 0; i < sk_INFOPAIR_num(prov->parameters); i++) {
1928         INFOPAIR *pair = sk_INFOPAIR_value(prov->parameters, i);
1929
1930         if ((p = OSSL_PARAM_locate(params, pair->name)) != NULL)
1931             OSSL_PARAM_set_utf8_ptr(p, pair->value);
1932     }
1933     return 1;
1934 }
1935
1936 static OPENSSL_CORE_CTX *core_get_libctx(const OSSL_CORE_HANDLE *handle)
1937 {
1938     /*
1939      * We created this object originally and we know it is actually an
1940      * OSSL_PROVIDER *, so the cast is safe
1941      */
1942     OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
1943
1944     /*
1945      * Using ossl_provider_libctx would be wrong as that returns
1946      * NULL for |prov| == NULL and NULL libctx has a special meaning
1947      * that does not apply here. Here |prov| == NULL can happen only in
1948      * case of a coding error.
1949      */
1950     assert(prov != NULL);
1951     return (OPENSSL_CORE_CTX *)prov->libctx;
1952 }
1953
1954 static int core_thread_start(const OSSL_CORE_HANDLE *handle,
1955                              OSSL_thread_stop_handler_fn handfn,
1956                              void *arg)
1957 {
1958     /*
1959      * We created this object originally and we know it is actually an
1960      * OSSL_PROVIDER *, so the cast is safe
1961      */
1962     OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
1963
1964     return ossl_init_thread_start(prov, arg, handfn);
1965 }
1966
1967 /*
1968  * The FIPS module inner provider doesn't implement these.  They aren't
1969  * needed there, since the FIPS module upcalls are always the outer provider
1970  * ones.
1971  */
1972 #ifndef FIPS_MODULE
1973 /*
1974  * These error functions should use |handle| to select the proper
1975  * library context to report in the correct error stack if error
1976  * stacks become tied to the library context.
1977  * We cannot currently do that since there's no support for it in the
1978  * ERR subsystem.
1979  */
1980 static void core_new_error(const OSSL_CORE_HANDLE *handle)
1981 {
1982     ERR_new();
1983 }
1984
1985 static void core_set_error_debug(const OSSL_CORE_HANDLE *handle,
1986                                  const char *file, int line, const char *func)
1987 {
1988     ERR_set_debug(file, line, func);
1989 }
1990
1991 static void core_vset_error(const OSSL_CORE_HANDLE *handle,
1992                             uint32_t reason, const char *fmt, va_list args)
1993 {
1994     /*
1995      * We created this object originally and we know it is actually an
1996      * OSSL_PROVIDER *, so the cast is safe
1997      */
1998     OSSL_PROVIDER *prov = (OSSL_PROVIDER *)handle;
1999
2000     /*
2001      * If the uppermost 8 bits are non-zero, it's an OpenSSL library
2002      * error and will be treated as such.  Otherwise, it's a new style
2003      * provider error and will be treated as such.
2004      */
2005     if (ERR_GET_LIB(reason) != 0) {
2006         ERR_vset_error(ERR_GET_LIB(reason), ERR_GET_REASON(reason), fmt, args);
2007     } else {
2008         ERR_vset_error(prov->error_lib, (int)reason, fmt, args);
2009     }
2010 }
2011
2012 static int core_set_error_mark(const OSSL_CORE_HANDLE *handle)
2013 {
2014     return ERR_set_mark();
2015 }
2016
2017 static int core_clear_last_error_mark(const OSSL_CORE_HANDLE *handle)
2018 {
2019     return ERR_clear_last_mark();
2020 }
2021
2022 static int core_pop_error_to_mark(const OSSL_CORE_HANDLE *handle)
2023 {
2024     return ERR_pop_to_mark();
2025 }
2026
2027 static void core_self_test_get_callback(OPENSSL_CORE_CTX *libctx,
2028                                         OSSL_CALLBACK **cb, void **cbarg)
2029 {
2030     OSSL_SELF_TEST_get_callback((OSSL_LIB_CTX *)libctx, cb, cbarg);
2031 }
2032
2033 static const char *core_provider_get0_name(const OSSL_CORE_HANDLE *prov)
2034 {
2035     return OSSL_PROVIDER_get0_name((const OSSL_PROVIDER *)prov);
2036 }
2037
2038 static void *core_provider_get0_provider_ctx(const OSSL_CORE_HANDLE *prov)
2039 {
2040     return OSSL_PROVIDER_get0_provider_ctx((const OSSL_PROVIDER *)prov);
2041 }
2042
2043 static const OSSL_DISPATCH *
2044 core_provider_get0_dispatch(const OSSL_CORE_HANDLE *prov)
2045 {
2046     return OSSL_PROVIDER_get0_dispatch((const OSSL_PROVIDER *)prov);
2047 }
2048
2049 static int core_provider_up_ref_intern(const OSSL_CORE_HANDLE *prov,
2050                                        int activate)
2051 {
2052     return provider_up_ref_intern((OSSL_PROVIDER *)prov, activate);
2053 }
2054
2055 static int core_provider_free_intern(const OSSL_CORE_HANDLE *prov,
2056                                      int deactivate)
2057 {
2058     return provider_free_intern((OSSL_PROVIDER *)prov, deactivate);
2059 }
2060
2061 static int core_obj_add_sigid(const OSSL_CORE_HANDLE *prov,
2062                               const char *sign_name, const char *digest_name,
2063                               const char *pkey_name)
2064 {
2065     int sign_nid = OBJ_txt2nid(sign_name);
2066     int digest_nid = NID_undef;
2067     int pkey_nid = OBJ_txt2nid(pkey_name);
2068
2069     if (digest_name != NULL && digest_name[0] != '\0'
2070         && (digest_nid = OBJ_txt2nid(digest_name)) == NID_undef)
2071             return 0;
2072
2073     if (sign_nid == NID_undef)
2074         return 0;
2075
2076     /*
2077      * Check if it already exists. This is a success if so (even if we don't
2078      * have nids for the digest/pkey)
2079      */
2080     if (OBJ_find_sigid_algs(sign_nid, NULL, NULL))
2081         return 1;
2082
2083     if (pkey_nid == NID_undef)
2084         return 0;
2085
2086     return OBJ_add_sigid(sign_nid, digest_nid, pkey_nid);
2087 }
2088
2089 static int core_obj_create(const OSSL_CORE_HANDLE *prov, const char *oid,
2090                            const char *sn, const char *ln)
2091 {
2092     /* Check if it already exists and create it if not */
2093     return OBJ_txt2nid(oid) != NID_undef
2094            || OBJ_create(oid, sn, ln) != NID_undef;
2095 }
2096 #endif /* FIPS_MODULE */
2097
2098 /*
2099  * Functions provided by the core.
2100  */
2101 static const OSSL_DISPATCH core_dispatch_[] = {
2102     { OSSL_FUNC_CORE_GETTABLE_PARAMS, (void (*)(void))core_gettable_params },
2103     { OSSL_FUNC_CORE_GET_PARAMS, (void (*)(void))core_get_params },
2104     { OSSL_FUNC_CORE_GET_LIBCTX, (void (*)(void))core_get_libctx },
2105     { OSSL_FUNC_CORE_THREAD_START, (void (*)(void))core_thread_start },
2106 #ifndef FIPS_MODULE
2107     { OSSL_FUNC_CORE_NEW_ERROR, (void (*)(void))core_new_error },
2108     { OSSL_FUNC_CORE_SET_ERROR_DEBUG, (void (*)(void))core_set_error_debug },
2109     { OSSL_FUNC_CORE_VSET_ERROR, (void (*)(void))core_vset_error },
2110     { OSSL_FUNC_CORE_SET_ERROR_MARK, (void (*)(void))core_set_error_mark },
2111     { OSSL_FUNC_CORE_CLEAR_LAST_ERROR_MARK,
2112       (void (*)(void))core_clear_last_error_mark },
2113     { OSSL_FUNC_CORE_POP_ERROR_TO_MARK, (void (*)(void))core_pop_error_to_mark },
2114     { OSSL_FUNC_BIO_NEW_FILE, (void (*)(void))ossl_core_bio_new_file },
2115     { OSSL_FUNC_BIO_NEW_MEMBUF, (void (*)(void))ossl_core_bio_new_mem_buf },
2116     { OSSL_FUNC_BIO_READ_EX, (void (*)(void))ossl_core_bio_read_ex },
2117     { OSSL_FUNC_BIO_WRITE_EX, (void (*)(void))ossl_core_bio_write_ex },
2118     { OSSL_FUNC_BIO_GETS, (void (*)(void))ossl_core_bio_gets },
2119     { OSSL_FUNC_BIO_PUTS, (void (*)(void))ossl_core_bio_puts },
2120     { OSSL_FUNC_BIO_CTRL, (void (*)(void))ossl_core_bio_ctrl },
2121     { OSSL_FUNC_BIO_UP_REF, (void (*)(void))ossl_core_bio_up_ref },
2122     { OSSL_FUNC_BIO_FREE, (void (*)(void))ossl_core_bio_free },
2123     { OSSL_FUNC_BIO_VPRINTF, (void (*)(void))ossl_core_bio_vprintf },
2124     { OSSL_FUNC_BIO_VSNPRINTF, (void (*)(void))BIO_vsnprintf },
2125     { OSSL_FUNC_SELF_TEST_CB, (void (*)(void))core_self_test_get_callback },
2126     { OSSL_FUNC_GET_ENTROPY, (void (*)(void))ossl_rand_get_entropy },
2127     { OSSL_FUNC_CLEANUP_ENTROPY, (void (*)(void))ossl_rand_cleanup_entropy },
2128     { OSSL_FUNC_GET_NONCE, (void (*)(void))ossl_rand_get_nonce },
2129     { OSSL_FUNC_CLEANUP_NONCE, (void (*)(void))ossl_rand_cleanup_nonce },
2130 #endif
2131     { OSSL_FUNC_CRYPTO_MALLOC, (void (*)(void))CRYPTO_malloc },
2132     { OSSL_FUNC_CRYPTO_ZALLOC, (void (*)(void))CRYPTO_zalloc },
2133     { OSSL_FUNC_CRYPTO_FREE, (void (*)(void))CRYPTO_free },
2134     { OSSL_FUNC_CRYPTO_CLEAR_FREE, (void (*)(void))CRYPTO_clear_free },
2135     { OSSL_FUNC_CRYPTO_REALLOC, (void (*)(void))CRYPTO_realloc },
2136     { OSSL_FUNC_CRYPTO_CLEAR_REALLOC, (void (*)(void))CRYPTO_clear_realloc },
2137     { OSSL_FUNC_CRYPTO_SECURE_MALLOC, (void (*)(void))CRYPTO_secure_malloc },
2138     { OSSL_FUNC_CRYPTO_SECURE_ZALLOC, (void (*)(void))CRYPTO_secure_zalloc },
2139     { OSSL_FUNC_CRYPTO_SECURE_FREE, (void (*)(void))CRYPTO_secure_free },
2140     { OSSL_FUNC_CRYPTO_SECURE_CLEAR_FREE,
2141         (void (*)(void))CRYPTO_secure_clear_free },
2142     { OSSL_FUNC_CRYPTO_SECURE_ALLOCATED,
2143         (void (*)(void))CRYPTO_secure_allocated },
2144     { OSSL_FUNC_OPENSSL_CLEANSE, (void (*)(void))OPENSSL_cleanse },
2145 #ifndef FIPS_MODULE
2146     { OSSL_FUNC_PROVIDER_REGISTER_CHILD_CB,
2147         (void (*)(void))ossl_provider_register_child_cb },
2148     { OSSL_FUNC_PROVIDER_DEREGISTER_CHILD_CB,
2149         (void (*)(void))ossl_provider_deregister_child_cb },
2150     { OSSL_FUNC_PROVIDER_NAME,
2151         (void (*)(void))core_provider_get0_name },
2152     { OSSL_FUNC_PROVIDER_GET0_PROVIDER_CTX,
2153         (void (*)(void))core_provider_get0_provider_ctx },
2154     { OSSL_FUNC_PROVIDER_GET0_DISPATCH,
2155         (void (*)(void))core_provider_get0_dispatch },
2156     { OSSL_FUNC_PROVIDER_UP_REF,
2157         (void (*)(void))core_provider_up_ref_intern },
2158     { OSSL_FUNC_PROVIDER_FREE,
2159         (void (*)(void))core_provider_free_intern },
2160     { OSSL_FUNC_CORE_OBJ_ADD_SIGID, (void (*)(void))core_obj_add_sigid },
2161     { OSSL_FUNC_CORE_OBJ_CREATE, (void (*)(void))core_obj_create },
2162 #endif
2163     { 0, NULL }
2164 };
2165 static const OSSL_DISPATCH *core_dispatch = core_dispatch_;