Coverage Report

Created: 2026-10-28 06:28

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl41/crypto/o_str.c
Line
Count
Source
1
/*
2
 * Copyright 2003-2026 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/e_os.h"
11
#include <string.h>
12
#include <limits.h>
13
#include <openssl/crypto.h>
14
#include "crypto/ctype.h"
15
#include "internal/cryptlib.h"
16
#include "internal/thread_once.h"
17
#include "internal/to_hex.h"
18
19
126k
#define DEFAULT_SEPARATOR ':'
20
896M
#define CH_ZERO '\0'
21
22
char *CRYPTO_strdup(const char *str, const char *file, int line)
23
46.9M
{
24
46.9M
    char *ret;
25
46.9M
    size_t len;
26
27
46.9M
    if (str == NULL)
28
20
        return NULL;
29
30
46.9M
    len = strlen(str) + 1;
31
46.9M
    ret = CRYPTO_malloc(len, file, line);
32
46.9M
    if (ret != NULL)
33
46.9M
        memcpy(ret, str, len);
34
46.9M
    return ret;
35
46.9M
}
36
37
char *CRYPTO_strndup(const char *str, size_t s, const char *file, int line)
38
1.36M
{
39
1.36M
    size_t maxlen;
40
1.36M
    char *ret;
41
42
1.36M
    if (str == NULL)
43
8
        return NULL;
44
45
1.36M
    maxlen = OPENSSL_strnlen(str, s);
46
47
1.36M
    ret = CRYPTO_malloc(maxlen + 1, file, line);
48
1.36M
    if (ret) {
49
1.36M
        memcpy(ret, str, maxlen);
50
1.36M
        ret[maxlen] = CH_ZERO;
51
1.36M
    }
52
1.36M
    return ret;
53
1.36M
}
54
55
void *CRYPTO_memdup(const void *data, size_t siz, const char *file, int line)
56
24.7M
{
57
24.7M
    void *ret;
58
59
24.7M
    if (data == NULL || siz >= INT_MAX)
60
0
        return NULL;
61
62
24.7M
    ret = CRYPTO_malloc(siz, file, line);
63
24.7M
    if (ret == NULL)
64
0
        return NULL;
65
24.7M
    return memcpy(ret, data, siz);
66
24.7M
}
67
68
size_t OPENSSL_strnlen(const char *str, size_t maxlen)
69
165M
{
70
165M
    const char *p;
71
72
822M
    for (p = str; maxlen-- != 0 && *p != CH_ZERO; ++p)
73
656M
        ;
74
75
165M
    return p - str;
76
165M
}
77
78
size_t OPENSSL_strlcpy(char *dst, const char *src, size_t size)
79
74.2M
{
80
74.2M
    size_t l = 0;
81
819M
    for (; size > 1 && *src; size--) {
82
745M
        *dst++ = *src++;
83
745M
        l++;
84
745M
    }
85
74.2M
    if (size)
86
74.1M
        *dst = CH_ZERO;
87
74.2M
    return l + strlen(src);
88
74.2M
}
89
90
size_t OPENSSL_strlcat(char *dst, const char *src, size_t size)
91
55.3M
{
92
55.3M
    size_t l = 0;
93
661M
    for (; size > 0 && *dst; size--, dst++)
94
606M
        l++;
95
55.3M
    return l + OPENSSL_strlcpy(dst, src, size);
96
55.3M
}
97
98
/**
99
 * @brief Converts a string to an unsigned long integer.
100
 *
101
 * This function attempts to convert a string representation of a number
102
 * to an unsigned long integer, given a specified base. It also provides
103
 * error checking and reports whether the conversion was successful.
104
 * This function is just a wrapper around the POSIX strtoul function with
105
 * additional error checking.  This implies that errno for the caller is set
106
 * on calls to this function.
107
 *
108
 * @param str The string containing the representation of the number.
109
 * @param endptr A pointer to a pointer to character. If not NULL, it is set
110
 *               to the character immediately following the number in the
111
 *               string.
112
 * @param base The base to use for the conversion, which must be between 2,
113
 *             and 36 inclusive, or be the special value 0. If the base is 0,
114
 *             the actual base is determined by the format of the initial
115
 *             characters of the string.
116
 * @param num A pointer to an unsigned long where the result of the
117
 *            conversion is stored.
118
 *
119
 * @return 1 if the conversion was successful, 0 otherwise. Conversion is
120
 *         considered unsuccessful if no digits were consumed or if an error
121
 *         occurred during conversion.
122
 *
123
 * @note It is the caller's responsibility to check if the conversion is
124
 *       correct based on the expected consumption of the string as reported
125
 *       by endptr.
126
 */
127
int OPENSSL_strtoul(const char *str, char **endptr, int base,
128
    unsigned long *num)
