Coverage Report

Created: 2025-12-31 06:58

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl33/crypto/param_build.c
Line
Count
Source
1
/*
2
 * Copyright 2019-2023 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright (c) 2019, Oracle and/or its affiliates.  All rights reserved.
4
 *
5
 * Licensed under the Apache License 2.0 (the "License").  You may not use
6
 * this file except in compliance with the License.  You can obtain a copy
7
 * in the file LICENSE in the source distribution or at
8
 * https://www.openssl.org/source/license.html
9
 */
10
11
#include <string.h>
12
#include <openssl/err.h>
13
#include <openssl/cryptoerr.h>
14
#include <openssl/params.h>
15
#include <openssl/types.h>
16
#include <openssl/safestack.h>
17
#include "internal/param_build_set.h"
18
19
/*
20
 * Special internal param type to indicate the end of an allocate OSSL_PARAM
21
 * array.
22
 */
23
24
typedef struct {
25
    const char *key;
26
    int type;
27
    int secure;
28
    size_t size;
29
    size_t alloc_blocks;
30
    const BIGNUM *bn;
31
    const void *string;
32
    union {
33
        /*
34
         * These fields are never directly addressed, but their sizes are
35
         * important so that all native types can be copied here without overrun.
36
         */
37
        ossl_intmax_t i;
38
        ossl_uintmax_t u;
39
        double d;
40
    } num;
41
} OSSL_PARAM_BLD_DEF;
42
43
DEFINE_STACK_OF(OSSL_PARAM_BLD_DEF)
44
45
struct ossl_param_bld_st {
46
    size_t total_blocks;
47
    size_t secure_blocks;
48
    STACK_OF(OSSL_PARAM_BLD_DEF) *params;
49
};
50
51
static OSSL_PARAM_BLD_DEF *param_push(OSSL_PARAM_BLD *bld, const char *key,
52
    size_t size, size_t alloc, int type,
53
    int secure)
54
2.37M
{
55
2.37M
    OSSL_PARAM_BLD_DEF *pd = OPENSSL_zalloc(sizeof(*pd));
56
57
2.37M
    if (pd == NULL)
58
0
        return NULL;
59
2.37M
    pd->key = key;
60
2.37M
    pd->type = type;
61
2.37M
    pd->size = size;
62
2.37M
    pd->alloc_blocks = ossl_param_bytes_to_blocks(alloc);
63
2.37M
    if ((pd->secure = secure) != 0)
64
463k
        bld->secure_blocks += pd->alloc_blocks;
65
1.91M
    else
66
1.91M
        bld->total_blocks += pd->alloc_blocks;
67
2.37M
    if (sk_OSSL_PARAM_BLD_DEF_push(bld->params, pd) <= 0) {
68
0
        OPENSSL_free(pd);
69
0
        pd = NULL;
70
0
    }
71
2.37M
    return pd;
72
2.37M
}
73
74
static int param_push_num(OSSL_PARAM_BLD *bld, const char *key,
75
    void *num, size_t size, int type)
76
514k
{
77
514k
    OSSL_PARAM_BLD_DEF *pd = param_push(bld, key, size, size, type, 0);
78
79
514k
    if (pd == NULL) {
80
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
81
0
        return 0;
82
0
    }
83
514k
    if (size > sizeof(pd->num)) {
84
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_BYTES);
85
0
        return 0;
86
0
    }
87
514k
    memcpy(&pd->num, num, size);
88
514k
    return 1;
89
514k
}
90
91
OSSL_PARAM_BLD *OSSL_PARAM_BLD_new(void)
92
400k
{
93
400k
    OSSL_PARAM_BLD *r = OPENSSL_zalloc(sizeof(OSSL_PARAM_BLD));
94
95
400k
    if (r != NULL) {
96
400k
        r->params = sk_OSSL_PARAM_BLD_DEF_new_null();
97
400k
        if (r->params == NULL) {
98
0
            OPENSSL_free(r);
99
0
            r = NULL;
100
0
        }
101
400k
    }
102
400k
    return r;
103
400k
}
104
105
static void free_all_params(OSSL_PARAM_BLD *bld)
106
800k
{
107
800k
    int i, n = sk_OSSL_PARAM_BLD_DEF_num(bld->params);
108
109
3.17M
    for (i = 0; i < n; i++)
110
2.37M
        OPENSSL_free(sk_OSSL_PARAM_BLD_DEF_pop(bld->params));
111
800k
}
112
113
void OSSL_PARAM_BLD_free(OSSL_PARAM_BLD *bld)
114
400k
{
115
400k
    if (bld == NULL)
116
0
        return;
117
400k
    free_all_params(bld);
118
400k
    sk_OSSL_PARAM_BLD_DEF_free(bld->params);
119
400k
    OPENSSL_free(bld);
120
400k
}
121
122
int OSSL_PARAM_BLD_push_int(OSSL_PARAM_BLD *bld, const char *key, int num)
123
514k
{
124
514k
    return param_push_num(bld, key, &num, sizeof(num), OSSL_PARAM_INTEGER);
125
514k
}
126
127
int OSSL_PARAM_BLD_push_uint(OSSL_PARAM_BLD *bld, const char *key,
128
    unsigned int num)
