Coverage Report

Created: 2025-11-16 06:40

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl35/crypto/stack/stack.c
Line
Count
Source
1
/*
2
 * Copyright 1995-2024 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 <stdio.h>
11
#include "internal/cryptlib.h"
12
#include "internal/numbers.h"
13
#include "internal/safe_math.h"
14
#include <openssl/stack.h>
15
#include <errno.h>
16
#include <openssl/e_os2.h>      /* For ossl_inline */
17
18
OSSL_SAFE_MATH_SIGNED(int, int)
19
20
/*
21
 * The initial number of nodes in the array.
22
 */
23
static const int min_nodes = 4;
24
static const int max_nodes = SIZE_MAX / sizeof(void *) < INT_MAX
25
    ? (int)(SIZE_MAX / sizeof(void *)) : INT_MAX;
26
27
struct stack_st {
28
    int num;
29
    const void **data;
30
    int sorted;
31
    int num_alloc;
32
    OPENSSL_sk_compfunc comp;
33
};
34
35
OPENSSL_sk_compfunc OPENSSL_sk_set_cmp_func(OPENSSL_STACK *sk,
36
                                            OPENSSL_sk_compfunc c)
37
230k
{
38
230k
    OPENSSL_sk_compfunc old = sk->comp;
39
40
230k
    if (sk->comp != c)
41
230k
        sk->sorted = 0;
42
230k
    sk->comp = c;
43
44
230k
    return old;
45
230k
}
46
47
OPENSSL_STACK *OPENSSL_sk_dup(const OPENSSL_STACK *sk)
48
37.7M
{
49
37.7M
    OPENSSL_STACK *ret;
50
51
37.7M
    if ((ret = OPENSSL_malloc(sizeof(*ret))) == NULL)
52
0
        goto err;
53
54
37.7M
    if (sk == NULL) {
55
143
        ret->num = 0;
56
143
        ret->sorted = 0;
57
143
        ret->comp = NULL;
58
37.7M
    } else {
59
        /* direct structure assignment */
60
37.7M
        *ret = *sk;
61
37.7M
    }
62
63
37.7M
    if (sk == NULL || sk->num == 0) {
64
        /* postpone |ret->data| allocation */
65
160
        ret->data = NULL;
66
160
        ret->num_alloc = 0;
67
160
        return ret;
68
160
    }
69
70
    /* duplicate |sk->data| content */
71
37.7M
    ret->data = OPENSSL_malloc(sizeof(*ret->data) * sk->num_alloc);
72
37.7M
    if (ret->data == NULL)
73
0
        goto err;
74
37.7M
    memcpy(ret->data, sk->data, sizeof(void *) * sk->num);
75
37.7M
    return ret;
76
77
0
 err:
78
0
    OPENSSL_sk_free(ret);
79
0
    return NULL;
80
37.7M
}
81
82
OPENSSL_STACK *OPENSSL_sk_deep_copy(const OPENSSL_STACK *sk,
83
                                    OPENSSL_sk_copyfunc copy_func,
84
                                    OPENSSL_sk_freefunc free_func)
85
1.52M
{
86
1.52M
    OPENSSL_STACK *ret;
87
1.52M
    int i;
88
89
1.52M
    if ((ret = OPENSSL_malloc(sizeof(*ret))) == NULL)
90
0
        goto err;
91
92
1.52M
    if (sk == NULL) {
93
165
        ret->num = 0;
94
165
        ret->sorted = 0;
95
165
        ret->comp = NULL;
96
1.52M
    } else {
97
        /* direct structure assignment */
98
1.52M
        *ret = *sk;
99
1.52M
    }
100
101
1.52M
    if (sk == NULL || sk->num == 0) {
102
        /* postpone |ret| data allocation */
103
165
        ret->data = NULL;
104
165
        ret->num_alloc = 0;
105
165
        return ret;
106
165
    }
107
108
1.52M
    ret->num_alloc = sk->num > min_nodes ? sk->num : min_nodes;
109
1.52M
    ret->data = OPENSSL_zalloc(sizeof(*ret->data) * ret->num_alloc);
110
1.52M
    if (ret->data == NULL)
111
0
        goto err;
112
113
14.2M
    for (i = 0; i < ret->num; ++i) {
114
12.7M
        if (sk->data[i] == NULL)
115
0
            continue;
116
12.7M
        if ((ret->data[i] = copy_func(sk->data[i])) == NULL) {
117
0
            while (--i >= 0)
118
0
                if (ret->data[i] != NULL)
119
0
                    free_func((void *)ret->data[i]);
120
0
            goto err;
121
0
        }
122
12.7M
    }
123
1.52M
    return ret;
124
125
0
 err:
126
0
    OPENSSL_sk_free(ret);
127
0
    return NULL;
128
1.52M
}
129
130
OPENSSL_STACK *OPENSSL_sk_new_null(void)
131
155M
{
132
155M
    return OPENSSL_sk_new_reserve(NULL, 0);
133
155M
}
134
135
OPENSSL_STACK *OPENSSL_sk_new(OPENSSL_sk_compfunc c)
136
15.3M
{
137
15.3M
    return OPENSSL_sk_new_reserve(c, 0);
138
15.3M
}
139
140
/*
141
 * Calculate the array growth based on the target size.
142
 *
143
 * The growth factor is a rational number and is defined by a numerator
144
 * and a denominator.  According to Andrew Koenig in his paper "Why Are
145
 * Vectors Efficient?" from JOOP 11(5) 1998, this factor should be less
146
 * than the golden ratio (1.618...).
147
 *
148
 * Considering only the Fibonacci ratios less than the golden ratio, the
149
 * number of steps from the minimum allocation to integer overflow is:
150
 *      factor  decimal    growths
151
 *       3/2     1.5          51
152
 *       8/5     1.6          45
153
 *      21/13    1.615...     44
154
 *
155
 * All larger factors have the same number of growths.
156
 *
157
 * 3/2 and 8/5 have nice power of two shifts, so seem like a good choice.
158
 */
