Coverage Report

Created: 2025-08-11 07:04

/src/openssl34/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
180k
#define DEFAULT_BUF_SIZE    256
18
19
int WPACKET_allocate_bytes(WPACKET *pkt, size_t len, unsigned char **allocbytes)
20
112M
{
21
112M
    if (!WPACKET_reserve_bytes(pkt, len, allocbytes))
22
128k
        return 0;
23
24
112M
    pkt->written += len;
25
112M
    pkt->curr += len;
26
112M
    return 1;
27
112M
}
28
29
int WPACKET_sub_allocate_bytes__(WPACKET *pkt, size_t len,
30
                                 unsigned char **allocbytes, size_t lenbytes)
31
27.7k
{
32
27.7k
    if (!WPACKET_start_sub_packet_len__(pkt, lenbytes)
33
27.7k
            || !WPACKET_allocate_bytes(pkt, len, allocbytes)
34
27.7k
            || !WPACKET_close(pkt))
35
0
        return 0;
36
37
27.7k
    return 1;
38
27.7k
}
39
40
120M
#define GETBUF(p)   (((p)->staticbuf != NULL) \
41
120M
                     ? (p)->staticbuf \
42
120M
                     : ((p)->buf != NULL \
43
21.6M
                        ? (unsigned char *)(p)->buf->data \
44
21.6M
                        : NULL))
45
46
int WPACKET_reserve_bytes(WPACKET *pkt, size_t len, unsigned char **allocbytes)
47
114M
{
48
    /* Internal API, so should not fail */
49
114M
    if (!ossl_assert(pkt->subs != NULL && len != 0))
50
0
        return 0;
51
52
114M
    if (pkt->maxsize - pkt->written < len)
53
128k
        return 0;
54
55
113M
    if (pkt->buf != NULL && (pkt->buf->length - pkt->written < len)) {
56
102k
        size_t newlen;
57
102k
        size_t reflen;
58
59
102k
        reflen = (len > pkt->buf->length) ? len : pkt->buf->length;
60
61
102k
        if (reflen > SIZE_MAX / 2) {
62
0
            newlen = SIZE_MAX;
63
102k
        } else {
64
102k
            newlen = reflen * 2;
65
102k
            if (newlen < DEFAULT_BUF_SIZE)
66
77.3k
                newlen = DEFAULT_BUF_SIZE;
67
102k
        }
68
102k
        if (BUF_MEM_grow(pkt->buf, newlen) == 0)
69
0
            return 0;
70
102k
    }
71
113M
    if (allocbytes != NULL) {
72
112M
        *allocbytes = WPACKET_get_curr(pkt);
73
112M
        if (pkt->endfirst && *allocbytes != NULL)
74
53.6k
            *allocbytes -= len;
75
112M
    }
76
77
113M
    return 1;
78
113M
}
79
80
int WPACKET_sub_reserve_bytes__(WPACKET *pkt, size_t len,
81
                                unsigned char **allocbytes, size_t lenbytes)
