Coverage Report

Created: 2025-08-11 07:04

/src/openssl30/crypto/stack/stack.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 1995-2022 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 <openssl/stack.h>
14
#include <errno.h>
15
#include <openssl/e_os2.h>      /* For ossl_inline */
16
17
/*
18
 * The initial number of nodes in the array.
19
 */
20
static const int min_nodes = 4;
21
static const int max_nodes = SIZE_MAX / sizeof(void *) < INT_MAX
22
    ? (int)(SIZE_MAX / sizeof(void *)) : INT_MAX;
23
24
struct stack_st {
25
    int num;
26
    const void **data;
27
    int sorted;
28
    int num_alloc;
29
    OPENSSL_sk_compfunc comp;
30
};
31
32
OPENSSL_sk_compfunc OPENSSL_sk_set_cmp_func(OPENSSL_STACK *sk,
33
                                            OPENSSL_sk_compfunc c)
34
255k
{
35
255k
    OPENSSL_sk_compfunc old = sk->comp;
36
37
255k
    if (sk->comp != c)
38
255k
        sk->sorted = 0;
39
255k
    sk->comp = c;
40
41
255k
    return old;
42
255k
}
43
44
OPENSSL_STACK *OPENSSL_sk_dup(const OPENSSL_STACK *sk)
45
4.32M
{
46
4.32M
    OPENSSL_STACK *ret;
47
48
4.32M
    if ((ret = OPENSSL_malloc(sizeof(*ret))) == NULL)
49
0
        goto err;
50
51
4.32M
    if (sk == NULL) {
52
196
        ret->num = 0;
53
196
        ret->sorted = 0;
54
196
        ret->comp = NULL;
55
4.32M
    } else {
56
        /* direct structure assignment */
57
4.32M
        *ret = *sk;
58
4.32M
    }
59
60
4.32M
    if (sk == NULL || sk->num == 0) {
61
        /* postpone |ret->data| allocation */
62
211
        ret->data = NULL;
63
211
        ret->num_alloc = 0;
64
211
        return ret;
65
211
    }
66
67
    /* duplicate |sk->data| content */
68
4.32M
    ret->data = OPENSSL_malloc(sizeof(*ret->data) * sk->num_alloc);
69
4.32M
    if (ret->data == NULL)
70
0
        goto err;
71
4.32M
    memcpy(ret->data, sk->data, sizeof(void *) * sk->num);
72
4.32M
    return ret;
73
74
0
 err:
75
0
    ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
76
0
    OPENSSL_sk_free(ret);
77
0
    return NULL;
78
4.32M
}
79
80
OPENSSL_STACK *OPENSSL_sk_deep_copy(const OPENSSL_STACK *sk,
81
                                    OPENSSL_sk_copyfunc copy_func,
82
                                    OPENSSL_sk_freefunc free_func)
83
1.49M
{
84
1.49M
    OPENSSL_STACK *ret;
85
1.49M
    int i;
86
87
1.49M
    if ((ret = OPENSSL_malloc(sizeof(*ret))) == NULL)
88
0
        goto err;
89
90
1.49M
    if (sk == NULL) {
91
212
        ret->num = 0;
92
212
        ret->sorted = 0;
93
212
        ret->comp = NULL;
94
1.49M
    } else {
95
        /* direct structure assignment */
96
1.49M
        *ret = *sk;
97
1.49M
    }
98
99
1.49M
    if (sk == NULL || sk->num == 0) {
100
        /* postpone |ret| data allocation */
101
212
        ret->data = NULL;
102
212
        ret->num_alloc = 0;
103
212
        return ret;
104
212
    }
105
106
1.49M
    ret->num_alloc = sk->num > min_nodes ? sk->num : min_nodes;
107
1.49M
    ret->data = OPENSSL_zalloc(sizeof(*ret->data) * ret->num_alloc);
108
1.49M
    if (ret->data == NULL)
109
0
        goto err;
110
111
16.4M
    for (i = 0; i < ret->num; ++i) {
112
14.9M
        if (sk->data[i] == NULL)
113
0
            continue;
114
14.9M
        if ((ret->data[i] = copy_func(sk->data[i])) == NULL) {
115
0
            while (--i >= 0)
116
0
                if (ret->data[i] != NULL)
117
0
                    free_func((void *)ret->data[i]);
118
0
            goto err;
119
0
        }
120
14.9M
    }
121
1.49M
    return ret;
122
123
0
 err:
124
0
    ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
125
0
    OPENSSL_sk_free(ret);
126
0
    return NULL;
127
1.49M
}
128
129
OPENSSL_STACK *OPENSSL_sk_new_null(void)
130
153M
{
131
153M
    return OPENSSL_sk_new_reserve(NULL, 0);
132
153M
}
133
134
OPENSSL_STACK *OPENSSL_sk_new(OPENSSL_sk_compfunc c)
135
16.8M
{
136
16.8M
    return OPENSSL_sk_new_reserve(c, 0);
137
16.8M
}
138
139
/*
140
 * Calculate the array growth based on the target size.
141
 *
142
 * The growth fraction is a rational number and is defined by a numerator
143
 * and a denominator.  According to Andrew Koenig in his paper "Why Are
144
 * Vectors Efficient?" from JOOP 11(5) 1998, this factor should be less
145
 * than the golden ratio (1.618...).
146
 *
147
 * We use 3/2 = 1.5 for simplicity of calculation and overflow checking.
148
 * Another option 8/5 = 1.6 allows for slightly faster growth, although safe
149
 * computation is more difficult.
150
 *
151
 * The limit to avoid overflow is spot on.  The modulo three correction term
152
 * ensures that the limit is the largest number than can be expanded by the
153
 * growth factor without exceeding the hard limit.
154
 *
155
 * Do not call it with |current| lower than 2, or it will infinitely loop.
156
 */