159
static ossl_inline int compute_growth(int target, int current)
160
4.68M
{
161
4.68M
    int err = 0;
162
163
9.37M
    while (current < target) {
164
4.68M
        if (current >= max_nodes)
165
0
            return 0;
166
167
4.68M
        current = safe_muldiv_int(current, 8, 5, &err);
168
4.68M
        if (err != 0)
169
0
            return 0;
170
4.68M
        if (current >= max_nodes)
171
0
            current = max_nodes;
172
4.68M
    }
173
4.68M
    return current;
174
4.68M
}
175
176
/* internal STACK storage allocation */
177
static int sk_reserve(OPENSSL_STACK *st, int n, int exact)
178
381M
{
179
381M
    const void **tmpdata;
180
381M
    int num_alloc;
181
182
    /* Check to see the reservation isn't exceeding the hard limit */
183
381M
    if (n > max_nodes - st->num) {
184
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
185
0
        return 0;
186
0
    }
187
188
    /* Figure out the new size */
189
381M
    num_alloc = st->num + n;
190
381M
    if (num_alloc < min_nodes)
191
31.9M
        num_alloc = min_nodes;
192
193
    /* If |st->data| allocation was postponed */
194
381M
    if (st->data == NULL) {
195
        /*
196
         * At this point, |st->num_alloc| and |st->num| are 0;
197
         * so |num_alloc| value is |n| or |min_nodes| if greater than |n|.
198
         */
199
21.2M
        if ((st->data = OPENSSL_zalloc(sizeof(void *) * num_alloc)) == NULL)
200
0
            return 0;
201
21.2M
        st->num_alloc = num_alloc;
202
21.2M
        return 1;
203
21.2M
    }
204
205
360M
    if (!exact) {
206
360M
        if (num_alloc <= st->num_alloc)
207
351M
            return 1;
208
8.62M
        num_alloc = compute_growth(num_alloc, st->num_alloc);
209
8.62M
        if (num_alloc == 0) {
210
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
211
0
            return 0;
212
0
        }
213
8.62M
    } else if (num_alloc == st->num_alloc) {
214
0
        return 1;
215
0
    }
216
217
8.62M
    tmpdata = OPENSSL_realloc((void *)st->data, sizeof(void *) * num_alloc);
218
8.62M
    if (tmpdata == NULL)
219
0
        return 0;
220
221
8.62M
    st->data = tmpdata;
222
8.62M
    st->num_alloc = num_alloc;
223
8.62M
    return 1;
224
8.62M
}
225
226
OPENSSL_STACK *OPENSSL_sk_new_reserve(OPENSSL_sk_compfunc c, int n)
227
171M
{
228
171M
    OPENSSL_STACK *st = OPENSSL_zalloc(sizeof(OPENSSL_STACK));
229
230
171M
    if (st == NULL)
231
0
        return NULL;
232
233
171M
    st->comp = c;
234
235
171M
    if (n <= 0)
236
170M
        return st;
237
238
949k
    if (!sk_reserve(st, n, 1)) {
239
0
        OPENSSL_sk_free(st);
240
0
        return NULL;
241
0
    }
242
243
949k
    return st;
244
949k
}
245
246
int OPENSSL_sk_reserve(OPENSSL_STACK *st, int n)
247
0
{
248
0
    if (st == NULL) {
249
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
250
0
        return 0;
251
0
    }
252
253
0
    if (n < 0)
254
0
        return 1;
255
0
    return sk_reserve(st, n, 1);
256
0
}
257
258
int OPENSSL_sk_insert(OPENSSL_STACK *st, const void *data, int loc)
259
309M
{
260
309M
    if (st == NULL) {
261
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
262
0
        return 0;
263
0
    }
264
309M
    if (st->num == max_nodes) {
265
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
266
0
        return 0;
267
0
    }
268
269
309M
    if (!sk_reserve(st, 1, 0))
270
0
        return 0;
271
272
309M
    if ((loc >= st->num) || (loc < 0)) {
273
309M
        st->data[st->num] = data;
274
309M
    } else {
275
5.12k
        memmove(&st->data[loc + 1], &st->data[loc],
276
5.12k
                sizeof(st->data[0]) * (st->num - loc));
277
5.12k
        st->data[loc] = data;
278
5.12k
    }
279
309M
    st->num++;
280
309M
    st->sorted = 0;
281
309M
    return st->num;
282
309M
}
283
284
static ossl_inline void *internal_delete(OPENSSL_STACK *st, int loc)
285
1.99M
{
286
1.99M
    const void *ret = st->data[loc];
287
288
1.99M
    if (loc != st->num - 1)
289
274k
        memmove(&st->data[loc], &st->data[loc + 1],
290
274k
                sizeof(st->data[0]) * (st->num - loc - 1));
291
1.99M
    st->num--;
292
293
1.99M
    return (void *)ret;
294
1.99M
}
295
296
void *OPENSSL_sk_delete_ptr(OPENSSL_STACK *st, const void *p)
297
216k
{
298
216k
    int i;
299
300
216k
    if (st == NULL)
301
0
        return NULL;
302
303
688k
    for (i = 0; i < st->num; i++)
304
688k
        if (st->data[i] == p)
305
216k
            return internal_delete(st, i);
306
0
    return NULL;
307
216k
}
308
309
void *OPENSSL_sk_delete(OPENSSL_STACK *st, int loc)
310
263k
{
311
263k
    if (st == NULL || loc < 0 || loc >= st->num)
312
0
        return NULL;
313
314
263k
    return internal_delete(st, loc);
315
263k
}
316
317
static int internal_find(OPENSSL_STACK *st, const void *data,
318
                         int ret_val_options, int *pnum_matched)