82
6.80k
{
83
6.80k
    if (pkt->endfirst && lenbytes > 0)
84
0
        return 0;
85
86
6.80k
    if (!WPACKET_reserve_bytes(pkt, lenbytes + len, allocbytes))
87
0
        return 0;
88
89
6.80k
    if (*allocbytes != NULL)
90
6.80k
        *allocbytes += lenbytes;
91
92
6.80k
    return 1;
93
6.80k
}
94
95
static size_t maxmaxsize(size_t lenbytes)
96
18.2M
{
97
18.2M
    if (lenbytes >= sizeof(size_t) || lenbytes == 0)
98
18.2M
        return SIZE_MAX;
99
100
0
    return ((size_t)1 << (lenbytes * 8)) - 1 + lenbytes;
101
18.2M
}
102
103
static int wpacket_intern_init_len(WPACKET *pkt, size_t lenbytes)
104
11.5M
{
105
11.5M
    unsigned char *lenchars;
106
107
11.5M
    pkt->curr = 0;
108
11.5M
    pkt->written = 0;
109
110
11.5M
    if ((pkt->subs = OPENSSL_zalloc(sizeof(*pkt->subs))) == NULL)
111
0
        return 0;
112
113
11.5M
    if (lenbytes == 0)
114
11.5M
        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
10.8M
{
132
10.8M
    size_t max = maxmaxsize(lenbytes);
133
134
    /* Internal API, so should not fail */
135
10.8M
    if (!ossl_assert(buf != NULL && len > 0))
136
0
        return 0;
137
138
10.8M
    pkt->staticbuf = buf;
139
10.8M
    pkt->buf = NULL;
140
10.8M
    pkt->maxsize = (max < len) ? max : len;
141
10.8M
    pkt->endfirst = 0;
142
143
10.8M
    return wpacket_intern_init_len(pkt, lenbytes);
144
10.8M
}
145
146
int WPACKET_init_der(WPACKET *pkt, unsigned char *buf, size_t len)
147
17.8k
{
148
    /* Internal API, so should not fail */
149
17.8k
    if (!ossl_assert(buf != NULL && len > 0))
150
0
        return 0;
151
152
17.8k
    pkt->staticbuf = buf;
153
17.8k
    pkt->buf = NULL;
154
17.8k
    pkt->maxsize = len;
155
17.8k
    pkt->endfirst = 1;
156
157
17.8k
    return wpacket_intern_init_len(pkt, 0);
158
17.8k
}
159
160
int WPACKET_init_len(WPACKET *pkt, BUF_MEM *buf, size_t lenbytes)
161
293k
{
162
    /* Internal API, so should not fail */
163
293k
    if (!ossl_assert(buf != NULL))
164
0
        return 0;
165
166
293k
    pkt->staticbuf = NULL;
167
293k
    pkt->buf = buf;
168
293k
    pkt->maxsize = maxmaxsize(lenbytes);
169
293k
    pkt->endfirst = 0;
170
171
293k
    return wpacket_intern_init_len(pkt, lenbytes);
172
293k
}
173
174
int WPACKET_init(WPACKET *pkt, BUF_MEM *buf)
175
290k
{
176
290k
    return WPACKET_init_len(pkt, buf, 0);
177
290k
}
178
179
int WPACKET_init_null(WPACKET *pkt, size_t lenbytes)
180
387k
{
181
387k
    pkt->staticbuf = NULL;
182
387k
    pkt->buf = NULL;
183
387k
    pkt->maxsize = maxmaxsize(lenbytes);
184
387k
    pkt->endfirst = 0;
185
186
387k
    return wpacket_intern_init_len(pkt, 0);
187
387k
}
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
227k
{
201
    /* Internal API, so should not fail */
202
227k
    if (!ossl_assert(pkt->subs != NULL))
203
0
        return 0;
204
205
227k
    pkt->subs->flags = flags;
206
207
227k
    return 1;
208
227k
}
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
26.6M
{
213
26.6M
    if (data == NULL)
214
2.32M
        return 1;
215
216
68.8M
    for (data += len - 1; len > 0; len--) {
217
44.5M
        *data = (unsigned char)(value & 0xff);
218
44.5M
        data--;
219
44.5M
        value >>= 8;
220
44.5M
    }
221
222
    /* Check whether we could fit the value in the assigned number of bytes */
223
24.3M
    if (value > 0)
224
574
        return 0;
225
226
24.3M
    return 1;
227
24.3M
}
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
16.9M
{
252
16.9M
    size_t packlen = pkt->written - sub->pwritten;
253
254
16.9M
    if (packlen == 0
255
16.9M
            && (sub->flags & WPACKET_FLAGS_NON_ZERO_LENGTH) != 0)
256
0
        return 0;
257
258
16.9M
    if (packlen == 0
259
16.9M
            && sub->flags & WPACKET_FLAGS_ABANDON_ON_ZERO_LENGTH) {
260
        /* We can't handle this case. Return an error */
261
10.2k
        if (!doclose)
262
0
            return 0;
263
264
        /* Deallocate any bytes allocated for the length of the WPACKET */
265
10.2k
        if ((pkt->curr - sub->lenbytes) == sub->packet_len) {
266
10.2k
            pkt->written -= sub->lenbytes;
267
10.2k
            pkt->curr -= sub->lenbytes;
268
10.2k
        }
269
270
        /* Don't write out the packet length */
271
10.2k
        sub->packet_len = 0;
272
10.2k
        sub->lenbytes = 0;
273
10.2k
    }
274
275
    /* Write out the WPACKET length if needed */
276
16.9M
    if (sub->lenbytes > 0) {
277
4.84M
        unsigned char *buf = GETBUF(pkt);
278
279
4.84M
        if (buf != NULL) {
280
4.84M
#if !defined OPENSSL_NO_QUIC && !defined FIPS_MODULE
281
4.84M
            if ((sub->flags & WPACKET_FLAGS_QUIC_VLINT) == 0) {
282
4.84M
                if (!put_value(&buf[sub->packet_len], packlen, sub->lenbytes))
283
477
                    return 0;
284
4.84M
            } 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
4.84M
        }
293
12.1M
    } else if (pkt->endfirst && sub->parent != NULL
294
12.1M
               && (packlen != 0
295
15.1k
                   || (sub->flags
296
15.1k
                       & WPACKET_FLAGS_ABANDON_ON_ZERO_LENGTH) == 0)) {
297
15.1k
        size_t tmplen = packlen;
298
15.1k
        size_t numlenbytes = 1;
299
300
15.1k
        while ((tmplen = tmplen >> 8) > 0)
301
0
            numlenbytes++;
302
15.1k
        if (!WPACKET_put_bytes__(pkt, packlen, numlenbytes))
303
0
            return 0;
304
15.1k
        if (packlen > 0x7f) {
305
0
            numlenbytes |= 0x80;
306
0
            if (!WPACKET_put_bytes_u8(pkt, numlenbytes))
307
0
                return 0;
308
0
        }
309
15.1k
    }
310
311
16.9M
    if (doclose) {
312
16.9M
        pkt->subs = sub->parent;
313
16.9M
        OPENSSL_free(sub);
314
16.9M
    }
315
316
16.9M
    return 1;
317
16.9M
}
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.30M
{
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.30M
    if (pkt->subs == NULL || pkt->subs->parent == NULL)
341
0
        return 0;
342
343
6.30M
    return wpacket_intern_close(pkt, pkt->subs, 1);
344
6.30M
}
345
346
int WPACKET_finish(WPACKET *pkt)
347
11.2M
{
348
11.2M
    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
11.2M
    if (pkt->subs == NULL || pkt->subs->parent != NULL)
355
0
        return 0;
356
357
11.2M
    ret = wpacket_intern_close(pkt, pkt->subs, 1);
358
11.2M
    if (ret) {
359
11.2M
        OPENSSL_free(pkt->subs);
360
11.2M
        pkt->subs = NULL;
361
11.2M
    }
362
363
11.2M
    return ret;
364
11.2M
}
365
366
int WPACKET_start_sub_packet_len__(WPACKET *pkt, size_t lenbytes)
367
6.31M
{
368
6.31M
    WPACKET_SUB *sub;
369
6.31M
    unsigned char *lenchars;
370
371
    /* Internal API, so should not fail */
372
6.31M
    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.31M
    if (lenbytes > 0 && pkt->endfirst)
377
0
        return 0;
378
379
6.31M
    if ((sub = OPENSSL_zalloc(sizeof(*sub))) == NULL)
380
0
        return 0;
381
382
6.31M
    sub->parent = pkt->subs;
383
6.31M
    pkt->subs = sub;
384
6.31M
    sub->pwritten = pkt->written + lenbytes;
385
6.31M
    sub->lenbytes = lenbytes;
386
387
6.31M
    if (lenbytes == 0) {
388
1.23M
        sub->packet_len = 0;
389
1.23M
        return 1;
390
1.23M
    }
391
392
5.07M
    sub->packet_len = pkt->written;
393
394
5.07M
    if (!WPACKET_allocate_bytes(pkt, lenbytes, &lenchars))
395
0
        return 0;
396
397
5.07M
    return 1;
398
5.07M
}
399
400
int WPACKET_start_sub_packet(WPACKET *pkt)
401
1.23M
{
402
1.23M
    return WPACKET_start_sub_packet_len__(pkt, 0);
403
1.23M
}
404
405
int WPACKET_put_bytes__(WPACKET *pkt, uint64_t val, size_t size)
406
21.6M
{
407
21.6M
    unsigned char *data;
408
409
    /* Internal API, so should not fail */
410
21.6M
    if (!ossl_assert(size <= sizeof(uint64_t))
411
21.6M
            || !WPACKET_allocate_bytes(pkt, size, &data)
412
21.6M
            || !put_value(data, val, size))
413
51.9k
        return 0;
414
415
21.6M
    return 1;
416
21.6M
}
417
418
int WPACKET_set_max_size(WPACKET *pkt, size_t maxsize)
419
6.73M
{
420
6.73M
    WPACKET_SUB *sub;
421
6.73M
    size_t lenbytes;
422
423
    /* Internal API, so should not fail */
424
6.73M
    if (!ossl_assert(pkt->subs != NULL))
425
0
        return 0;
426
427
    /* Find the WPACKET_SUB for the top level */
428
6.73M
    for (sub = pkt->subs; sub->parent != NULL; sub = sub->parent)
429
0
        continue;
430
431
6.73M
    lenbytes = sub->lenbytes;
432
6.73M
    if (lenbytes == 0)
433
6.73M
        lenbytes = sizeof(pkt->maxsize);
434
435
6.73M
    if (maxmaxsize(lenbytes) < maxsize || maxsize < pkt->written)
436
0
        return 0;
437
438
6.73M
    pkt->maxsize = maxsize;
439
440
6.73M
    return 1;
441
6.73M
}
442
443
int WPACKET_memset(WPACKET *pkt, int ch, size_t len)
444
779k
{
445
779k
    unsigned char *dest;
446
447
779k
    if (len == 0)
448
0
        return 1;
449
450
779k
    if (!WPACKET_allocate_bytes(pkt, len, &dest))
451
2
        return 0;
452
453
779k
    if (dest != NULL)
454
779k
        memset(dest, ch, len);
455
456
779k
    return 1;
457
779k
}
458
459
int WPACKET_memcpy(WPACKET *pkt, const void *src, size_t len)
460
10.0M
{
461
10.0M
    unsigned char *dest;
462
463
10.0M
    if (len == 0)
464
3.78M
        return 1;
465
466
6.28M
    if (!WPACKET_allocate_bytes(pkt, len, &dest))
467
76.0k
        return 0;
468
469
6.20M
    if (dest != NULL)
470
6.20M
        memcpy(dest, src, len);
471
472
6.20M
    return 1;
473
6.28M
}
474
475
int WPACKET_sub_memcpy__(WPACKET *pkt, const void *src, size_t len,
476
                         size_t lenbytes)
477
1.61M
{
478
1.61M
    if (!WPACKET_start_sub_packet_len__(pkt, lenbytes)
479
1.61M
            || !WPACKET_memcpy(pkt, src, len)
480
1.61M
            || !WPACKET_close(pkt))
481
574
        return 0;
482
483
1.61M
    return 1;
484
1.61M
}
485
486
int WPACKET_get_total_written(WPACKET *pkt, size_t *written)
487
13.4M
{
488
    /* Internal API, so should not fail */
489
13.4M
    if (!ossl_assert(written != NULL))
490
0
        return 0;
491
492
13.4M
    *written = pkt->written;
493
494
13.4M
    return 1;
495
13.4M
}
496
497
int WPACKET_get_length(WPACKET *pkt, size_t *len)
498
1.52M
{
499
    /* Internal API, so should not fail */
500
1.52M
    if (!ossl_assert(pkt->subs != NULL && len != NULL))
501
0
        return 0;
502
503
1.52M
    *len = pkt->written - pkt->subs->pwritten;
504
505
1.52M
    return 1;
506
1.52M
}
507
508
unsigned char *WPACKET_get_curr(WPACKET *pkt)
509
115M
{
510
115M
    unsigned char *buf = GETBUF(pkt);
511
512
115M
    if (buf == NULL)
513
3.09M
        return NULL;
514
515
112M
    if (pkt->endfirst)
516
71.5k
        return buf + pkt->maxsize - pkt->curr;
517
518
112M
    return buf + pkt->curr;
519
112M
}
520
521
int WPACKET_is_null_buf(WPACKET *pkt)
522
387k
{
523
387k
    return pkt->buf == NULL && pkt->staticbuf == NULL;
524
387k
}
525
526
void WPACKET_cleanup(WPACKET *pkt)
527
569k
{
528
569k
    WPACKET_SUB *sub, *parent;
529
530
810k
    for (sub = pkt->subs; sub != NULL; sub = parent) {
531
240k
        parent = sub->parent;
532
240k
        OPENSSL_free(sub);
533
240k
    }
534
569k
    pkt->subs = NULL;
535
569k
}
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
41.1M
{
577
41.1M
    unsigned char *b = NULL;
578
41.1M
    size_t enclen = ossl_quic_vlint_encode_len(v);
579
580
41.1M
    if (enclen == 0)
581
0
        return 0;
582
583
41.1M
    if (WPACKET_allocate_bytes(pkt, enclen, &b) == 0)
584
857
        return 0;
585
586
41.1M
    ossl_quic_vlint_encode(b, v);
587
41.1M
    return 1;
588
41.1M
}
589
590
#endif