Coverage Report

Created: 2025-08-28 07:07

/src/openssl32/crypto/packet.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2015-2023 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 "internal/cryptlib.h"
11
#include "internal/packet.h"
12
#if !defined OPENSSL_NO_QUIC && !defined FIPS_MODULE
13
# include "internal/packet_quic.h"
14
#endif
15
#include <openssl/err.h>
16
17
188k
#define DEFAULT_BUF_SIZE    256
18
19
int WPACKET_allocate_bytes(WPACKET *pkt, size_t len, unsigned char **allocbytes)
20
128M
{
21
128M
    if (!WPACKET_reserve_bytes(pkt, len, allocbytes))
22
123k
        return 0;
23
24
127M
    pkt->written += len;
25
127M
    pkt->curr += len;
26
127M
    return 1;
27
128M
}
28
29
int WPACKET_sub_allocate_bytes__(WPACKET *pkt, size_t len,
30
                                 unsigned char **allocbytes, size_t lenbytes)
31
29.2k
{
32
29.2k
    if (!WPACKET_start_sub_packet_len__(pkt, lenbytes)
33
29.2k
            || !WPACKET_allocate_bytes(pkt, len, allocbytes)
34
29.2k
            || !WPACKET_close(pkt))
35
0
        return 0;
36
37
29.2k
    return 1;
38
29.2k
}
39
40
136M
#define GETBUF(p)   (((p)->staticbuf != NULL) \
41
136M
                     ? (p)->staticbuf \
42
136M
                     : ((p)->buf != NULL \
43
22.9M
                        ? (unsigned char *)(p)->buf->data \
44
22.9M
                        : NULL))
45
46
int WPACKET_reserve_bytes(WPACKET *pkt, size_t len, unsigned char **allocbytes)
47
130M
{
48
    /* Internal API, so should not fail */
49
130M
    if (!ossl_assert(pkt->subs != NULL && len != 0))
50
0
        return 0;
51
52
130M
    if (pkt->maxsize - pkt->written < len)
53
123k
        return 0;
54
55
129M
    if (pkt->buf != NULL && (pkt->buf->length - pkt->written < len)) {
56
108k
        size_t newlen;
57
108k
        size_t reflen;
58
59
108k
        reflen = (len > pkt->buf->length) ? len : pkt->buf->length;
60
61
108k
        if (reflen > SIZE_MAX / 2) {
62
0
            newlen = SIZE_MAX;
63
108k
        } else {
64
108k
            newlen = reflen * 2;
65
108k
            if (newlen < DEFAULT_BUF_SIZE)
66
80.8k
                newlen = DEFAULT_BUF_SIZE;
67
108k
        }
68
108k
        if (BUF_MEM_grow(pkt->buf, newlen) == 0)
69
0
            return 0;
70
108k
    }
71
129M
    if (allocbytes != NULL) {
72
127M
        *allocbytes = WPACKET_get_curr(pkt);
73
127M
        if (pkt->endfirst && *allocbytes != NULL)
74
56.1k
            *allocbytes -= len;
75
127M
    }
76
77
129M
    return 1;
78
129M
}
79
80
int WPACKET_sub_reserve_bytes__(WPACKET *pkt, size_t len,
81
                                unsigned char **allocbytes, size_t lenbytes)