129
0
{
130
0
    char *tmp_endptr;
131
0
    char **internal_endptr = endptr == NULL ? &tmp_endptr : endptr;
132
133
0
    errno = 0;
134
135
0
    *internal_endptr = (char *)str;
136
137
0
    if (num == NULL)
138
0
        return 0;
139
140
0
    if (str == NULL)
141
0
        return 0;
142
143
    /* Fail on negative input */
144
0
    if (*str == '-')
145
0
        return 0;
146
147
0
    *num = strtoul(str, internal_endptr, base);
148
    /*
149
     * We return error from this function under the following conditions
150
     * 1) If strtoul itself returned an error in translation
151
     * 2) If the caller didn't pass in an endptr value, and **internal_endptr
152
     *    doesn't point to '\0'.  The implication here is that if the caller
153
     *    doesn't care how much of a string is consumed, they expect the entire
154
     *    string to be consumed.  As such, no pointing to the NULL terminator
155
     *    means there was some part of the string left over after translation
156
     * 3) If no bytes of the string were consumed
157
     */
158
0
    if (errno != 0 || (endptr == NULL && **internal_endptr != '\0') || (str == *internal_endptr))
159
0
        return 0;
160
161
0
    return 1;
162
0
}
163
164
/*
165
 * Internal signed counterpart to OPENSSL_strtoul().  Parses a signed long with
166
 * the same validation rules: it fails on a conversion error (including
167
 * overflow/underflow), if no digits were consumed, or, when |endptr| is NULL,
168
 * if the whole string was not consumed.  Returns 1 on success (storing the
169
 * result in |*result|), 0 otherwise.
170
 */
171
int ossl_strtol(const char *str, char **endptr, int base, long *result)
172
1.23k
{
173
1.23k
    char *tmp_endptr;
174
1.23k
    char **internal_endptr = endptr == NULL ? &tmp_endptr : endptr;
175
176
1.23k
    errno = 0;
177
178
1.23k
    *internal_endptr = (char *)str;
179
180
1.23k
    if (result == NULL || str == NULL)
181
0
        return 0;
182
183
1.23k
    *result = strtol(str, internal_endptr, base);
184
1.23k
    if (errno != 0
185
1.23k
        || (endptr == NULL && **internal_endptr != '\0')
186
1.23k
        || str == *internal_endptr)
187
0
        return 0;
188
189
1.23k
    return 1;
190
1.23k
}
191
192
/*
193
 * As ossl_strtol() but stores the result in an int, additionally failing if
194
 * the parsed value does not fit in an int.  Returns 1 on success (storing the
195
 * result in |*result|), 0 otherwise.
196
 */
197
int ossl_strtoint(const char *str, char **endptr, int base, int *result)
198
1.23k
{
199
1.23k
    long l;
200
201
1.23k
    if (result == NULL || !ossl_strtol(str, endptr, base, &l))
202
0
        return 0;
203
1.23k
    if (l < INT_MIN || l > INT_MAX)
204
0
        return 0;
205
206
1.23k
    *result = (int)l;
207
1.23k
    return 1;
208
1.23k
}
209
210
int OPENSSL_hexchar2int(unsigned char c)
211
200k
{
212
#ifdef CHARSET_EBCDIC
213
    c = os_toebcdic[c];
214
#endif
215
216
200k
    switch (c) {
217
128k
    case '0':
218
128k
        return 0;
219
4.39k
    case '1':
220
4.39k
        return 1;
221
4.80k
    case '2':
222
4.80k
        return 2;
223
9.47k
    case '3':
224
9.47k
        return 3;
225
8.70k
    case '4':
226
8.70k
        return 4;
227
2.88k
    case '5':
228
2.88k
        return 5;
229
2.94k
    case '6':
230
2.94k
        return 6;
231
3.30k
    case '7':
232
3.30k
        return 7;
233
6.16k
    case '8':
234
6.16k
        return 8;
235
4.15k
    case '9':
236
4.15k
        return 9;
237
1.35k
    case 'a':
238
3.84k
    case 'A':
239
3.84k
        return 0x0A;
240
740
    case 'b':
241
1.63k
    case 'B':
242
1.63k
        return 0x0B;
243
1.53k
    case 'c':
244
3.06k
    case 'C':
245
3.06k
        return 0x0C;
246
1.69k
    case 'd':
247
2.19k
    case 'D':
248
2.19k
        return 0x0D;
249
1.06k
    case 'e':
250
1.15k
    case 'E':
251
1.15k
        return 0x0E;
252
9.89k
    case 'f':
253
12.9k
    case 'F':
254
12.9k
        return 0x0F;
255
200k
    }
256
560
    return -1;
257
200k
}
258
259
static int hexstr2buf_sep(unsigned char *buf, size_t buf_n, size_t *buflen,
260
    const char *str, const char sep)
