Enable applications to directly call a provider's query operation
[openssl.git] / crypto / provider.c
1 /*
2  * Copyright 2019-2020 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 <openssl/err.h>
11 #include <openssl/cryptoerr.h>
12 #include <openssl/provider.h>
13 #include "internal/provider.h"
14
15 OSSL_PROVIDER *OSSL_PROVIDER_load(OPENSSL_CTX *libctx, const char *name)
16 {
17     OSSL_PROVIDER *prov = NULL;
18
19     /* Find it or create it */
20     if ((prov = ossl_provider_find(libctx, name, 0)) == NULL
21         && (prov = ossl_provider_new(libctx, name, NULL, 0)) == NULL)
22         return NULL;
23
24     if (!ossl_provider_activate(prov)) {
25         ossl_provider_free(prov);
26         return NULL;
27     }
28
29     return prov;
30 }
31
32 int OSSL_PROVIDER_unload(OSSL_PROVIDER *prov)
33 {
34     ossl_provider_free(prov);
35     return 1;
36 }
37
38 int OSSL_PROVIDER_available(OPENSSL_CTX *libctx, const char *name)
39 {
40     OSSL_PROVIDER *prov = NULL;
41     int available = 0;
42
43     /* Find it or create it */
44     prov = ossl_provider_find(libctx, name, 0);
45     available = ossl_provider_available(prov);
46     ossl_provider_free(prov);
47     return available;
48 }
49
50 const OSSL_PARAM *OSSL_PROVIDER_gettable_params(const OSSL_PROVIDER *prov)
51 {
52     return ossl_provider_gettable_params(prov);
53 }
54
55 int OSSL_PROVIDER_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
56 {
57     return ossl_provider_get_params(prov, params);
58 }
59
60
61 const OSSL_ALGORITHM *OSSL_PROVIDER_query_operation(const OSSL_PROVIDER *prov,
62                                                     int operation_id,
63                                                     int *no_cache)
64 {
65     return ossl_provider_query_operation(prov, operation_id, no_cache);
66 }
67
68
69 int OSSL_PROVIDER_add_builtin(OPENSSL_CTX *libctx, const char *name,
70                               OSSL_provider_init_fn *init_fn)
71 {
72     OSSL_PROVIDER *prov = NULL;
73
74     if (name == NULL || init_fn == NULL) {
75         CRYPTOerr(CRYPTO_F_OSSL_PROVIDER_ADD_BUILTIN,
76                   ERR_R_PASSED_NULL_PARAMETER);
77         return 0;
78     }
79
80     /* Create it */
81     if ((prov = ossl_provider_new(libctx, name, init_fn, 0)) == NULL)
82         return 0;
83
84     /*
85      * It's safely stored in the internal store at this point,
86      * free the returned extra reference
87      */
88     ossl_provider_free(prov);
89
90     return 1;
91 }
92
93 const char *OSSL_PROVIDER_name(const OSSL_PROVIDER *prov)
94 {
95     return ossl_provider_name(prov);
96 }
97
98 int OSSL_PROVIDER_do_all(OPENSSL_CTX *ctx,
99                          int (*cb)(OSSL_PROVIDER *provider,
100                                    void *cbdata),
101                          void *cbdata)
102 {
103     return ossl_provider_forall_loaded(ctx, cb, cbdata);
104 }