157
static ossl_inline int compute_growth(int target, int current)
158
3.86M
{
159
3.86M
    const int limit = (max_nodes / 3) * 2 + (max_nodes % 3 ? 1 : 0);
160
161
7.73M
    while (current < target) {
162
        /* Check to see if we're at the hard limit */
163
3.86M
        if (current >= max_nodes)
164
0
            return 0;
165
166
        /* Expand the size by a factor of 3/2 if it is within range */
167
3.86M
        current = current < limit ? current + current / 2 : max_nodes;
168
3.86M
    }
169
3.86M
    return current;
170
3.86M
}
171
172
/* internal STACK storage allocation */
173
static int sk_reserve(OPENSSL_STACK *st, int n, int exact)
174
356M
{
175
356M
    const void **tmpdata;
176
356M
    int num_alloc;
177
178
    /* Check to see the reservation isn't exceeding the hard limit */
179
356M
    if (n > max_nodes - st->num) {
180
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
181
0
        return 0;
182
0
    }
183
184
    /* Figure out the new size */
185
356M
    num_alloc = st->num + n;
186
356M
    if (num_alloc < min_nodes)
187
29.4M
        num_alloc = min_nodes;
188
189
    /* If |st->data| allocation was postponed */
190
356M
    if (st->data == NULL) {
191
        /*
192
         * At this point, |st->num_alloc| and |st->num| are 0;
193
         * so |num_alloc| value is |n| or |min_nodes| if greater than |n|.
194
         */
195
19.9M
        if ((st->data = OPENSSL_zalloc(sizeof(void *) * num_alloc)) == NULL) {
196
0
            ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
197
0
            return 0;
198
0
        }
199
19.9M
        st->num_alloc = num_alloc;
200
19.9M
        return 1;
201
19.9M
    }
202
203
336M
    if (!exact) {
204
336M
        if (num_alloc <= st->num_alloc)
205
328M
            return 1;
206
7.73M
        num_alloc = compute_growth(num_alloc, st->num_alloc);
207
7.73M
        if (num_alloc == 0) {
208
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
209
0
            return 0;
210
0
        }
211
7.73M
    } else if (num_alloc == st->num_alloc) {
212
0
        return 1;
213
0
    }
214
215
7.73M
    tmpdata = OPENSSL_realloc((void *)st->data, sizeof(void *) * num_alloc);
216
7.73M
    if (tmpdata == NULL) {
217
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
218
0
        return 0;
219
0
    }
220
221
7.73M
    st->data = tmpdata;
222
7.73M
    st->num_alloc = num_alloc;
223
7.73M
    return 1;
224
7.73M
}
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
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
232
0
        return NULL;
233
0
    }
234
235
171M
    st->comp = c;
236
237
171M
    if (n <= 0)
238
170M
        return st;
239
240
911k
    if (!sk_reserve(st, n, 1)) {
241
0
        OPENSSL_sk_free(st);
242
0
        return NULL;
243
0
    }
244
245
911k
    return st;