261
1.70k
{
262
1.70k
    unsigned char *q;
263
1.70k
    unsigned char ch, cl;
264
1.70k
    int chi, cli;
265
1.70k
    const unsigned char *p;
266
1.70k
    size_t cnt;
267
268
11.9k
    for (p = (const unsigned char *)str, q = buf, cnt = 0; *p;) {
269
10.5k
        ch = *p++;
270
        /* A separator of CH_ZERO means there is no separator */
271
10.5k
        if (ch == sep && sep != CH_ZERO)
272
1.17k
            continue;
273
9.41k
        cl = *p++;
274
9.41k
        if (!cl) {
275
24
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ODD_NUMBER_OF_DIGITS);
276
24
            return 0;
277
24
        }
278
9.39k
        cli = OPENSSL_hexchar2int(cl);
279
9.39k
        chi = OPENSSL_hexchar2int(ch);
280
9.39k
        if (cli < 0 || chi < 0) {
281
329
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ILLEGAL_HEX_DIGIT);
282
329
            return 0;
283
329
        }
284
9.06k
        cnt++;
285
9.06k
        if (q != NULL) {
286
9.06k
            if (cnt > buf_n) {
287
0
                ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
288
0
                return 0;
289
0
            }
290
9.06k
            *q++ = (unsigned char)((chi << 4) | cli);
291
9.06k
        }
292
9.06k
    }
293
294
1.35k
    if (buflen != NULL)
295
1.35k
        *buflen = cnt;
296
1.35k
    return 1;
297
1.70k
}
298
299
/*
300
 * Given a string of hex digits convert to a buffer
301
 */
302
int OPENSSL_hexstr2buf_ex(unsigned char *buf, size_t buf_n, size_t *buflen,
303
    const char *str, const char sep)
304
0
{
305
0
    return hexstr2buf_sep(buf, buf_n, buflen, str, sep);
306
0
}
307
308
unsigned char *ossl_hexstr2buf_sep(const char *str, long *buflen,
309
    const char sep)
310
1.97k
{
311
1.97k
    unsigned char *buf;
312
1.97k
    size_t buf_n, tmp_buflen;
313
314
1.97k
    buf_n = strlen(str);
315
1.97k
    if (buf_n <= 1) {
316
264
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_HEX_STRING_TOO_SHORT);
317
264
        return NULL;
318
264
    }
319
1.70k
    buf_n /= 2;
320
1.70k
    if ((buf = OPENSSL_malloc(buf_n)) == NULL)
321
0
        return NULL;
322
323
1.70k
    if (buflen != NULL)
324
1.70k
        *buflen = 0;
325
1.70k
    tmp_buflen = 0;
326
1.70k
    if (hexstr2buf_sep(buf, buf_n, &tmp_buflen, str, sep)) {
327
1.35k
        if (buflen != NULL)
328
1.35k
            *buflen = (long)tmp_buflen;
329
1.35k
        return buf;
330
1.35k
    }
331
353
    OPENSSL_free(buf);
332
353
    return NULL;
333
1.70k
}
334
335
unsigned char *OPENSSL_hexstr2buf(const char *str, long *buflen)
336
1.97k
{
337
1.97k
    return ossl_hexstr2buf_sep(str, buflen, DEFAULT_SEPARATOR);
338
1.97k
}
339
340
static int buf2hexstr_sep(char *str, size_t str_n, size_t *strlength,
341
    const unsigned char *buf, size_t buflen,
342
    const char sep)
343
135k
{
344
135k
    char *q;
345
135k
    int has_sep = (sep != CH_ZERO);
346
135k
    size_t i, len = has_sep ? buflen * 3 : 1 + buflen * 2;
347
348
135k
    if (buflen > (has_sep ? SIZE_MAX / 3 : (SIZE_MAX - 1) / 2)) {
349
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_BYTES);
350
0
        return 0;
351
0
    }
352
353
135k
    if (len == 0)
354
0
        ++len;
355
135k
    if (strlength != NULL)
356
0
        *strlength = len;
357
135k
    if (str == NULL)
358
0
        return 1;
359
360
135k
    if (str_n < len) {
361
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
362
0
        return 0;
363
0
    }
364
365
135k
    q = str;
366
15.1M
    for (i = 0; i < buflen; i++) {
367
15.0M
        q += ossl_to_hex(q, buf[i]);
368
15.0M
        if (has_sep)
369
14.7M
            *q++ = sep;
370
15.0M
    }
371
135k
    if (has_sep && buflen > 0)
372
105k
        --q;
373
135k
    *q = CH_ZERO;
374
375
#ifdef CHARSET_EBCDIC
376
    ebcdic2ascii(str, str, q - str);
377
#endif
378
135k
    return 1;
379
135k
}
380
381
int OPENSSL_buf2hexstr_ex(char *str, size_t str_n, size_t *strlength,
382
    const unsigned char *buf, size_t buflen,
383
    const char sep)