82
6.74k
{
83
6.74k
    if (pkt->endfirst && lenbytes > 0)
84
0
        return 0;
85
86
6.74k
    if (!WPACKET_reserve_bytes(pkt, lenbytes + len, allocbytes))
87
0
        return 0;
88
89
6.74k
    if (*allocbytes != NULL)
90
6.74k
        *allocbytes += lenbytes;
91
92
6.74k
    return 1;
93
6.74k
}
94
95
static size_t maxmaxsize(size_t lenbytes)
96
20.4M
{
97
20.4M
    if (lenbytes >= sizeof(size_t) || lenbytes == 0)
98
20.4M
        return SIZE_MAX;
99
100
0
    return ((size_t)1 << (lenbytes * 8)) - 1 + lenbytes;
101
20.4M
}
102
103
static int wpacket_intern_init_len(WPACKET *pkt, size_t lenbytes)
104
12.7M
{
105
12.7M
    unsigned char *lenchars;
106
107
12.7M
    pkt->curr = 0;
108
12.7M
    pkt->written = 0;
109
110
12.7M
    if ((pkt->subs = OPENSSL_zalloc(sizeof(*pkt->subs))) == NULL)
111
0
        return 0;
112
113
12.7M
    if (lenbytes == 0)
114
12.7M
        return 1;
115
116
0
    pkt->subs->pwritten = lenbytes;
117
0
    pkt->subs->lenbytes = lenbytes;
118
119
0
    if (!WPACKET_allocate_bytes(pkt, lenbytes, &lenchars)) {
120
0
        OPENSSL_free(pkt->subs);
121
0
        pkt->subs = NULL;
122
0
        return 0;
123
0
    }
124
0
    pkt->subs->packet_len = 0;
125
126
0
    return 1;
127
0
}
128
129
int WPACKET_init_static_len(WPACKET *pkt, unsigned char *buf, size_t len,
130
                            size_t lenbytes)
131
12.0M
{
132
12.0M
    size_t max = maxmaxsize(lenbytes);
133
134
    /* Internal API, so should not fail */
135
12.0M
    if (!ossl_assert(buf != NULL && len > 0))
136
0
        return 0;
137
138
12.0M
    pkt->staticbuf = buf;
139
12.0M
    pkt->buf = NULL;
140
12.0M
    pkt->maxsize = (max < len) ? max : len;
141
12.0M
    pkt->endfirst = 0;
142
143
12.0M
    return wpacket_intern_init_len(pkt, lenbytes);
144
12.0M
}
145
146
int WPACKET_init_der(WPACKET *pkt, unsigned char *buf, size_t len)
147
18.7k
{
148
    /* Internal API, so should not fail */
149
18.7k
    if (!ossl_assert(buf != NULL && len > 0))
150
0
        return 0;
151
152
18.7k
    pkt->staticbuf = buf;
153
18.7k
    pkt->buf = NULL;
154
18.7k
    pkt->maxsize = len;
155
18.7k
    pkt->endfirst = 1;
156
157
18.7k
    return wpacket_intern_init_len(pkt, 0);
158
18.7k
}
159
160
int WPACKET_init_len(WPACKET *pkt, BUF_MEM *buf, size_t lenbytes)
161
308k
{
162
    /* Internal API, so should not fail */
163
308k
    if (!ossl_assert(buf != NULL))
164
0
        return 0;
165
166
308k
    pkt->staticbuf = NULL;
167
308k
    pkt->buf = buf;
168
308k
    pkt->maxsize = maxmaxsize(lenbytes);
169
308k
    pkt->endfirst = 0;
170
171
308k
    return wpacket_intern_init_len(pkt, lenbytes);
172
308k
}
173
174
int WPACKET_init(WPACKET *pkt, BUF_MEM *buf)
175
304k
{
176
304k
    return WPACKET_init_len(pkt, buf, 0);
177
304k
}
178
179
int WPACKET_init_null(WPACKET *pkt, size_t lenbytes)
180
438k
{
181
438k
    pkt->staticbuf = NULL;
182
438k
    pkt->buf = NULL;
183
438k
    pkt->maxsize = maxmaxsize(lenbytes);
184
438k
    pkt->endfirst = 0;
185
186
438k
    return wpacket_intern_init_len(pkt, 0);
187
438k
}
188
189
int WPACKET_init_null_der(WPACKET *pkt)
190
6
{
191
6
    pkt->staticbuf = NULL;
192
6
    pkt->buf = NULL;
193
6
    pkt->maxsize = SIZE_MAX;
194
6
    pkt->endfirst = 1;
195
196
6
    return wpacket_intern_init_len(pkt, 0);
197
6
}
198
199
int WPACKET_set_flags(WPACKET *pkt, unsigned int flags)
200
237k
{
201
    /* Internal API, so should not fail */
202
237k
    if (!ossl_assert(pkt->subs != NULL))
203
0
        return 0;
204
205
237k
    pkt->subs->flags = flags;
206
207
237k
    return 1;
208
237k
}
209
210
/* Store the |value| of length |len| at location |data| */
211
static int put_value(unsigned char *data, uint64_t value, size_t len)
212
28.0M
{
213
28.0M
    if (data == NULL)
214
2.63M
        return 1;
215
216
71.9M
    for (data += len - 1; len > 0; len--) {
217
46.4M
        *data = (unsigned char)(value & 0xff);
218
46.4M
        data--;
219
46.4M
        value >>= 8;
220
46.4M
    }
221
222
    /* Check whether we could fit the value in the assigned number of bytes */
223
25.4M
    if (value > 0)
224
644
        return 0;
225
226
25.4M
    return 1;
227
25.4M
}
228
229
#if !defined OPENSSL_NO_QUIC && !defined FIPS_MODULE
230
static int put_quic_value(unsigned char *data, size_t value, size_t len)
231
0
{
232
0
    if (data == NULL)
233
0
        return 1;
234
235
    /* Value too large for field. */
236
0
    if (ossl_quic_vlint_encode_len(value) > len)
237
0
        return 0;
238
239
0
    ossl_quic_vlint_encode_n(data, value, len);
240
0
    return 1;
241
0
}
242
#endif
243
244
/*
245
 * Internal helper function used by WPACKET_close(), WPACKET_finish() and
246
 * WPACKET_fill_lengths() to close a sub-packet and write out its length if
247
 * necessary. If |doclose| is 0 then it goes through the motions of closing
248
 * (i.e. it fills in all the lengths), but doesn't actually close anything.
249
 */