129
0
{
130
0
    return param_push_num(bld, key, &num, sizeof(num),
131
0
        OSSL_PARAM_UNSIGNED_INTEGER);
132
0
}
133
134
int OSSL_PARAM_BLD_push_long(OSSL_PARAM_BLD *bld, const char *key,
135
    long int num)
136
0
{
137
0
    return param_push_num(bld, key, &num, sizeof(num), OSSL_PARAM_INTEGER);
138
0
}
139
140
int OSSL_PARAM_BLD_push_ulong(OSSL_PARAM_BLD *bld, const char *key,
141
    unsigned long int num)
142
0
{
143
0
    return param_push_num(bld, key, &num, sizeof(num),
144
0
        OSSL_PARAM_UNSIGNED_INTEGER);
145
0
}
146
147
int OSSL_PARAM_BLD_push_int32(OSSL_PARAM_BLD *bld, const char *key,
148
    int32_t num)
149
0
{
150
0
    return param_push_num(bld, key, &num, sizeof(num), OSSL_PARAM_INTEGER);
151
0
}
152
153
int OSSL_PARAM_BLD_push_uint32(OSSL_PARAM_BLD *bld, const char *key,
154
    uint32_t num)
155
0
{
156
0
    return param_push_num(bld, key, &num, sizeof(num),
157
0
        OSSL_PARAM_UNSIGNED_INTEGER);
158
0
}
159
160
int OSSL_PARAM_BLD_push_int64(OSSL_PARAM_BLD *bld, const char *key,
161
    int64_t num)
162
0
{
163
0
    return param_push_num(bld, key, &num, sizeof(num), OSSL_PARAM_INTEGER);
164
0
}
165
166
int OSSL_PARAM_BLD_push_uint64(OSSL_PARAM_BLD *bld, const char *key,
167
    uint64_t num)
168
0
{
169
0
    return param_push_num(bld, key, &num, sizeof(num),
170
0
        OSSL_PARAM_UNSIGNED_INTEGER);
171
0
}
172
173
int OSSL_PARAM_BLD_push_size_t(OSSL_PARAM_BLD *bld, const char *key,
174
    size_t num)
175
0
{
176
0
    return param_push_num(bld, key, &num, sizeof(num),
177
0
        OSSL_PARAM_UNSIGNED_INTEGER);
178
0
}
179
180
int OSSL_PARAM_BLD_push_time_t(OSSL_PARAM_BLD *bld, const char *key,
181
    time_t num)
182
0
{
183
0
    return param_push_num(bld, key, &num, sizeof(num),
184
0
        OSSL_PARAM_INTEGER);
185
0
}
186
187
int OSSL_PARAM_BLD_push_double(OSSL_PARAM_BLD *bld, const char *key,
188
    double num)
189
0
{
190
0
    return param_push_num(bld, key, &num, sizeof(num), OSSL_PARAM_REAL);
191
0
}
192
193
static int push_BN(OSSL_PARAM_BLD *bld, const char *key,
194
    const BIGNUM *bn, size_t sz, int type)
195
1.13M
{
196
1.13M
    int n, secure = 0;
197
1.13M
    OSSL_PARAM_BLD_DEF *pd;
198
199
1.13M
    if (!ossl_assert(type == OSSL_PARAM_UNSIGNED_INTEGER
200
1.13M
            || type == OSSL_PARAM_INTEGER))
201
0
        return 0;
202
203
1.13M
    if (bn != NULL) {
204
1.13M
        if (type == OSSL_PARAM_UNSIGNED_INTEGER && BN_is_negative(bn)) {
205
0
            ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_UNSUPPORTED,
206
0
                "Negative big numbers are unsupported for OSSL_PARAM_UNSIGNED_INTEGER");
207
0
            return 0;
208
0
        }
209
210
1.13M
        n = BN_num_bytes(bn);
211
1.13M
        if (n < 0) {
212
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ZERO_LENGTH_NUMBER);
213
0
            return 0;
214
0
        }
