Coverage Report

Created: 2026-05-30 06:06

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl/crypto/evp/skeymgmt_meth.c
Line
Count
Source
1
/*
2
 * Copyright 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 <openssl/crypto.h>
11
#include <openssl/core_dispatch.h>
12
#include <openssl/evp.h>
13
#include <openssl/err.h>
14
#include "internal/core.h"
15
#include "internal/provider.h"
16
#include "internal/refcount.h"
17
#include "crypto/evp.h"
18
#include "evp_local.h"
19
20
void *evp_skeymgmt_generate(const EVP_SKEYMGMT *skeymgmt, const OSSL_PARAM params[])
21
0
{
22
0
    void *provctx = ossl_provider_ctx(EVP_SKEYMGMT_get0_provider(skeymgmt));
23
24
0
    return (skeymgmt->generate != NULL) ? skeymgmt->generate(provctx, params) : NULL;
25
0
}
26
27
void *evp_skeymgmt_import(const EVP_SKEYMGMT *skeymgmt, int selection, const OSSL_PARAM params[])
28
0
{
29
0
    void *provctx = ossl_provider_ctx(EVP_SKEYMGMT_get0_provider(skeymgmt));
30
31
    /* This is mandatory, no need to check for its presence */
32
0
    return skeymgmt->import(provctx, selection, params);
33
0
}
34
35
int evp_skeymgmt_export(const EVP_SKEYMGMT *skeymgmt, void *keydata,
36
    int selection, OSSL_CALLBACK *param_cb, void *cbarg)
37
0
{
38
    /* This is mandatory, no need to check for its presence */
39
0
    return skeymgmt->export(keydata, selection, param_cb, cbarg);
40
0
}
41
42
void evp_skeymgmt_freedata(const EVP_SKEYMGMT *skeymgmt, void *keydata)
43
0
{
44
    /* This is mandatory, no need to check for its presence */
45
0
    skeymgmt->free(keydata);
46
0
}
47
48
static int evp_skeymgmt_up_ref(void *skeymgmt)
49
0
{
50
0
    return EVP_SKEYMGMT_up_ref(skeymgmt);
51
0
}
52
53
static void evp_skeymgmt_free(void *skeymgmt)
54
0
{
55
0
    EVP_SKEYMGMT_free(skeymgmt);
56
0
}
57
58
static void *skeymgmt_new(void)
59
0
{
60
0
    EVP_SKEYMGMT *skeymgmt = NULL;
61
62
0
    if ((skeymgmt = OPENSSL_zalloc(sizeof(*skeymgmt))) == NULL)
63
0
        return NULL;
64
0
    if (!CRYPTO_NEW_REF(&skeymgmt->refcnt, 1)) {
65
0
        EVP_SKEYMGMT_free(skeymgmt);
66
0
        return NULL;
67
0
    }
68
0
    return skeymgmt;
69
0
}
70
71
static void *skeymgmt_from_algorithm(int name_id,
72
    const OSSL_ALGORITHM *algodef,
73
    OSSL_PROVIDER *prov)
