Coverage Report

Created: 2026-03-09 06:12

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl/crypto/core_namemap.c
Line
Count
Source
1
/*
2
 * Copyright 2019-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 "internal/namemap.h"
11
#include "internal/tsan_assist.h"
12
#include "internal/hashtable.h"
13
#include "internal/sizes.h"
14
#include "crypto/context.h"
15
#include "crypto/evp.h"
16
17
9
#define NAMEMAP_HT_BUCKETS 512
18
19
1.21k
#define NAMEMAP_NAME_LEN 64
20
HT_START_KEY_DEFN(namenum_key)
21
HT_DEF_KEY_FIELD_CHAR_ARRAY(name, NAMEMAP_NAME_LEN)
22
HT_END_KEY_DEFN(NAMENUM_KEY)
23
24
/*-
25
 * The namemap itself
26
 * ==================
27
 */
28
29
typedef STACK_OF(OPENSSL_STRING) NAMES;
30
31
DEFINE_STACK_OF(NAMES)
32
33
struct ossl_namemap_st {
34
    /* Flags */
35
    unsigned int stored : 1; /* If 1, it's stored in a library context */
36
37
    HT *namenum_ht; /* Name->number mapping */
38
39
    CRYPTO_RWLOCK *lock;
40
    STACK_OF(NAMES) *numnames;
41
42
    TSAN_QUALIFIER int max_number; /* Current max number */
43
};
44
45
static void name_string_free(char *name)
46
0
{
47
0
    OPENSSL_free(name);
48
0
}
49
50
static void names_free(NAMES *n)
51
0
{
52
0
    sk_OPENSSL_STRING_pop_free(n, name_string_free);
53
0
}
54
55
/* OSSL_LIB_CTX_METHOD functions for a namemap stored in a library context */
56
57
void *ossl_stored_namemap_new(OSSL_LIB_CTX *libctx)
58
9
{
59
9
    OSSL_NAMEMAP *namemap = ossl_namemap_new(libctx);
60
61
9
    if (namemap != NULL)
62
9
        namemap->stored = 1;
63
64
9
    return namemap;
65
9
}
66
67
void ossl_stored_namemap_free(void *vnamemap)
68
0
{
69
0
    OSSL_NAMEMAP *namemap = vnamemap;
70
71
0
    if (namemap != NULL) {
72
        /* Pretend it isn't stored, or ossl_namemap_free() will do nothing */
73
0
        namemap->stored = 0;
74
0
        ossl_namemap_free(namemap);
75
0
    }
76
0
}
77
78
/*-
79
 * API functions
80
 * =============
81
 */
82
83
int ossl_namemap_empty(OSSL_NAMEMAP *namemap)
84
957k
{
85
#ifdef TSAN_REQUIRES_LOCKING
86
    /* No TSAN support */
87
    int rv;
88
89
    if (namemap == NULL)
90
        return 1;
91
92
    if (!CRYPTO_THREAD_read_lock(namemap->lock))
93
        return -1;
94
    rv = namemap->max_number == 0;
95
    CRYPTO_THREAD_unlock(namemap->lock);
96
    return rv;
97
#else
98
    /* Have TSAN support */
99
957k
    return namemap == NULL || tsan_load(&namemap->max_number) == 0;
100
957k
#endif
101
957k
}
102
103
/*
104
 * Call the callback for all names in the namemap with the given number.
105
 * A return value 1 means that the callback was called for all names. A
106
 * return value of 0 means that the callback was not called for any names.
107
 */
108
int ossl_namemap_doall_names(const OSSL_NAMEMAP *namemap, int number,
109
    void (*fn)(const char *name, void *data),
110
    void *data)