384
0
{
385
0
    return buf2hexstr_sep(str, str_n, strlength, buf, buflen, sep);
386
0
}
387
388
char *ossl_buf2hexstr_sep(const unsigned char *buf, long buflen, char sep)
389
72.7k
{
390
72.7k
    char *tmp;
391
72.7k
    size_t tmp_n;
392
393
72.7k
    if (buflen < 0)
394
0
        return NULL;
395
72.7k
    if (buflen == 0)
396
5.00k
        return OPENSSL_zalloc(1);
397
398
67.7k
    if ((sep != CH_ZERO && (size_t)buflen > SIZE_MAX / 3)
399
67.7k
        || (sep == CH_ZERO && (size_t)buflen > (SIZE_MAX - 1) / 2)) {
400
0
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_MANY_BYTES);
401
0
        return NULL;
402
0
    }
403
404
67.7k
    tmp_n = (sep != CH_ZERO) ? (size_t)buflen * 3 : 1 + (size_t)buflen * 2;
405
67.7k
    if ((tmp = OPENSSL_malloc(tmp_n)) == NULL)
406
0
        return NULL;
407
408
67.7k
    if (buf2hexstr_sep(tmp, tmp_n, NULL, buf, buflen, sep))
409
67.7k
        return tmp;
410
0
    OPENSSL_free(tmp);
411
0
    return NULL;
412
67.7k
}
413
414
/*
415
 * Given a buffer of length 'buflen' return a OPENSSL_malloc'ed string with
416
 * its hex representation @@@ (Contents of buffer are always kept in ASCII,
417
 * also on EBCDIC machines)
418
 */
419
char *OPENSSL_buf2hexstr(const unsigned char *buf, long buflen)
420
124k
{
421
124k
    return ossl_buf2hexstr_sep(buf, buflen, DEFAULT_SEPARATOR);
422
124k
}
423
424
int openssl_strerror_r(int errnum, char *buf, size_t buflen)
425
0
{
426
#if defined(_MSC_VER) && _MSC_VER >= 1400
427
    return !strerror_s(buf, buflen, errnum);
428
#elif defined(_GNU_SOURCE)
429
    char *err;
430
431
    /*
432
     * GNU strerror_r may not actually set buf.
433
     * It can return a pointer to some (immutable) static string in which case
434
     * buf is left unused.
435
     */
436
    err = strerror_r(errnum, buf, buflen);
437
    if (err == NULL || buflen == 0)
438
        return 0;
439
    /*
440
     * If err is statically allocated, err != buf and we need to copy the data.
441
     * If err points somewhere inside buf, OPENSSL_strlcpy can handle this,
442
     * since src and dest are not annotated with __restrict and the function
443
     * reads src byte for byte and writes to dest.
444
     * If err == buf we do not have to copy anything.
445
     */
446
    if (err != buf)
447
        OPENSSL_strlcpy(buf, err, buflen);
448
    return 1;
449
#elif (defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112L) || (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE >= 600)
450
    /*
451
     * We can use "real" strerror_r. The OpenSSL version differs in that it
452
     * gives 1 on success and 0 on failure for consistency with other OpenSSL
453
     * functions. Real strerror_r does it the other way around
454
     */
455
0
    return !strerror_r(errnum, buf, buflen);
456
#else
457
    char *err;
458
459
    /* Fall back to non-thread safe strerror()...its all we can do */
460
    if (buflen < 2)
461
        return 0;
462
    err = strerror(errnum);
463
    /* Can this ever happen? */
464
    if (err == NULL)
465
        return 0;
466
    OPENSSL_strlcpy(buf, err, buflen);
467
    return 1;
468
#endif
469
0
}
470
471
int OPENSSL_strcasecmp(const char *s1, const char *s2)
472
53.3M
{
473
53.3M
    int t;
474
475
201M
    while ((t = ossl_tolower(*s1) - ossl_tolower(*s2++)) == 0)
476
161M
        if (*s1++ == '\0')
477
13.4M
            return 0;
478
39.8M
    return t;
479
53.3M
}
480
481
int OPENSSL_strncasecmp(const char *s1, const char *s2, size_t n)
482
115M
{
483
115M
    int t;
484
115M
    size_t i;
485
486
135M
    for (i = 0; i < n; i++)
487
133M
        if ((t = ossl_tolower(*s1) - ossl_tolower(*s2++)) != 0)
488
112M
            return t;
489
20.6M
        else if (*s1++ == '\0')
490
0
            return 0;
491
2.48M
    return 0;
492
115M
}
493
494
size_t ossl_to_hex(char *buf, uint8_t n)
495
344M
{
496
344M
    static const char hexdig[] = "0123456789ABCDEF";
497
498
344M
    return to_hex(buf, n, hexdig);
499
344M
}