74
0
{
75
0
    const OSSL_DISPATCH *fns = algodef->implementation;
76
0
    EVP_SKEYMGMT *skeymgmt = NULL;
77
78
0
    if ((skeymgmt = skeymgmt_new()) == NULL)
79
0
        return NULL;
80
81
0
    skeymgmt->name_id = name_id;
82
0
    if ((skeymgmt->type_name = ossl_algorithm_get1_first_name(algodef)) == NULL) {
83
0
        EVP_SKEYMGMT_free(skeymgmt);
84
0
        return NULL;
85
0
    }
86
0
    skeymgmt->description = algodef->algorithm_description;
87
88
0
    for (; fns->function_id != 0; fns++) {
89
0
        switch (fns->function_id) {
90
0
        case OSSL_FUNC_SKEYMGMT_FREE:
91
0
            if (skeymgmt->free == NULL)
92
0
                skeymgmt->free = OSSL_FUNC_skeymgmt_free(fns);
93
0
            break;
94
0
        case OSSL_FUNC_SKEYMGMT_IMPORT:
95
0
            if (skeymgmt->import == NULL)
96
0
                skeymgmt->import = OSSL_FUNC_skeymgmt_import(fns);
97
0
            break;
98
0
        case OSSL_FUNC_SKEYMGMT_EXPORT:
99
0
            if (skeymgmt->export == NULL)
100
0
                skeymgmt->export = OSSL_FUNC_skeymgmt_export(fns);
101
0
            break;
102
0
        case OSSL_FUNC_SKEYMGMT_GENERATE:
103
0
            if (skeymgmt->generate == NULL)
104
0
                skeymgmt->generate = OSSL_FUNC_skeymgmt_generate(fns);
105
0
            break;
106
0
        case OSSL_FUNC_SKEYMGMT_GET_KEY_ID:
107
0
            if (skeymgmt->get_key_id == NULL)
108
0
                skeymgmt->get_key_id = OSSL_FUNC_skeymgmt_get_key_id(fns);
109
0
            break;
110
0
        case OSSL_FUNC_SKEYMGMT_IMP_SETTABLE_PARAMS:
111
0
            if (skeymgmt->imp_params == NULL)
112
0
                skeymgmt->imp_params = OSSL_FUNC_skeymgmt_imp_settable_params(fns);
113
0
            break;
114
0
        case OSSL_FUNC_SKEYMGMT_GEN_SETTABLE_PARAMS:
115
0
            if (skeymgmt->gen_params == NULL)
116
0
                skeymgmt->gen_params = OSSL_FUNC_skeymgmt_gen_settable_params(fns);
117
0
            break;
118
0
        }
119
0
    }
120
121
    /* Check that the provider is sensible */
122
0
    if (skeymgmt->free == NULL
123
0
        || skeymgmt->import == NULL
124
0
        || skeymgmt->export == NULL) {
125
0
        EVP_SKEYMGMT_free(skeymgmt);
126
0
        ERR_raise(ERR_LIB_EVP, EVP_R_INVALID_PROVIDER_FUNCTIONS);
127
0
        return NULL;
128
0
    }
129
130
0
    if (!ossl_provider_up_ref(prov)) {
131
0
        EVP_SKEYMGMT_free(skeymgmt);
132
0
        ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
133
0
        return NULL;
134
0
    }
135
0
    skeymgmt->prov = prov;
136
137
0
    return skeymgmt;
138
0
}
139
140
EVP_SKEYMGMT *evp_skeymgmt_fetch_from_prov(OSSL_PROVIDER *prov,
141
    const char *name,
142
    const char *properties)
143
0
{
144
0
    return evp_generic_fetch_from_prov(prov,
145
0
        OSSL_OP_SKEYMGMT,
146
0
        name, properties,
147
0
        skeymgmt_from_algorithm,
148
0
        evp_skeymgmt_up_ref,
149
0
        evp_skeymgmt_free);
150
0
}
151
152
EVP_SKEYMGMT *EVP_SKEYMGMT_fetch(OSSL_LIB_CTX *ctx, const char *algorithm,
153
    const char *properties)