111
290
{
112
290
    int i;
113
290
    NAMES *names;
114
115
290
    if (namemap == NULL || number <= 0)
116
0
        return 0;
117
118
    /*
119
     * We duplicate the NAMES stack under a read lock. Subsequently we call
120
     * the user function, so that we're not holding the read lock when in user
121
     * code. This could lead to deadlocks.
122
     */
123
290
    if (!CRYPTO_THREAD_read_lock(namemap->lock))
124
0
        return 0;
125
126
290
    names = sk_NAMES_value(namemap->numnames, number - 1);
127
290
    if (names != NULL)
128
290
        names = sk_OPENSSL_STRING_dup(names);
129
130
290
    CRYPTO_THREAD_unlock(namemap->lock);
131
132
290
    if (names == NULL)
133
0
        return 0;
134
135
935
    for (i = 0; i < sk_OPENSSL_STRING_num(names); i++)
136
645
        fn(sk_OPENSSL_STRING_value(names, i), data);
137
138
290
    sk_OPENSSL_STRING_free(names);
139
290
    return i > 0;
140
290
}
141
142
int ossl_namemap_name2num(const OSSL_NAMEMAP *namemap, const char *name)
143
959k
{
144
959k
    int number = 0;
145
959k
    HT_VALUE *val;
146
959k
    NAMENUM_KEY key;
147
148
959k
#ifndef FIPS_MODULE
149
959k
    if (namemap == NULL)
150
0
        namemap = ossl_namemap_stored(NULL);
151
959k
#endif
152
153
959k
    if (namemap == NULL)
154
0
        return 0;
155
156
959k
    HT_INIT_RAW_KEY(&key);
157
959k
    HT_COPY_RAW_KEY_CASE(TO_HT_KEY(&key), name, strlen(name));
158
159
959k
    val = ossl_ht_get(namemap->namenum_ht, TO_HT_KEY(&key));
160
161
959k
    if (val != NULL)
162
        /* We store a (small) int directly instead of a pointer to it. */
163
957k
        number = (int)(intptr_t)val->value;
164
165
959k
    return number;
166
959k
}
167
168
int ossl_namemap_name2num_n(const OSSL_NAMEMAP *namemap,
169
    const char *name, size_t name_len)
170
1.20k
{
171
1.20k
    int number = 0;
172
1.20k
    HT_VALUE *val;
173
1.20k
    NAMENUM_KEY key;
174
175
1.20k
#ifndef FIPS_MODULE
176
1.20k
    if (namemap == NULL)
177
0
        namemap = ossl_namemap_stored(NULL);
178
1.20k
#endif
179
180
1.20k
    if (namemap == NULL)
181
0
        return 0;
182
183
1.20k
    if (name_len > NAMEMAP_NAME_LEN)
184
9
        name_len = NAMEMAP_NAME_LEN;
185
186
1.20k
    HT_INIT_RAW_KEY(&key);
187
1.20k
    HT_COPY_RAW_KEY_CASE(TO_HT_KEY(&key), name, name_len);
188
189
1.20k
    val = ossl_ht_get(namemap->namenum_ht, TO_HT_KEY(&key));
190
191
1.20k
    if (val != NULL)
192
        /* We store a (small) int directly instead of a pointer to it. */
193
476
        number = (int)(intptr_t)val->value;
194
195
1.20k
    return number;
196
1.20k
}
197
198
const char *ossl_namemap_num2name(const OSSL_NAMEMAP *namemap, int number,
199
    int idx)
200
0
{
201
0
    NAMES *names;
202
0
    const char *ret = NULL;
203
204
0
    if (namemap == NULL || number <= 0)
205
0
        return NULL;
206
207
0
    if (!CRYPTO_THREAD_read_lock(namemap->lock))
208
0
        return NULL;
209
210
0
    names = sk_NAMES_value(namemap->numnames, number - 1);
211
0
    if (names != NULL)
212
0
        ret = sk_OPENSSL_STRING_value(names, idx);
213
214
0
    CRYPTO_THREAD_unlock(namemap->lock);
215
216
0
    return ret;
217
0
}
218
219
/* This function is not thread safe, the namemap must be locked */
220
static int numname_insert(OSSL_NAMEMAP *namemap, int number,
221
    const char *name)
222
1.31k
{
223
1.31k
    NAMES *names;
224
1.31k
    char *tmpname;
225
226
1.31k
    if (number > 0) {
227
733
        names = sk_NAMES_value(namemap->numnames, number - 1);
228
733
        if (!ossl_assert(names != NULL)) {
229
            /* cannot happen */
230
0
            return 0;
231
0
        }
232
733
    } else {
233
        /* a completely new entry */
234
586
        names = sk_OPENSSL_STRING_new_null();
235
586
        if (names == NULL)
236
0
            return 0;
237
586
    }
238
239
1.31k
    if ((tmpname = OPENSSL_strdup(name)) == NULL)
240
0
        goto err;
241
242
1.31k
    if (!sk_OPENSSL_STRING_push(names, tmpname))
243
0
        goto err;
244
1.31k
    tmpname = NULL;
245
246
1.31k
    if (number <= 0) {
247
586
        if (!sk_NAMES_push(namemap->numnames, names))
248
0
            goto err;
249
586
        number = sk_NAMES_num(namemap->numnames);
250
586
    }
251
1.31k
    return number;
252
253
0
err:
254
0
    if (number <= 0)
255
0
        sk_OPENSSL_STRING_pop_free(names, name_string_free);
256
0
    OPENSSL_free(tmpname);
257
0
    return 0;
258
1.31k
}
259
260
/* This function is not thread safe, the namemap must be locked */
261
static int namemap_add_name(OSSL_NAMEMAP *namemap, int number,
262
    const char *name)
