Coverage Report

Created: 2025-12-04 06:33

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