215
1.13M
        if (sz < (size_t)n) {
216
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
217
0
            return 0;
218
0
        }
219
1.13M
        if (BN_get_flags(bn, BN_FLG_SECURE) == BN_FLG_SECURE)
220
420k
            secure = 1;
221
222
        /* The BIGNUM is zero, we must transfer at least one byte */
223
1.13M
        if (sz == 0)
224
3.91k
            sz++;
225
1.13M
    }
226
1.13M
    pd = param_push(bld, key, sz, sz, type, secure);
227
1.13M
    if (pd == NULL)
228
0
        return 0;
229
1.13M
    pd->bn = bn;
230
1.13M
    return 1;
231
1.13M
}
232
233
int OSSL_PARAM_BLD_push_BN(OSSL_PARAM_BLD *bld, const char *key,
234
    const BIGNUM *bn)
235
1.04M
{
236
1.04M
    if (bn != NULL && BN_is_negative(bn))
237
0
        return push_BN(bld, key, bn, BN_num_bytes(bn) + 1,
238
0
            OSSL_PARAM_INTEGER);
239
1.04M
    return push_BN(bld, key, bn, bn == NULL ? 0 : BN_num_bytes(bn),
240
1.04M
        OSSL_PARAM_UNSIGNED_INTEGER);
241
1.04M
}
242
243
int OSSL_PARAM_BLD_push_BN_pad(OSSL_PARAM_BLD *bld, const char *key,
244
    const BIGNUM *bn, size_t sz)
245
93.3k
{
246
93.3k
    if (bn != NULL && BN_is_negative(bn))
247
0
        return push_BN(bld, key, bn, BN_num_bytes(bn),
248
0
            OSSL_PARAM_INTEGER);
249
93.3k
    return push_BN(bld, key, bn, sz, OSSL_PARAM_UNSIGNED_INTEGER);
250
93.3k
}
251
252
int OSSL_PARAM_BLD_push_utf8_string(OSSL_PARAM_BLD *bld, const char *key,
253
    const char *buf, size_t bsize)
254
383k
{
255
383k
    OSSL_PARAM_BLD_DEF *pd;
256
383k
    int secure;
257
258
383k
    if (bsize == 0)
259
383k
        bsize = strlen(buf);
260
383k
    secure = CRYPTO_secure_allocated(buf);
261
383k
    pd = param_push(bld, key, bsize, bsize + 1, OSSL_PARAM_UTF8_STRING, secure);
262
383k
    if (pd == NULL)
263
0
        return 0;
264
383k
    pd->string = buf;
265
383k
    return 1;
266
383k
}
267
268
int OSSL_PARAM_BLD_push_utf8_ptr(OSSL_PARAM_BLD *bld, const char *key,
269
    char *buf, size_t bsize)
270
0
{
271
0
    OSSL_PARAM_BLD_DEF *pd;
272
273
0
    if (bsize == 0)
274
0
        bsize = strlen(buf);
275
0
    pd = param_push(bld, key, bsize, sizeof(buf), OSSL_PARAM_UTF8_PTR, 0);
276
0
    if (pd == NULL)
277
0
        return 0;
278
0
    pd->string = buf;
279
0
    return 1;
280
0
}
281
282
int OSSL_PARAM_BLD_push_octet_string(OSSL_PARAM_BLD *bld, const char *key,
283
    const void *buf, size_t bsize)
284
192k
{
285
192k
    OSSL_PARAM_BLD_DEF *pd;
286
192k
    int secure;
287
288
192k
    secure = CRYPTO_secure_allocated(buf);
289
192k
    pd = param_push(bld, key, bsize, bsize, OSSL_PARAM_OCTET_STRING, secure);
290
192k
    if (pd == NULL)
291
0
        return 0;
292
192k
    pd->string = buf;
293
192k
    return 1;
294
192k
}
295
296
int OSSL_PARAM_BLD_push_octet_ptr(OSSL_PARAM_BLD *bld, const char *key,
297
    void *buf, size_t bsize)
298
0
{
299
0
    OSSL_PARAM_BLD_DEF *pd;
300
301
0
    pd = param_push(bld, key, bsize, sizeof(buf), OSSL_PARAM_OCTET_PTR, 0);
302
0
    if (pd == NULL)
303
0
        return 0;
304
0
    pd->string = buf;
305
0
    return 1;
306
0
}
307
308
static OSSL_PARAM *param_bld_convert(OSSL_PARAM_BLD *bld, OSSL_PARAM *param,
309
    OSSL_PARAM_ALIGNED_BLOCK *blk,
310
    OSSL_PARAM_ALIGNED_BLOCK *secure)