263
3.22k
{
264
3.22k
    int ret;
265
3.22k
    HT_VALUE val = { 0 };
266
3.22k
    NAMENUM_KEY key;
267
268
    /* If it already exists, we don't add it */
269
3.22k
    if ((ret = ossl_namemap_name2num(namemap, name)) != 0)
270
1.91k
        return ret;
271
272
1.31k
    if ((number = numname_insert(namemap, number, name)) == 0)
273
0
        return 0;
274
275
    /* Using tsan_store alone here is safe since we're under lock */
276
1.31k
    tsan_store(&namemap->max_number, number);
277
278
1.31k
    HT_INIT_RAW_KEY(&key);
279
1.31k
    HT_COPY_RAW_KEY_CASE(TO_HT_KEY(&key), name, strlen(name));
280
281
1.31k
    val.value = (void *)(intptr_t)number;
282
1.31k
    ret = ossl_ht_insert(namemap->namenum_ht, TO_HT_KEY(&key), &val, NULL);
283
1.31k
    if (ret <= 0) {
284
        /*
285
         * We either got an allocation failure (INTERNAL_ERROR), or
286
         * hit too many conflicts in the table (TOO_MANY_NAMES)
287
         */
288
0
        ERR_raise(ERR_LIB_CRYPTO, (ret < 0) ? CRYPTO_R_TOO_MANY_NAMES : ERR_R_INTERNAL_ERROR);
289
0
        return 0;
290
0
    }
291
1.31k
    return number;
292
1.31k
}
293
294
int ossl_namemap_add_name(OSSL_NAMEMAP *namemap, int number,
295
    const char *name)
296
2.58k
{
297
2.58k
    int tmp_number;
298
299
2.58k
#ifndef FIPS_MODULE
300
2.58k
    if (namemap == NULL)
301
0
        namemap = ossl_namemap_stored(NULL);
302
2.58k
#endif
303
304
2.58k
    if (name == NULL || *name == 0 || namemap == NULL)
305
0
        return 0;
306
307
2.58k
    if (!CRYPTO_THREAD_write_lock(namemap->lock))
308
0
        return 0;
309
2.58k
    tmp_number = namemap_add_name(namemap, number, name);
310
2.58k
    CRYPTO_THREAD_unlock(namemap->lock);
311
2.58k
    return tmp_number;
312
2.58k
}
313
314
int ossl_namemap_add_names(OSSL_NAMEMAP *namemap, int number,
315
    const char *names, const char separator)
316
290
{
317
290
    char *tmp, *p, *q, *endp;
318
319
    /* Check that we have a namemap */
320
290
    if (!ossl_assert(namemap != NULL)) {
321
0
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
322
0
        return 0;
323
0
    }
324
325
290
    if ((tmp = OPENSSL_strdup(names)) == NULL)
326
0
        return 0;
327
328
290
    if (!CRYPTO_THREAD_write_lock(namemap->lock)) {
329
0
        OPENSSL_free(tmp);
330
0
        return 0;
331
0
    }
332
    /*
333
     * Check that no name is an empty string, and that all names have at
334
     * most one numeric identity together.
335
     */
336
935
    for (p = tmp; *p != '\0'; p = q) {
337
645
        int this_number;
338
645
        size_t l;
339
340
645
        if ((q = strchr(p, separator)) == NULL) {
341
290
            l = strlen(p); /* offset to \0 */
342
290
            q = p + l;
343
355
        } else {
344
355
            l = q - p; /* offset to the next separator */
345
355
            *q++ = '\0';
346
355
        }
347
348
645
        if (*p == '\0') {
349
0
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_BAD_ALGORITHM_NAME);
350
0
            number = 0;
351
0
            goto end;
352
0
        }
353
354
645
        this_number = ossl_namemap_name2num(namemap, p);
355
356
645
        if (number == 0) {
357
413
            number = this_number;
358
413
        } else if (this_number != 0 && this_number != number) {
359
0
            ERR_raise_data(ERR_LIB_CRYPTO, CRYPTO_R_CONFLICTING_NAMES,
360
0
                "\"%s\" has an existing different identity %d (from \"%s\")",
361
0
                p, this_number, names);
362
0
            number = 0;
363
0
            goto end;
364
0
        }
365
645
    }