250
static int wpacket_intern_close(WPACKET *pkt, WPACKET_SUB *sub, int doclose)
251
18.6M
{
252
18.6M
    size_t packlen = pkt->written - sub->pwritten;
253
254
18.6M
    if (packlen == 0
255
18.6M
            && (sub->flags & WPACKET_FLAGS_NON_ZERO_LENGTH) != 0)
256
0
        return 0;
257
258
18.6M
    if (packlen == 0
259
18.6M
            && sub->flags & WPACKET_FLAGS_ABANDON_ON_ZERO_LENGTH) {
260
        /* We can't handle this case. Return an error */
261
11.4k
        if (!doclose)
262
0
            return 0;
263
264
        /* Deallocate any bytes allocated for the length of the WPACKET */
265
11.4k
        if ((pkt->curr - sub->lenbytes) == sub->packet_len) {
266
11.4k
            pkt->written -= sub->lenbytes;
267
11.4k
            pkt->curr -= sub->lenbytes;
268
11.4k
        }
269
270
        /* Don't write out the packet length */
271
11.4k
        sub->packet_len = 0;
272
11.4k
        sub->lenbytes = 0;
273
11.4k
    }
274
275
    /* Write out the WPACKET length if needed */
276
18.6M
    if (sub->lenbytes > 0) {
277
5.04M
        unsigned char *buf = GETBUF(pkt);
278
279
5.04M
        if (buf != NULL) {
280
5.04M
#if !defined OPENSSL_NO_QUIC && !defined FIPS_MODULE
281
5.04M
            if ((sub->flags & WPACKET_FLAGS_QUIC_VLINT) == 0) {
282
5.04M
                if (!put_value(&buf[sub->packet_len], packlen, sub->lenbytes))
283
536
                    return 0;
284
5.04M
            } else {
285
0
                if (!put_quic_value(&buf[sub->packet_len], packlen, sub->lenbytes))
286
0
                    return 0;
287
0
            }
288
#else
289
            if (!put_value(&buf[sub->packet_len], packlen, sub->lenbytes))
290
                return 0;
291
#endif
292
5.04M
        }
293
13.6M
    } else if (pkt->endfirst && sub->parent != NULL
294
13.6M
               && (packlen != 0
295
15.8k
                   || (sub->flags
296
15.8k
                       & WPACKET_FLAGS_ABANDON_ON_ZERO_LENGTH) == 0)) {
297
15.8k
        size_t tmplen = packlen;
298
15.8k
        size_t numlenbytes = 1;
299
300
15.8k
        while ((tmplen = tmplen >> 8) > 0)
301
0
            numlenbytes++;
302
15.8k
        if (!WPACKET_put_bytes__(pkt, packlen, numlenbytes))
303
0
            return 0;
304
15.8k
        if (packlen > 0x7f) {
305
0
            numlenbytes |= 0x80;
306
0
            if (!WPACKET_put_bytes_u8(pkt, numlenbytes))
307
0
                return 0;
308
0
        }
309
15.8k
    }
310
311
18.6M
    if (doclose) {
312
18.6M
        pkt->subs = sub->parent;
313
18.6M
        OPENSSL_free(sub);
314
18.6M
    }
315
316
18.6M
    return 1;
317
18.6M
}
318
319
int WPACKET_fill_lengths(WPACKET *pkt)
320
0
{
321
0
    WPACKET_SUB *sub;
322
323
0
    if (!ossl_assert(pkt->subs != NULL))
324
0
        return 0;
325
326
0
    for (sub = pkt->subs; sub != NULL; sub = sub->parent) {
327
0
        if (!wpacket_intern_close(pkt, sub, 0))
328
0
            return 0;
329
0
    }
330
331
0
    return 1;
332
0
}
333
334
int WPACKET_close(WPACKET *pkt)
335
6.67M
{
336
    /*
337
     * Internal API, so should not fail - but we do negative testing of this
338
     * so no assert (otherwise the tests fail)
339
     */
340
6.67M
    if (pkt->subs == NULL || pkt->subs->parent == NULL)
341
0
        return 0;
342
343
6.67M
    return wpacket_intern_close(pkt, pkt->subs, 1);
344
6.67M
}
345
346
int WPACKET_finish(WPACKET *pkt)
347
12.5M
{
348
12.5M
    int ret;
349
350
    /*
351
     * Internal API, so should not fail - but we do negative testing of this
352
     * so no assert (otherwise the tests fail)
353
     */
354
12.5M
    if (pkt->subs == NULL || pkt->subs->parent != NULL)
355
0
        return 0;
356
357
12.5M
    ret = wpacket_intern_close(pkt, pkt->subs, 1);
358
12.5M
    if (ret) {
359
12.5M
        OPENSSL_free(pkt->subs);
360
12.5M
        pkt->subs = NULL;
361
12.5M
    }
362
363
12.5M
    return ret;
364
12.5M
}
365
366
int WPACKET_start_sub_packet_len__(WPACKET *pkt, size_t lenbytes)
367
6.67M
{
368
6.67M
    WPACKET_SUB *sub;
369
6.67M
    unsigned char *lenchars;
370
371
    /* Internal API, so should not fail */
372
6.67M
    if (!ossl_assert(pkt->subs != NULL))
373
0
        return 0;
374
375
    /* We don't support lenbytes greater than 0 when doing endfirst writing */
376
6.67M
    if (lenbytes > 0 && pkt->endfirst)
377
0
        return 0;
378
379
6.67M
    if ((sub = OPENSSL_zalloc(sizeof(*sub))) == NULL)
380
0
        return 0;
381
382
6.67M
    sub->parent = pkt->subs;
383
6.67M
    pkt->subs = sub;
384
6.67M
    sub->pwritten = pkt->written + lenbytes;
385
6.67M
    sub->lenbytes = lenbytes;
386
387
6.67M
    if (lenbytes == 0) {
388
1.39M
        sub->packet_len = 0;
389
1.39M
        return 1;
390
1.39M
    }
391
392
5.27M
    sub->packet_len = pkt->written;
393
394
5.27M
    if (!WPACKET_allocate_bytes(pkt, lenbytes, &lenchars))
395
0
        return 0;
396
397
5.27M
    return 1;
398
5.27M
}
399
400
int WPACKET_start_sub_packet(WPACKET *pkt)
401
1.39M
{
402
1.39M
    return WPACKET_start_sub_packet_len__(pkt, 0);
403
1.39M
}
404
405
int WPACKET_put_bytes__(WPACKET *pkt, uint64_t val, size_t size)
406
22.8M
{
407
22.8M
    unsigned char *data;
408
409
    /* Internal API, so should not fail */
410
22.8M
    if (!ossl_assert(size <= sizeof(uint64_t))
411
22.8M
            || !WPACKET_allocate_bytes(pkt, size, &data)
412
22.8M
            || !put_value(data, val, size))
413
46.0k
        return 0;
414
415
22.8M
    return 1;
416
22.8M
}
417
418
int WPACKET_set_max_size(WPACKET *pkt, size_t maxsize)
419
7.68M
{
420
7.68M
    WPACKET_SUB *sub;
421
7.68M
    size_t lenbytes;
422
423
    /* Internal API, so should not fail */
424
7.68M
    if (!ossl_assert(pkt->subs != NULL))
425
0
        return 0;
426
427
    /* Find the WPACKET_SUB for the top level */
428
7.68M
    for (sub = pkt->subs; sub->parent != NULL; sub = sub->parent)
429
0
        continue;
430
431
7.68M
    lenbytes = sub->lenbytes;
432
7.68M
    if (lenbytes == 0)
433
7.68M
        lenbytes = sizeof(pkt->maxsize);
434
435
7.68M
    if (maxmaxsize(lenbytes) < maxsize || maxsize < pkt->written)
436
0
        return 0;
437
438
7.68M
    pkt->maxsize = maxsize;
439
440
7.68M
    return 1;
441
7.68M
}
442
443
int WPACKET_memset(WPACKET *pkt, int ch, size_t len)
444
808k
{
445
808k
    unsigned char *dest;
446
447
808k
    if (len == 0)
448
0
        return 1;
449
450
808k
    if (!WPACKET_allocate_bytes(pkt, len, &dest))
451
2
        return 0;
452
453
808k
    if (dest != NULL)
454
808k
        memset(dest, ch, len);
455
456
808k
    return 1;
457
808k
}
458
459
int WPACKET_memcpy(WPACKET *pkt, const void *src, size_t len)
460
10.5M
{
461
10.5M
    unsigned char *dest;
462
463
10.5M
    if (len == 0)
464
3.97M
        return 1;
465
466
6.60M
    if (!WPACKET_allocate_bytes(pkt, len, &dest))
467
76.9k
        return 0;
468
469
6.53M
    if (dest != NULL)
470
6.53M
        memcpy(dest, src, len);
471
472
6.53M
    return 1;
473
6.60M
}
474
475
int WPACKET_sub_memcpy__(WPACKET *pkt, const void *src, size_t len,
476
                         size_t lenbytes)