311
373k
{
312
373k
    int i, num = sk_OSSL_PARAM_BLD_DEF_num(bld->params);
313
373k
    OSSL_PARAM_BLD_DEF *pd;
314
373k
    void *p;
315
316
2.55M
    for (i = 0; i < num; i++) {
317
2.17M
        pd = sk_OSSL_PARAM_BLD_DEF_value(bld->params, i);
318
2.17M
        param[i].key = pd->key;
319
2.17M
        param[i].data_type = pd->type;
320
2.17M
        param[i].data_size = pd->size;
321
2.17M
        param[i].return_size = OSSL_PARAM_UNMODIFIED;
322
323
2.17M
        if (pd->secure) {
324
420k
            p = secure;
325
420k
            secure += pd->alloc_blocks;
326
1.75M
        } else {
327
1.75M
            p = blk;
328
1.75M
            blk += pd->alloc_blocks;
329
1.75M
        }
330
2.17M
        param[i].data = p;
331
2.17M
        if (pd->bn != NULL) {
332
            /* BIGNUM */
333
1.13M
            if (pd->type == OSSL_PARAM_UNSIGNED_INTEGER)
334
1.13M
                BN_bn2nativepad(pd->bn, (unsigned char *)p, pd->size);
335
0
            else
336
0
                BN_signed_bn2native(pd->bn, (unsigned char *)p, pd->size);
337
1.13M
        } else if (pd->type == OSSL_PARAM_OCTET_PTR
338
1.04M
            || pd->type == OSSL_PARAM_UTF8_PTR) {
339
            /* PTR */
340
0
            *(const void **)p = pd->string;
341
1.04M
        } else if (pd->type == OSSL_PARAM_OCTET_STRING
342
850k
            || pd->type == OSSL_PARAM_UTF8_STRING) {
343
576k
            if (pd->string != NULL)
344
576k
                memcpy(p, pd->string, pd->size);
345
0
            else
346
0
                memset(p, 0, pd->size);
347
576k
            if (pd->type == OSSL_PARAM_UTF8_STRING)
348
383k
                ((char *)p)[pd->size] = '\0';
349
576k
        } else {
350
            /* Number, but could also be a NULL BIGNUM */
351
466k
            if (pd->size > sizeof(pd->num))
352
0
                memset(p, 0, pd->size);
353
466k
            else if (pd->size > 0)
354
466k
                memcpy(p, &pd->num, pd->size);
355
466k
        }
356
2.17M
    }
357
373k
    param[i] = OSSL_PARAM_construct_end();
358
373k
    return param + i;
359
373k
}
360
361
OSSL_PARAM *OSSL_PARAM_BLD_to_param(OSSL_PARAM_BLD *bld)
362
400k
{
363
400k
    OSSL_PARAM_ALIGNED_BLOCK *blk, *s = NULL;
364
400k
    OSSL_PARAM *params, *last;
365
400k
    const int num = sk_OSSL_PARAM_BLD_DEF_num(bld->params);
366
400k
    const size_t p_blks = ossl_param_bytes_to_blocks((1 + num) * sizeof(*params));
367
400k
    const size_t total = OSSL_PARAM_ALIGN_SIZE * (p_blks + bld->total_blocks);
368
400k
    const size_t ss = OSSL_PARAM_ALIGN_SIZE * bld->secure_blocks;
369
370
400k
    if (ss > 0) {
371
205k
        s = OPENSSL_secure_malloc(ss);
372
205k
        if (s == NULL) {
373
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_SECURE_MALLOC_FAILURE);
374
0
            return NULL;
375
0
        }
376
205k
    }
377
400k
    params = OPENSSL_malloc(total);
378
400k
    if (params == NULL) {
379
0
        OPENSSL_secure_free(s);
380
0
        return NULL;
381
0
    }
382
400k
    blk = p_blks + (OSSL_PARAM_ALIGNED_BLOCK *)(params);
383
400k
    last = param_bld_convert(bld, params, blk, s);
384
400k
    ossl_param_set_secure_block(last, s, ss);
385
386
    /* Reset builder for reuse */
387
400k
    bld->total_blocks = 0;
388
400k
    bld->secure_blocks = 0;
389
400k
    free_all_params(bld);
390
400k
    return params;
391
400k
}