Add the OSSL_PROVIDER_get_capabilities() API function
[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 const OSSL_ALGORITHM *OSSL_PROVIDER_query_operation(const OSSL_PROVIDER *prov,
61                                                     int operation_id,
62                                                     int *no_cache)
63 {
64     return ossl_provider_query_operation(prov, operation_id, no_cache);
65 }
66
67 void *OSSL_PROVIDER_get0_provider_ctx(const OSSL_PROVIDER *prov)
68 {
69     return ossl_provider_prov_ctx(prov);
70 }
71
72 int OSSL_PROVIDER_get_capabilities(const OSSL_PROVIDER *prov,
73                                    const char *capability,
74                                    OSSL_CALLBACK *cb,
75                                    void *arg)
76 {
77     return ossl_provider_get_capabilities(prov, capability, cb, arg);
78 }
79
80 int OSSL_PROVIDER_add_builtin(OPENSSL_CTX *libctx, const char *name,
81                               OSSL_provider_init_fn *init_fn)
82 {
83     OSSL_PROVIDER *prov = NULL;
84
85     if (name == NULL || init_fn == NULL) {
86         CRYPTOerr(CRYPTO_F_OSSL_PROVIDER_ADD_BUILTIN,
87                   ERR_R_PASSED_NULL_PARAMETER);
88         return 0;
89     }
90
91     /* Create it */
92     if ((prov = ossl_provider_new(libctx, name, init_fn, 0)) == NULL)
93         return 0;
94
95     /*
96      * It's safely stored in the internal store at this point,
97      * free the returned extra reference
98      */
99     ossl_provider_free(prov);
100
101     return 1;
102 }
103
104 const char *OSSL_PROVIDER_name(const OSSL_PROVIDER *prov)
105 {
106     return ossl_provider_name(prov);
107 }
108
109 int OSSL_PROVIDER_do_all(OPENSSL_CTX *ctx,
110                          int (*cb)(OSSL_PROVIDER *provider,
111                                    void *cbdata),
112                          void *cbdata)
113 {
114     return ossl_provider_forall_loaded(ctx, cb, cbdata);
115 }