246
911k
}
247
248
int OPENSSL_sk_reserve(OPENSSL_STACK *st, int n)
249
0
{
250
0
    if (st == NULL) {
251
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
252
0
        return 0;
253
0
    }
254
255
0
    if (n < 0)
256
0
        return 1;
257
0
    return sk_reserve(st, n, 1);
258
0
}
259
260
int OPENSSL_sk_insert(OPENSSL_STACK *st, const void *data, int loc)
261
355M
{
262
355M
    if (st == NULL) {
263
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
264
0
        return 0;
265
0
    }
266
355M
    if (st->num == max_nodes) {
267
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_RECORDS);
268
0
        return 0;
269
0
    }
270
271
355M
    if (!sk_reserve(st, 1, 0))
272
0
        return 0;
273
274
355M
    if ((loc >= st->num) || (loc < 0)) {
275
355M
        st->data[st->num] = data;
276
355M
    } else {
277
5.61k
        memmove(&st->data[loc + 1], &st->data[loc],
278
5.61k
                sizeof(st->data[0]) * (st->num - loc));
279
5.61k
        st->data[loc] = data;
280
5.61k
    }
281
355M
    st->num++;
282
355M
    st->sorted = 0;
283
355M
    return st->num;
284
355M
}
285
286
static ossl_inline void *internal_delete(OPENSSL_STACK *st, int loc)
287
2.28M
{
288
2.28M
    const void *ret = st->data[loc];
289
290
2.28M
    if (loc != st->num - 1)
291
294k
        memmove(&st->data[loc], &st->data[loc + 1],
292
294k
                sizeof(st->data[0]) * (st->num - loc - 1));
293
2.28M
    st->num--;
294
295
2.28M
    return (void *)ret;
296
2.28M
}
297
298
void *OPENSSL_sk_delete_ptr(OPENSSL_STACK *st, const void *p)
299
205k
{
300
205k
    int i;
301
302
205k
    if (st == NULL)
303
0
        return NULL;
304
305
755k
    for (i = 0; i < st->num; i++)
306
755k
        if (st->data[i] == p)
307
205k
            return internal_delete(st, i);
308
0
    return NULL;
309
205k
}
310
311
void *OPENSSL_sk_delete(OPENSSL_STACK *st, int loc)
312
222k
{
313
222k
    if (st == NULL || loc < 0 || loc >= st->num)
314
0
        return NULL;
315
316
222k
    return internal_delete(st, loc);
317
222k
}
318
319
static int internal_find(OPENSSL_STACK *st, const void *data,
320
                         int ret_val_options, int *pnum)