154
0
{
155
0
    return evp_generic_fetch(ctx, OSSL_OP_SKEYMGMT, algorithm, properties,
156
0
        skeymgmt_from_algorithm,
157
0
        evp_skeymgmt_up_ref,
158
0
        evp_skeymgmt_free);
159
0
}
160
161
int EVP_SKEYMGMT_up_ref(EVP_SKEYMGMT *skeymgmt)
162
0
{
163
0
    int ref = 0;
164
165
0
    CRYPTO_UP_REF(&skeymgmt->refcnt, &ref);
166
0
    return 1;
167
0
}
168
169
void EVP_SKEYMGMT_free(EVP_SKEYMGMT *skeymgmt)
170
0
{
171
0
    int ref = 0;
172
173
0
    if (skeymgmt == NULL)
174
0
        return;
175
176
0
    CRYPTO_DOWN_REF(&skeymgmt->refcnt, &ref);
177
0
    if (ref > 0)
178
0
        return;
179
0
    OPENSSL_free(skeymgmt->type_name);
180
0
    ossl_provider_free(skeymgmt->prov);
181
0
    CRYPTO_FREE_REF(&skeymgmt->refcnt);
182
0
    OPENSSL_free(skeymgmt);
183
0
}
184
185
const OSSL_PROVIDER *EVP_SKEYMGMT_get0_provider(const EVP_SKEYMGMT *skeymgmt)
186
0
{
187
0
    return (skeymgmt != NULL) ? skeymgmt->prov : NULL;
188
0
}
189
190
const char *EVP_SKEYMGMT_get0_description(const EVP_SKEYMGMT *skeymgmt)
191
0
{
192
0
    return (skeymgmt != NULL) ? skeymgmt->description : NULL;
193
0
}
194
195
const char *EVP_SKEYMGMT_get0_name(const EVP_SKEYMGMT *skeymgmt)
196
0
{
197
0
    return (skeymgmt != NULL) ? skeymgmt->type_name : NULL;
198
0
}
199
200
int EVP_SKEYMGMT_is_a(const EVP_SKEYMGMT *skeymgmt, const char *name)
201
0
{
202
0
    return skeymgmt != NULL
203
0
        && evp_is_a(skeymgmt->prov, skeymgmt->name_id, NULL, name);
204
0
}
205
206
void EVP_SKEYMGMT_do_all_provided(OSSL_LIB_CTX *libctx,
207
    void (*fn)(EVP_SKEYMGMT *skeymgmt, void *arg),
208
    void *arg)
209
0
{
210
0
    struct EVP_SKEYMGMT_do_all_provided_thunk t;
211
212
0
    t.fn = fn;
213
0
    t.arg = arg;
214
0
    evp_generic_do_all(libctx, OSSL_OP_SKEYMGMT,
215
0
        EVP_SKEYMGMT_do_all_provided_thunk, &t,
216
0
        skeymgmt_from_algorithm,
217
0
        evp_skeymgmt_up_ref,
218
0
        evp_skeymgmt_free);
219
0
}
220
221
int EVP_SKEYMGMT_names_do_all(const EVP_SKEYMGMT *skeymgmt,
222
    void (*fn)(const char *name, void *data),
223
    void *data)
224
0
{
225
0
    if (skeymgmt == NULL)
226
0
        return 0;
227
228
0
    if (skeymgmt->prov != NULL)
229
0
        return evp_names_do_all(skeymgmt->prov, skeymgmt->name_id, fn, data);
230
231
0
    return 1;
232
0
}
233
234
const OSSL_PARAM *EVP_SKEYMGMT_get0_gen_settable_params(const EVP_SKEYMGMT *skeymgmt)
235
0
{
236
0
    void *provctx = NULL;
237
238
0
    if (skeymgmt == NULL)
239
0
        return 0;
240
241
0
    provctx = ossl_provider_ctx(EVP_SKEYMGMT_get0_provider(skeymgmt));
242
243
0
    return (skeymgmt->gen_params != NULL) ? skeymgmt->gen_params(provctx) : NULL;
244
0
}
245
246
const OSSL_PARAM *EVP_SKEYMGMT_get0_imp_settable_params(const EVP_SKEYMGMT *skeymgmt)
247
0
{
248
0
    void *provctx = NULL;
249
250
0
    if (skeymgmt == NULL)
251
0
        return 0;
252
253
0
    provctx = ossl_provider_ctx(EVP_SKEYMGMT_get0_provider(skeymgmt));
254
255
0
    return (skeymgmt->imp_params != NULL) ? skeymgmt->imp_params(provctx) : NULL;
256
0
}