/src/openssl/crypto/provider.c
Line  | Count  | Source (jump to first uncovered line)  | 
1  |  | /*  | 
2  |  |  * Copyright 2019-2025 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 <string.h>  | 
11  |  | #include <openssl/err.h>  | 
12  |  | #include <openssl/cryptoerr.h>  | 
13  |  | #include <openssl/provider.h>  | 
14  |  | #include <openssl/core_names.h>  | 
15  |  | #include "internal/provider.h"  | 
16  |  | #include "provider_local.h"  | 
17  |  |  | 
18  |  | OSSL_PROVIDER *OSSL_PROVIDER_try_load_ex(OSSL_LIB_CTX *libctx, const char *name,  | 
19  |  |                                          OSSL_PARAM *params, int retain_fallbacks)  | 
20  | 0  | { | 
21  | 0  |     OSSL_PROVIDER *prov = NULL, *actual;  | 
22  | 0  |     int isnew = 0;  | 
23  |  |  | 
24  |  |     /* Find it or create it */  | 
25  | 0  |     if ((prov = ossl_provider_find(libctx, name, 0)) == NULL) { | 
26  | 0  |         if ((prov = ossl_provider_new(libctx, name, NULL, params, 0)) == NULL)  | 
27  | 0  |             return NULL;  | 
28  | 0  |         isnew = 1;  | 
29  | 0  |     }  | 
30  |  |  | 
31  | 0  |     if (!ossl_provider_activate(prov, 1, 0)) { | 
32  | 0  |         ossl_provider_free(prov);  | 
33  | 0  |         return NULL;  | 
34  | 0  |     }  | 
35  |  |  | 
36  | 0  |     actual = prov;  | 
37  | 0  |     if (isnew && !ossl_provider_add_to_store(prov, &actual, retain_fallbacks)) { | 
38  | 0  |         ossl_provider_deactivate(prov, 1);  | 
39  | 0  |         ossl_provider_free(prov);  | 
40  | 0  |         return NULL;  | 
41  | 0  |     }  | 
42  | 0  |     if (actual != prov) { | 
43  | 0  |         if (!ossl_provider_activate(actual, 1, 0)) { | 
44  | 0  |             ossl_provider_free(actual);  | 
45  | 0  |             return NULL;  | 
46  | 0  |         }  | 
47  | 0  |     }  | 
48  |  |  | 
49  | 0  |     return actual;  | 
50  | 0  | }  | 
51  |  |  | 
52  |  | OSSL_PROVIDER *OSSL_PROVIDER_try_load(OSSL_LIB_CTX *libctx, const char *name,  | 
53  |  |                                       int retain_fallbacks)  | 
54  | 0  | { | 
55  | 0  |     return OSSL_PROVIDER_try_load_ex(libctx, name, NULL, retain_fallbacks);  | 
56  | 0  | }  | 
57  |  |  | 
58  |  | OSSL_PROVIDER *OSSL_PROVIDER_load_ex(OSSL_LIB_CTX *libctx, const char *name, OSSL_PARAM *params)  | 
59  | 0  | { | 
60  |  |     /* Any attempt to load a provider disables auto-loading of defaults */  | 
61  | 0  |     if (ossl_provider_disable_fallback_loading(libctx))  | 
62  | 0  |         return OSSL_PROVIDER_try_load_ex(libctx, name, params, 0);  | 
63  | 0  |     return NULL;  | 
64  | 0  | }  | 
65  |  |  | 
66  |  | OSSL_PROVIDER *OSSL_PROVIDER_load(OSSL_LIB_CTX *libctx, const char *name)  | 
67  | 0  | { | 
68  | 0  |     return OSSL_PROVIDER_load_ex(libctx, name, NULL);  | 
69  | 0  | }  | 
70  |  |  | 
71  |  | int OSSL_PROVIDER_unload(OSSL_PROVIDER *prov)  | 
72  | 0  | { | 
73  | 0  |     if (!ossl_provider_deactivate(prov, 1))  | 
74  | 0  |         return 0;  | 
75  | 0  |     ossl_provider_free(prov);  | 
76  | 0  |     return 1;  | 
77  | 0  | }  | 
78  |  |  | 
79  |  | const OSSL_PARAM *OSSL_PROVIDER_gettable_params(const OSSL_PROVIDER *prov)  | 
80  | 0  | { | 
81  | 0  |     return ossl_provider_gettable_params(prov);  | 
82  | 0  | }  | 
83  |  |  | 
84  |  | int OSSL_PROVIDER_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])  | 
85  | 0  | { | 
86  | 0  |     return ossl_provider_get_params(prov, params);  | 
87  | 0  | }  | 
88  |  |  | 
89  |  | const OSSL_ALGORITHM *OSSL_PROVIDER_query_operation(const OSSL_PROVIDER *prov,  | 
90  |  |                                                     int operation_id,  | 
91  |  |                                                     int *no_cache)  | 
92  | 0  | { | 
93  | 0  |     return ossl_provider_query_operation(prov, operation_id, no_cache);  | 
94  | 0  | }  | 
95  |  |  | 
96  |  | void OSSL_PROVIDER_unquery_operation(const OSSL_PROVIDER *prov,  | 
97  |  |                                      int operation_id,  | 
98  |  |                                      const OSSL_ALGORITHM *algs)  | 
99  | 0  | { | 
100  | 0  |     ossl_provider_unquery_operation(prov, operation_id, algs);  | 
101  | 0  | }  | 
102  |  |  | 
103  |  | void *OSSL_PROVIDER_get0_provider_ctx(const OSSL_PROVIDER *prov)  | 
104  | 0  | { | 
105  | 0  |     return ossl_provider_ctx(prov);  | 
106  | 0  | }  | 
107  |  |  | 
108  |  | const OSSL_DISPATCH *OSSL_PROVIDER_get0_dispatch(const OSSL_PROVIDER *prov)  | 
109  | 0  | { | 
110  | 0  |     return ossl_provider_get0_dispatch(prov);  | 
111  | 0  | }  | 
112  |  |  | 
113  |  | int OSSL_PROVIDER_self_test(const OSSL_PROVIDER *prov)  | 
114  | 0  | { | 
115  | 0  |     return ossl_provider_self_test(prov);  | 
116  | 0  | }  | 
117  |  |  | 
118  |  | int OSSL_PROVIDER_get_capabilities(const OSSL_PROVIDER *prov,  | 
119  |  |                                    const char *capability,  | 
120  |  |                                    OSSL_CALLBACK *cb,  | 
121  |  |                                    void *arg)  | 
122  | 0  | { | 
123  | 0  |     return ossl_provider_get_capabilities(prov, capability, cb, arg);  | 
124  | 0  | }  | 
125  |  |  | 
126  |  | int OSSL_PROVIDER_add_builtin(OSSL_LIB_CTX *libctx, const char *name,  | 
127  |  |                               OSSL_provider_init_fn *init_fn)  | 
128  | 0  | { | 
129  | 0  |     OSSL_PROVIDER_INFO entry;  | 
130  |  | 
  | 
131  | 0  |     if (name == NULL || init_fn == NULL) { | 
132  | 0  |         ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);  | 
133  | 0  |         return 0;  | 
134  | 0  |     }  | 
135  | 0  |     memset(&entry, 0, sizeof(entry));  | 
136  | 0  |     entry.name = OPENSSL_strdup(name);  | 
137  | 0  |     if (entry.name == NULL)  | 
138  | 0  |         return 0;  | 
139  | 0  |     entry.init = init_fn;  | 
140  | 0  |     if (!ossl_provider_info_add_to_store(libctx, &entry)) { | 
141  | 0  |         ossl_provider_info_clear(&entry);  | 
142  | 0  |         return 0;  | 
143  | 0  |     }  | 
144  | 0  |     return 1;  | 
145  | 0  | }  | 
146  |  |  | 
147  |  | const char *OSSL_PROVIDER_get0_name(const OSSL_PROVIDER *prov)  | 
148  | 0  | { | 
149  | 0  |     return ossl_provider_name(prov);  | 
150  | 0  | }  | 
151  |  |  | 
152  |  | int OSSL_PROVIDER_do_all(OSSL_LIB_CTX *ctx,  | 
153  |  |                          int (*cb)(OSSL_PROVIDER *provider,  | 
154  |  |                                    void *cbdata),  | 
155  |  |                          void *cbdata)  | 
156  | 0  | { | 
157  | 0  |     return ossl_provider_doall_activated(ctx, cb, cbdata);  | 
158  | 0  | }  |