366
290
    endp = p;
367
368
    /* Now that we have checked, register all names */
369
935
    for (p = tmp; p < endp; p = q) {
370
645
        int this_number;
371
372
645
        q = p + strlen(p) + 1;
373
374
645
        this_number = namemap_add_name(namemap, number, p);
375
645
        if (number == 0) {
376
118
            number = this_number;
377
527
        } else if (this_number != number) {
378
0
            ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR,
379
0
                "Got number %d when expecting %d",
380
0
                this_number, number);
381
0
            number = 0;
382
0
            goto end;
383
0
        }
384
645
    }
385
386
290
end:
387
290
    CRYPTO_THREAD_unlock(namemap->lock);
388
290
    OPENSSL_free(tmp);
389
290
    return number;
390
290
}
391
392
/*-
393
 * Pre-population
394
 * ==============
395
 */
396
397
#ifndef FIPS_MODULE
398
#include <openssl/evp.h>
399
400
/* Creates an initial namemap with names found in the legacy method db */
401
static void get_legacy_evp_names(int base_nid, int nid, const char *pem_name,
402
    void *arg)
403
996
{
404
996
    int num = 0;
405
996
    ASN1_OBJECT *obj;
406
407
996
    if (base_nid != NID_undef) {
408
16
        num = ossl_namemap_add_name(arg, num, OBJ_nid2sn(base_nid));
409
16
        num = ossl_namemap_add_name(arg, num, OBJ_nid2ln(base_nid));
410
16
    }
411
412
996
    if (nid != NID_undef) {
413
832
        num = ossl_namemap_add_name(arg, num, OBJ_nid2sn(nid));
414
832
        num = ossl_namemap_add_name(arg, num, OBJ_nid2ln(nid));
415
832
        if ((obj = OBJ_nid2obj(nid)) != NULL) {
416
832
            char txtoid[OSSL_MAX_NAME_SIZE];
417
418
832
            if (OBJ_obj2txt(txtoid, sizeof(txtoid), obj, 1) > 0)
419
828
                num = ossl_namemap_add_name(arg, num, txtoid);
420
832
        }
421
832
    }
422
996
    if (pem_name != NULL)
423
44
        num = ossl_namemap_add_name(arg, num, pem_name);
424
996
}
425
426
static void get_legacy_cipher_names(const OBJ_NAME *on, void *arg)
427
696
{
428
696
    const EVP_CIPHER *cipher = (void *)OBJ_NAME_get(on->name, on->type);
429
430
696
    if (cipher != NULL)
431
696
        get_legacy_evp_names(NID_undef, EVP_CIPHER_get_type(cipher), NULL, arg);
432
696
}
433
434
static void get_legacy_md_names(const OBJ_NAME *on, void *arg)
435
236
{
436
236
    const EVP_MD *md = (void *)OBJ_NAME_get(on->name, on->type);
437
438
236
    if (md != NULL)
439
236
        get_legacy_evp_names(NID_undef, EVP_MD_get_type(md), NULL, arg);
440
236
}
441
442
#ifndef OPENSSL_NO_DEPRECATED_3_6
443
static void get_legacy_pkey_meth_names(const EVP_PKEY_ASN1_METHOD *ameth,
444
    void *arg)
445
60
{
446
60
    int nid = 0, base_nid = 0, flags = 0;
447
60
    const char *pem_name = NULL;
448
449
60
    evp_pkey_asn1_get0_info(&nid, &base_nid, &flags, NULL, &pem_name, ameth);
450
60
    if (nid != NID_undef) {
451
60
        if ((flags & ASN1_PKEY_ALIAS) == 0) {
452
40
            switch (nid) {
453
4
            case EVP_PKEY_DHX:
454
                /* We know that the name "DHX" is used too */
455
4
                get_legacy_evp_names(0, nid, "DHX", arg);
456
                /* FALLTHRU */
457
40
            default:
458
40
                get_legacy_evp_names(0, nid, pem_name, arg);
459
40
            }
460
40
        } else {
461
            /*
462
             * Treat aliases carefully, some of them are undesirable, or
463
             * should not be treated as such for providers.
464
             */
465
466
20
            switch (nid) {
467
4
            case EVP_PKEY_SM2:
468
                /*
469
                 * SM2 is a separate keytype with providers, not an alias for
470
                 * EC.
471
                 */
472
4
                get_legacy_evp_names(0, nid, pem_name, arg);
473
4
                break;
474
16
            default:
475
                /* Use the short name of the base nid as the common reference */
476
16
                get_legacy_evp_names(base_nid, nid, pem_name, arg);
477
20
            }
478
20
        }
479
60
    }
480
60
}
481
#endif /* OPENSSL_NO_DEPRECATED_3_6 */
482
#endif
483
484
/*-
485
 * Constructors / destructors
486
 * ==========================
487
 */