319
231k
{
320
231k
    const void *r;
321
231k
    int i, count = 0;
322
231k
    int *pnum = pnum_matched;
323
324
231k
    if (st == NULL || st->num == 0)
325
90.8k
        return -1;
326
327
141k
    if (pnum == NULL)
328
134k
        pnum = &count;
329
330
141k
    if (st->comp == NULL) {
331
2.76M
        for (i = 0; i < st->num; i++)
332
2.76M
            if (st->data[i] == data) {
333
26.2k
                *pnum = 1;
334
26.2k
                return i;
335
26.2k
            }
336
2.47k
        *pnum = 0;
337
2.47k
        return -1;
338
28.7k
    }
339
340
112k
    if (data == NULL)
341
0
        return -1;
342
343
112k
    if (!st->sorted) {
344
0
        int res = -1;
345
346
0
        for (i = 0; i < st->num; i++)
347
0
            if (st->comp(&data, st->data + i) == 0) {
348
0
                if (res == -1)
349
0
                    res = i;
350
0
                ++*pnum;
351
                /* Check if only one result is wanted and exit if so */
352
0
                if (pnum_matched == NULL)
353
0
                    return i;
354
0
            }
355
0
        if (res == -1)
356
0
            *pnum = 0;
357
0
        return res;
358
0
    }
359
360
112k
    if (pnum_matched != NULL)
361
6.67k
        ret_val_options |= OSSL_BSEARCH_FIRST_VALUE_ON_MATCH;
362
112k
    r = ossl_bsearch(&data, st->data, st->num, sizeof(void *), st->comp,
363
112k
                     ret_val_options);
364
365
112k
    if (pnum_matched != NULL) {
366
6.67k
        *pnum = 0;
367
6.67k
        if (r != NULL) {
368
4.32k
            const void **p = (const void **)r;
369
370
8.64k
            while (p < st->data + st->num) {
371
4.32k
                if (st->comp(&data, p) != 0)
372
0
                    break;
373
4.32k
                ++*pnum;
374
4.32k
                ++p;
375
4.32k
            }
376
4.32k
        }
377
6.67k
    }
378
379
112k
    return r == NULL ? -1 : (int)((const void **)r - st->data);
380
112k
}
381
382
int OPENSSL_sk_find(OPENSSL_STACK *st, const void *data)
383
160k
{
384
160k
    return internal_find(st, data, OSSL_BSEARCH_FIRST_VALUE_ON_MATCH, NULL);
385
160k
}
386
387
int OPENSSL_sk_find_ex(OPENSSL_STACK *st, const void *data)
388
0
{
389
0
    return internal_find(st, data, OSSL_BSEARCH_VALUE_ON_NOMATCH, NULL);
390
0
}
391
392
int OPENSSL_sk_find_all(OPENSSL_STACK *st, const void *data, int *pnum)
393
93.6k
{
394
93.6k
    return internal_find(st, data, OSSL_BSEARCH_FIRST_VALUE_ON_MATCH, pnum);
395
93.6k
}
396
397
int OPENSSL_sk_push(OPENSSL_STACK *st, const void *data)
398
380M
{
399
380M
    if (st == NULL)
400
0
        return 0;
401
380M
    return OPENSSL_sk_insert(st, data, st->num);
402
380M
}
403
404
int OPENSSL_sk_unshift(OPENSSL_STACK *st, const void *data)
405
0
{
406
0
    return OPENSSL_sk_insert(st, data, 0);
407
0
}
408
409
void *OPENSSL_sk_shift(OPENSSL_STACK *st)
410
0
{
411
0
    if (st == NULL || st->num == 0)
412
0
        return NULL;
413
0
    return internal_delete(st, 0);
414
0
}
415
416
void *OPENSSL_sk_pop(OPENSSL_STACK *st)
417
2.06M
{
418
2.06M
    if (st == NULL || st->num == 0)
419
10.0k
        return NULL;
420
2.05M
    return internal_delete(st, st->num - 1);
421
2.06M
}
422
423
void OPENSSL_sk_zero(OPENSSL_STACK *st)
424
0
{
425
0
    if (st == NULL || st->num == 0)
426
0
        return;
427
0
    memset(st->data, 0, sizeof(*st->data) * st->num);
428
0
    st->num = 0;
429
0
}
430
431
void OPENSSL_sk_pop_free(OPENSSL_STACK *st, OPENSSL_sk_freefunc func)
432
50.4M
{
433
50.4M
    int i;
434
435
50.4M
    if (st == NULL)
436
12.7M
        return;
437
227M
    for (i = 0; i < st->num; i++)
438
190M
        if (st->data[i] != NULL)
439
189M
            func((char *)st->data[i]);
440
37.6M
    OPENSSL_sk_free(st);
441
37.6M
}
442
443
void OPENSSL_sk_free(OPENSSL_STACK *st)
444
260M
{
445
260M
    if (st == NULL)
446
49.4M
        return;
447
210M
    OPENSSL_free(st->data);
448
210M
    OPENSSL_free(st);
449
210M
}
450
451
int OPENSSL_sk_num(const OPENSSL_STACK *st)
452
1.14G
{
453
1.14G
    return st == NULL ? -1 : st->num;
454
1.14G
}
455
456
void *OPENSSL_sk_value(const OPENSSL_STACK *st, int i)
457
1.30G
{
458
1.30G
    if (st == NULL || i < 0 || i >= st->num)
459
4.82k
        return NULL;
460
1.30G
    return (void *)st->data[i];
461
1.30G
}
462
463
void *OPENSSL_sk_set(OPENSSL_STACK *st, int i, const void *data)
464
13.0M
{
465
13.0M
    if (st == NULL) {
466
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
467
0
        return NULL;
468
0
    }
469
13.0M
    if (i < 0 || i >= st->num) {
470
0
        ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_PASSED_INVALID_ARGUMENT,
471
0
                       "i=%d", i);
472
0
        return NULL;
473
0
    }
474
13.0M
    st->data[i] = data;
475
13.0M
    st->sorted = 0;
476
13.0M
    return (void *)st->data[i];
477
13.0M
}
478
479
void OPENSSL_sk_sort(OPENSSL_STACK *st)
480
15.5M
{
481
15.5M
    if (st != NULL && !st->sorted && st->comp != NULL) {
482
13.1M
        if (st->num > 1)
483
269k
            qsort(st->data, st->num, sizeof(void *), st->comp);
484
13.1M
        st->sorted = 1; /* empty or single-element stack is considered sorted */
485
13.1M
    }
486
15.5M
}
487
488
int OPENSSL_sk_is_sorted(const OPENSSL_STACK *st)
489
75.6k
{
490
75.6k
    return st == NULL ? 1 : st->sorted;
491
75.6k
}