477
1.68M
{
478
1.68M
    if (!WPACKET_start_sub_packet_len__(pkt, lenbytes)
479
1.68M
            || !WPACKET_memcpy(pkt, src, len)
480
1.68M
            || !WPACKET_close(pkt))
481
644
        return 0;
482
483
1.68M
    return 1;
484
1.68M
}
485
486
int WPACKET_get_total_written(WPACKET *pkt, size_t *written)
487
14.9M
{
488
    /* Internal API, so should not fail */
489
14.9M
    if (!ossl_assert(written != NULL))
490
0
        return 0;
491
492
14.9M
    *written = pkt->written;
493
494
14.9M
    return 1;
495
14.9M
}
496
497
int WPACKET_get_length(WPACKET *pkt, size_t *len)
498
1.64M
{
499
    /* Internal API, so should not fail */
500
1.64M
    if (!ossl_assert(pkt->subs != NULL && len != NULL))
501
0
        return 0;
502
503
1.64M
    *len = pkt->written - pkt->subs->pwritten;
504
505
1.64M
    return 1;
506
1.64M
}
507
508
unsigned char *WPACKET_get_curr(WPACKET *pkt)
509
131M
{
510
131M
    unsigned char *buf = GETBUF(pkt);
511
512
131M
    if (buf == NULL)
513
3.50M
        return NULL;
514
515
127M
    if (pkt->endfirst)
516
74.8k
        return buf + pkt->maxsize - pkt->curr;
517
518
127M
    return buf + pkt->curr;
519
127M
}
520
521
int WPACKET_is_null_buf(WPACKET *pkt)
522
437k
{
523
437k
    return pkt->buf == NULL && pkt->staticbuf == NULL;
524
437k
}
525
526
void WPACKET_cleanup(WPACKET *pkt)
527
548k
{
528
548k
    WPACKET_SUB *sub, *parent;
529
530
747k
    for (sub = pkt->subs; sub != NULL; sub = parent) {
531
199k
        parent = sub->parent;
532
199k
        OPENSSL_free(sub);
533
199k
    }
534
548k
    pkt->subs = NULL;
535
548k
}
536
537
#if !defined OPENSSL_NO_QUIC && !defined FIPS_MODULE
538
539
int WPACKET_start_quic_sub_packet_bound(WPACKET *pkt, size_t max_len)
540
0
{
541
0
    size_t enclen = ossl_quic_vlint_encode_len(max_len);
542
543
0
    if (enclen == 0)
544
0
        return 0;
545
546
0
    if (WPACKET_start_sub_packet_len__(pkt, enclen) == 0)
547
0
        return 0;
548
549
0
    pkt->subs->flags |= WPACKET_FLAGS_QUIC_VLINT;
550
0
    return 1;
551
0
}
552
553
int WPACKET_start_quic_sub_packet(WPACKET *pkt)
554
0
{
555
    /*
556
     * Assume no (sub)packet will exceed 4GiB, thus the 8-byte encoding need not
557
     * be used.
558
     */
559
0
    return WPACKET_start_quic_sub_packet_bound(pkt, OSSL_QUIC_VLINT_4B_MIN);
560
0
}
561
562
int WPACKET_quic_sub_allocate_bytes(WPACKET *pkt, size_t len, unsigned char **allocbytes)
563
0
{
564
0
    if (!WPACKET_start_quic_sub_packet_bound(pkt, len)
565
0
            || !WPACKET_allocate_bytes(pkt, len, allocbytes)
566
0
            || !WPACKET_close(pkt))
567
0
        return 0;
568
569
0
    return 1;
570
0
}
571
572
/*
573
 * Write a QUIC variable-length integer to the packet.
574
 */
575
int WPACKET_quic_write_vlint(WPACKET *pkt, uint64_t v)
576
49.1M
{
577
49.1M
    unsigned char *b = NULL;
578
49.1M
    size_t enclen = ossl_quic_vlint_encode_len(v);
579
580
49.1M
    if (enclen == 0)
581
0
        return 0;
582
583
49.1M
    if (WPACKET_allocate_bytes(pkt, enclen, &b) == 0)
584
850
        return 0;
585
586
49.1M
    ossl_quic_vlint_encode(b, v);
587
49.1M
    return 1;
588
49.1M
}
589
590
#endif