321
22.8k
{
322
22.8k
    const void *r;
323
22.8k
    int i;
324
325
22.8k
    if (st == NULL || st->num == 0)
326
8.94k
        return -1;
327
328
13.9k
    if (st->comp == NULL) {
329
315k
        for (i = 0; i < st->num; i++)
330
315k
            if (st->data[i] == data) {
331
3.03k
                if (pnum != NULL)
332
0
                    *pnum = 1;
333
3.03k
                return i;
334
3.03k
            }
335
396
        if (pnum != NULL)
336
0
            *pnum = 0;
337
396
        return -1;
338
3.43k
    }
339
340
10.4k
    if (!st->sorted) {
341
1.65k
        if (st->num > 1)
342
0
            qsort(st->data, st->num, sizeof(void *), st->comp);
343
1.65k
        st->sorted = 1; /* empty or single-element stack is considered sorted */
344
1.65k
    }
345
10.4k
    if (data == NULL)
346
0
        return -1;
347
10.4k
    if (pnum != NULL)
348
2.13k
        ret_val_options |= OSSL_BSEARCH_FIRST_VALUE_ON_MATCH;
349
10.4k
    r = ossl_bsearch(&data, st->data, st->num, sizeof(void *), st->comp,
350
10.4k
                     ret_val_options);
351
352
10.4k
    if (pnum != NULL) {
353
2.13k
        *pnum = 0;
354
2.13k
        if (r != NULL) {
355
1.58k
            const void **p = (const void **)r;
356
357
3.16k
            while (p < st->data + st->num) {
358
1.58k
                if (st->comp(&data, p) != 0)
359
0
                    break;
360
1.58k
                ++*pnum;
361
1.58k
                ++p;
362
1.58k
            }
363
1.58k
        }
364
2.13k
    }
365
366
10.4k
    return r == NULL ? -1 : (int)((const void **)r - st->data);
367
10.4k
}
368
369
int OPENSSL_sk_find(OPENSSL_STACK *st, const void *data)
370
149k
{
371
149k
    return internal_find(st, data, OSSL_BSEARCH_FIRST_VALUE_ON_MATCH, NULL);
372
149k
}
373
374
int OPENSSL_sk_find_ex(OPENSSL_STACK *st, const void *data)
375
0
{
376
0
    return internal_find(st, data, OSSL_BSEARCH_VALUE_ON_NOMATCH, NULL);
377
0
}
378
379
int OPENSSL_sk_find_all(OPENSSL_STACK *st, const void *data, int *pnum)
380
100k
{
381
100k
    return internal_find(st, data, OSSL_BSEARCH_FIRST_VALUE_ON_MATCH, pnum);
382
100k
}
383
384
int OPENSSL_sk_push(OPENSSL_STACK *st, const void *data)
385
355M
{
386
355M
    if (st == NULL)
387
0
        return -1;
388
355M
    return OPENSSL_sk_insert(st, data, st->num);
389
355M
}
390
391
int OPENSSL_sk_unshift(OPENSSL_STACK *st, const void *data)
392
0
{
393
0
    return OPENSSL_sk_insert(st, data, 0);
394
0
}
395
396
void *OPENSSL_sk_shift(OPENSSL_STACK *st)
397
0
{
398
0
    if (st == NULL || st->num == 0)
399
0
        return NULL;
400
0
    return internal_delete(st, 0);
401
0
}
402
403
void *OPENSSL_sk_pop(OPENSSL_STACK *st)
404
1.86M
{
405
1.86M
    if (st == NULL || st->num == 0)
406
9.28k
        return NULL;
407
1.85M
    return internal_delete(st, st->num - 1);
408
1.86M
}
409
410
void OPENSSL_sk_zero(OPENSSL_STACK *st)
411
0
{
412
0
    if (st == NULL || st->num == 0)
413
0
        return;
414
0
    memset(st->data, 0, sizeof(*st->data) * st->num);
415
0
    st->num = 0;
416
0
}
417
418
void OPENSSL_sk_pop_free(OPENSSL_STACK *st, OPENSSL_sk_freefunc func)
419
47.9M
{
420
47.9M
    int i;
421
422
47.9M
    if (st == NULL)
423
10.8M
        return;
424
180M
    for (i = 0; i < st->num; i++)
425
143M
        if (st->data[i] != NULL)
426
143M
            func((char *)st->data[i]);
427
37.0M
    OPENSSL_sk_free(st);
428
37.0M
}
429
430
void OPENSSL_sk_free(OPENSSL_STACK *st)
431
217M
{
432
217M
    if (st == NULL)
433
40.2M
        return;
434
177M
    OPENSSL_free(st->data);
435
177M
    OPENSSL_free(st);
436
177M
}
437
438
int OPENSSL_sk_num(const OPENSSL_STACK *st)
439
1.06G
{
440
1.06G
    return st == NULL ? -1 : st->num;
441
1.06G
}
442
443
void *OPENSSL_sk_value(const OPENSSL_STACK *st, int i)
444
1.23G
{
445
1.23G
    if (st == NULL || i < 0 || i >= st->num)
446
4.64k
        return NULL;
447
1.23G
    return (void *)st->data[i];
448
1.23G
}
449
450
void *OPENSSL_sk_set(OPENSSL_STACK *st, int i, const void *data)
451
13.9M
{
452
13.9M
    if (st == NULL) {
453
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
454
0
        return NULL;
455
0
    }
456
13.9M
    if (i < 0 || i >= st->num) {
457
0
        ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_PASSED_INVALID_ARGUMENT,
458
0
                       "i=%d", i);
459
0
        return NULL;
460
0
    }
461
13.9M
    st->data[i] = data;
462
13.9M
    st->sorted = 0;
463
13.9M
    return (void *)st->data[i];
464
13.9M
}
465
466
void OPENSSL_sk_sort(OPENSSL_STACK *st)
467
16.9M
{
468
16.9M
    if (st != NULL && !st->sorted && st->comp != NULL) {
469
16.9M
        if (st->num > 1)
470
254k
            qsort(st->data, st->num, sizeof(void *), st->comp);
471
16.9M
        st->sorted = 1; /* empty or single-element stack is considered sorted */
472
16.9M
    }
473
16.9M
}
474
475
int OPENSSL_sk_is_sorted(const OPENSSL_STACK *st)
476
82.3k
{
477
82.3k
    return st == NULL ? 1 : st->sorted;
478
82.3k
}