488
489
OSSL_NAMEMAP *ossl_namemap_stored(OSSL_LIB_CTX *libctx)
490
957k
{
491
957k
#ifndef FIPS_MODULE
492
957k
    int nms;
493
957k
#endif
494
957k
    OSSL_NAMEMAP *namemap = ossl_lib_ctx_get_data(libctx, OSSL_LIB_CTX_NAMEMAP_INDEX);
495
496
957k
    if (namemap == NULL)
497
0
        return NULL;
498
499
957k
#ifndef FIPS_MODULE
500
957k
    nms = ossl_namemap_empty(namemap);
501
957k
    if (nms < 0) {
502
        /*
503
         * Could not get lock to make the count, so maybe internal objects
504
         * weren't added. This seems safest.
505
         */
506
0
        return NULL;
507
0
    }
508
957k
    if (nms == 1) {
509
4
        int num;
510
511
        /* Before pilfering, we make sure the legacy database is populated */
512
4
        OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS
513
4
                | OPENSSL_INIT_ADD_ALL_DIGESTS,
514
4
            NULL);
515
516
4
        OBJ_NAME_do_all(OBJ_NAME_TYPE_CIPHER_METH,
517
4
            get_legacy_cipher_names, namemap);
518
4
        OBJ_NAME_do_all(OBJ_NAME_TYPE_MD_METH,
519
4
            get_legacy_md_names, namemap);
520
521
        /*
522
         * Some old providers (<= 3.5) may not have the rsassaPSS alias which
523
         * may cause problems in some cases. We add it manually here
524
         */
525
4
        num = ossl_namemap_add_name(namemap, 0, "RSA-PSS");
526
4
        if (num != 0) {
527
4
            ossl_namemap_add_name(namemap, num, "rsassaPss");
528
            /* Add other RSA-PSS aliases as well */
529
4
            ossl_namemap_add_name(namemap, num, "RSASSA-PSS");
530
4
            ossl_namemap_add_name(namemap, num, "1.2.840.113549.1.1.10");
531
4
        }
532
4
#ifndef OPENSSL_NO_DEPRECATED_3_6
533
4
        {
534
4
            int i, end;
535
536
            /* We also pilfer data from the legacy EVP_PKEY_ASN1_METHODs */
537
64
            for (i = 0, end = evp_pkey_asn1_get_count(); i < end; i++)
538
60
                get_legacy_pkey_meth_names(evp_pkey_asn1_get0(i), namemap);
539
4
        }
540
4
#endif
541
4
    }
542
957k
#endif
543
544
957k
    return namemap;
545
957k
}
546
547
OSSL_NAMEMAP *ossl_namemap_new(OSSL_LIB_CTX *libctx)
548
9
{
549
9
    OSSL_NAMEMAP *namemap;
550
9
    HT_CONFIG htconf = { NULL, NULL, NULL, NAMEMAP_HT_BUCKETS, 1, 1, 0 };
551
552
9
    htconf.ctx = libctx;
553
554
9
    if ((namemap = OPENSSL_zalloc(sizeof(*namemap))) == NULL)
555
0
        goto err;
556
557
9
    if ((namemap->lock = CRYPTO_THREAD_lock_new()) == NULL)
558
0
        goto err;
559
560
9
    if ((namemap->namenum_ht = ossl_ht_new(&htconf)) == NULL)
561
0
        goto err;
562
563
9
    if ((namemap->numnames = sk_NAMES_new_null()) == NULL)
564
0
        goto err;
565
566
9
    return namemap;
567
568
0
err:
569
0
    ossl_namemap_free(namemap);
570
0
    return NULL;
571
9
}
572
573
void ossl_namemap_free(OSSL_NAMEMAP *namemap)
574
0
{
575
0
    if (namemap == NULL || namemap->stored)
576
0
        return;
577
578
0
    sk_NAMES_pop_free(namemap->numnames, names_free);
579
580
0
    ossl_ht_free(namemap->namenum_ht);
581
582
0
    CRYPTO_THREAD_lock_free(namemap->lock);
583
0
    OPENSSL_free(namemap);
584
0
}