]> git.ipfire.org Git - thirdparty/openssl.git/blame - crypto/core_namemap.c
core namemap: use updated tsan lock detection capabilities
[thirdparty/openssl.git] / crypto / core_namemap.c
CommitLineData
f2182a4e 1/*
8020d79b 2 * Copyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved.
f2182a4e
RL
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
a9550b74 10#include "e_os.h" /* strcasecmp */
f2182a4e
RL
11#include "internal/namemap.h"
12#include <openssl/lhash.h>
285aa80e 13#include "crypto/lhash.h" /* ossl_lh_strcasehash */
c720fc35 14#include "internal/tsan_assist.h"
05aed12f 15#include "internal/sizes.h"
f2182a4e 16
651d4418
RL
17/*-
18 * The namenum entry
19 * =================
20 */
f2182a4e 21typedef struct {
651d4418 22 char *name;
f2182a4e 23 int number;
651d4418 24} NAMENUM_ENTRY;
f2182a4e 25
651d4418 26DEFINE_LHASH_OF(NAMENUM_ENTRY);
f2182a4e 27
651d4418
RL
28/*-
29 * The namemap itself
30 * ==================
31 */
f2182a4e
RL
32
33struct ossl_namemap_st {
34 /* Flags */
35 unsigned int stored:1; /* If 1, it's stored in a library context */
36
37 CRYPTO_RWLOCK *lock;
651d4418 38 LHASH_OF(NAMENUM_ENTRY) *namenum; /* Name->number mapping */
c720fc35 39
d8ed9e4a 40 TSAN_QUALIFIER int max_number; /* Current max number */
f2182a4e
RL
41};
42
43/* LHASH callbacks */
44
651d4418 45static unsigned long namenum_hash(const NAMENUM_ENTRY *n)
f2182a4e 46{
285aa80e 47 return ossl_lh_strcasehash(n->name);
f2182a4e
RL
48}
49
651d4418 50static int namenum_cmp(const NAMENUM_ENTRY *a, const NAMENUM_ENTRY *b)
f2182a4e 51{
a9550b74 52 return strcasecmp(a->name, b->name);
f2182a4e
RL
53}
54
651d4418 55static void namenum_free(NAMENUM_ENTRY *n)
f2182a4e 56{
651d4418
RL
57 if (n != NULL)
58 OPENSSL_free(n->name);
f2182a4e
RL
59 OPENSSL_free(n);
60}
61
b4250010 62/* OSSL_LIB_CTX_METHOD functions for a namemap stored in a library context */
f2182a4e 63
b4250010 64static void *stored_namemap_new(OSSL_LIB_CTX *libctx)
f2182a4e
RL
65{
66 OSSL_NAMEMAP *namemap = ossl_namemap_new();
67
68 if (namemap != NULL)
69 namemap->stored = 1;
70
71 return namemap;
72}
73
74static void stored_namemap_free(void *vnamemap)
75{
76 OSSL_NAMEMAP *namemap = vnamemap;
77
bd65afdb
P
78 if (namemap != NULL) {
79 /* Pretend it isn't stored, or ossl_namemap_free() will do nothing */
80 namemap->stored = 0;
81 ossl_namemap_free(namemap);
82 }
f2182a4e
RL
83}
84
b4250010 85static const OSSL_LIB_CTX_METHOD stored_namemap_method = {
a16d2174 86 OSSL_LIB_CTX_METHOD_DEFAULT_PRIORITY,
f2182a4e
RL
87 stored_namemap_new,
88 stored_namemap_free,
89};
90
651d4418
RL
91/*-
92 * API functions
93 * =============
94 */
f2182a4e 95
6a835fcf
RL
96int ossl_namemap_empty(OSSL_NAMEMAP *namemap)
97{
d8ed9e4a 98#ifdef TSAN_REQUIRES_LOCKING
c720fc35
P
99 /* No TSAN support */
100 int rv;
101
102 if (namemap == NULL)
103 return 1;
6a835fcf 104
cd3f8c1b
RS
105 if (!CRYPTO_THREAD_read_lock(namemap->lock))
106 return -1;
c720fc35 107 rv = namemap->max_number == 0;
6a835fcf 108 CRYPTO_THREAD_unlock(namemap->lock);
6a835fcf 109 return rv;
d8ed9e4a
P
110#else
111 /* Have TSAN support */
112 return namemap == NULL || tsan_load(&namemap->max_number) == 0;
c720fc35 113#endif
6a835fcf
RL
114}
115
651d4418
RL
116typedef struct doall_names_data_st {
117 int number;
d84f5515
MC
118 const char **names;
119 int found;
651d4418 120} DOALL_NAMES_DATA;
f2182a4e 121
651d4418 122static void do_name(const NAMENUM_ENTRY *namenum, DOALL_NAMES_DATA *data)
f2182a4e 123{
651d4418 124 if (namenum->number == data->number)
d84f5515 125 data->names[data->found++] = namenum->name;
651d4418 126}
f2182a4e 127
651d4418 128IMPLEMENT_LHASH_DOALL_ARG_CONST(NAMENUM_ENTRY, DOALL_NAMES_DATA);
f2182a4e 129
d84f5515
MC
130/*
131 * Call the callback for all names in the namemap with the given number.
132 * A return value 1 means that the callback was called for all names. A
133 * return value of 0 means that the callback was not called for any names.
134 */
135int ossl_namemap_doall_names(const OSSL_NAMEMAP *namemap, int number,
136 void (*fn)(const char *name, void *data),
137 void *data)
651d4418
RL
138{
139 DOALL_NAMES_DATA cbdata;
d84f5515
MC
140 size_t num_names;
141 int i;
f2182a4e 142
651d4418 143 cbdata.number = number;
d84f5515
MC
144 cbdata.found = 0;
145
146 /*
147 * We collect all the names first under a read lock. Subsequently we call
148 * the user function, so that we're not holding the read lock when in user
149 * code. This could lead to deadlocks.
150 */
cd3f8c1b
RS
151 if (!CRYPTO_THREAD_read_lock(namemap->lock))
152 return 0;
d84f5515 153
cd3f8c1b 154 num_names = lh_NAMENUM_ENTRY_num_items(namemap->namenum);
d84f5515
MC
155 if (num_names == 0) {
156 CRYPTO_THREAD_unlock(namemap->lock);
157 return 0;
158 }
159 cbdata.names = OPENSSL_malloc(sizeof(*cbdata.names) * num_names);
160 if (cbdata.names == NULL) {
161 CRYPTO_THREAD_unlock(namemap->lock);
162 return 0;
163 }
651d4418
RL
164 lh_NAMENUM_ENTRY_doall_DOALL_NAMES_DATA(namemap->namenum, do_name,
165 &cbdata);
f2182a4e 166 CRYPTO_THREAD_unlock(namemap->lock);
d84f5515
MC
167
168 for (i = 0; i < cbdata.found; i++)
169 fn(cbdata.names[i], data);
170
171 OPENSSL_free(cbdata.names);
172 return 1;
f2182a4e
RL
173}
174
79410c5f
P
175static int namemap_name2num_n(const OSSL_NAMEMAP *namemap,
176 const char *name, size_t name_len)
177{
178 NAMENUM_ENTRY *namenum_entry, namenum_tmpl;
179
180 if ((namenum_tmpl.name = OPENSSL_strndup(name, name_len)) == NULL)
181 return 0;
182 namenum_tmpl.number = 0;
183 namenum_entry =
184 lh_NAMENUM_ENTRY_retrieve(namemap->namenum, &namenum_tmpl);
185 OPENSSL_free(namenum_tmpl.name);
186 return namenum_entry != NULL ? namenum_entry->number : 0;
187}
188
695d195b
RL
189int ossl_namemap_name2num_n(const OSSL_NAMEMAP *namemap,
190 const char *name, size_t name_len)
f2182a4e 191{
79410c5f 192 int number;
f2182a4e 193
f844f9eb 194#ifndef FIPS_MODULE
f2182a4e
RL
195 if (namemap == NULL)
196 namemap = ossl_namemap_stored(NULL);
197#endif
198
199 if (namemap == NULL)
200 return 0;
201
cd3f8c1b
RS
202 if (!CRYPTO_THREAD_read_lock(namemap->lock))
203 return 0;
79410c5f 204 number = namemap_name2num_n(namemap, name, name_len);
f2182a4e
RL
205 CRYPTO_THREAD_unlock(namemap->lock);
206
651d4418 207 return number;
f2182a4e
RL
208}
209
695d195b
RL
210int ossl_namemap_name2num(const OSSL_NAMEMAP *namemap, const char *name)
211{
212 if (name == NULL)
213 return 0;
214
215 return ossl_namemap_name2num_n(namemap, name, strlen(name));
216}
217
f7c16d48
RL
218struct num2name_data_st {
219 size_t idx; /* Countdown */
220 const char *name; /* Result */
221};
222
223static void do_num2name(const char *name, void *vdata)
224{
225 struct num2name_data_st *data = vdata;
226
227 if (data->idx > 0)
228 data->idx--;
229 else if (data->name == NULL)
230 data->name = name;
231}
232
233const char *ossl_namemap_num2name(const OSSL_NAMEMAP *namemap, int number,
234 size_t idx)
235{
236 struct num2name_data_st data;
237
238 data.idx = idx;
239 data.name = NULL;
d84f5515
MC
240 if (!ossl_namemap_doall_names(namemap, number, do_num2name, &data))
241 return NULL;
f7c16d48
RL
242 return data.name;
243}
244
79410c5f
P
245static int namemap_add_name_n(OSSL_NAMEMAP *namemap, int number,
246 const char *name, size_t name_len)
f2182a4e 247{
651d4418
RL
248 NAMENUM_ENTRY *namenum = NULL;
249 int tmp_number;
f2182a4e 250
79410c5f
P
251 /* If it already exists, we don't add it */
252 if ((tmp_number = namemap_name2num_n(namemap, name, name_len)) != 0)
253 return tmp_number;
f2182a4e 254
651d4418 255 if ((namenum = OPENSSL_zalloc(sizeof(*namenum))) == NULL
695d195b 256 || (namenum->name = OPENSSL_strndup(name, name_len)) == NULL)
f2182a4e
RL
257 goto err;
258
d8ed9e4a 259 /* The tsan_counter use here is safe since we're under lock */
79410c5f 260 namenum->number =
c720fc35 261 number != 0 ? number : 1 + tsan_counter(&namemap->max_number);
651d4418
RL
262 (void)lh_NAMENUM_ENTRY_insert(namemap->namenum, namenum);
263
264 if (lh_NAMENUM_ENTRY_error(namemap->namenum))
f2182a4e 265 goto err;
79410c5f 266 return namenum->number;
f2182a4e
RL
267
268 err:
651d4418 269 namenum_free(namenum);
79410c5f
P
270 return 0;
271}
651d4418 272
79410c5f
P
273int ossl_namemap_add_name_n(OSSL_NAMEMAP *namemap, int number,
274 const char *name, size_t name_len)
275{
276 int tmp_number;
277
278#ifndef FIPS_MODULE
279 if (namemap == NULL)
280 namemap = ossl_namemap_stored(NULL);
281#endif
282
283 if (name == NULL || name_len == 0 || namemap == NULL)
284 return 0;
285
cd3f8c1b
RS
286 if (!CRYPTO_THREAD_write_lock(namemap->lock))
287 return 0;
79410c5f 288 tmp_number = namemap_add_name_n(namemap, number, name, name_len);
651d4418 289 CRYPTO_THREAD_unlock(namemap->lock);
79410c5f 290 return tmp_number;
f2182a4e 291}
695d195b 292
3d83c735 293int ossl_namemap_add_name(OSSL_NAMEMAP *namemap, int number, const char *name)
695d195b
RL
294{
295 if (name == NULL)
296 return 0;
297
3d83c735
RL
298 return ossl_namemap_add_name_n(namemap, number, name, strlen(name));
299}
300
301int ossl_namemap_add_names(OSSL_NAMEMAP *namemap, int number,
302 const char *names, const char separator)
303{
304 const char *p, *q;
305 size_t l;
306
307 /* Check that we have a namemap */
308 if (!ossl_assert(namemap != NULL)) {
309 ERR_raise(ERR_LIB_CRYPTO, ERR_R_PASSED_NULL_PARAMETER);
310 return 0;
311 }
312
cd3f8c1b
RS
313 if (!CRYPTO_THREAD_write_lock(namemap->lock))
314 return 0;
3d83c735
RL
315 /*
316 * Check that no name is an empty string, and that all names have at
317 * most one numeric identity together.
318 */
319 for (p = names; *p != '\0'; p = (q == NULL ? p + l : q + 1)) {
320 int this_number;
321
322 if ((q = strchr(p, separator)) == NULL)
323 l = strlen(p); /* offset to \0 */
324 else
325 l = q - p; /* offset to the next separator */
326
79410c5f 327 this_number = namemap_name2num_n(namemap, p, l);
3d83c735
RL
328
329 if (*p == '\0' || *p == separator) {
330 ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_BAD_ALGORITHM_NAME);
79410c5f 331 goto err;
3d83c735
RL
332 }
333 if (number == 0) {
334 number = this_number;
335 } else if (this_number != 0 && this_number != number) {
336 ERR_raise_data(ERR_LIB_CRYPTO, CRYPTO_R_CONFLICTING_NAMES,
337 "\"%.*s\" has an existing different identity %d (from \"%s\")",
338 l, p, this_number, names);
79410c5f 339 goto err;
3d83c735
RL
340 }
341 }
342
343 /* Now that we have checked, register all names */
344 for (p = names; *p != '\0'; p = (q == NULL ? p + l : q + 1)) {
345 int this_number;
346
347 if ((q = strchr(p, separator)) == NULL)
348 l = strlen(p); /* offset to \0 */
349 else
350 l = q - p; /* offset to the next separator */
351
79410c5f 352 this_number = namemap_add_name_n(namemap, number, p, l);
3d83c735
RL
353 if (number == 0) {
354 number = this_number;
355 } else if (this_number != number) {
e4a1d023 356 ERR_raise_data(ERR_LIB_CRYPTO, ERR_R_INTERNAL_ERROR,
3d83c735
RL
357 "Got number %d when expecting %d",
358 this_number, number);
79410c5f 359 goto err;
3d83c735
RL
360 }
361 }
362
79410c5f 363 CRYPTO_THREAD_unlock(namemap->lock);
3d83c735 364 return number;
79410c5f
P
365
366 err:
367 CRYPTO_THREAD_unlock(namemap->lock);
368 return 0;
695d195b 369}
437ad983
RL
370
371/*-
372 * Pre-population
373 * ==============
374 */
375
f844f9eb 376#ifndef FIPS_MODULE
437ad983
RL
377#include <openssl/evp.h>
378
379/* Creates an initial namemap with names found in the legacy method db */
c230e938
RL
380static void get_legacy_evp_names(int base_nid, int nid, const char *pem_name,
381 void *arg)
437ad983 382{
c230e938
RL
383 int num = 0;
384 ASN1_OBJECT *obj;
437ad983 385
c230e938
RL
386 if (base_nid != NID_undef) {
387 num = ossl_namemap_add_name(arg, num, OBJ_nid2sn(base_nid));
388 num = ossl_namemap_add_name(arg, num, OBJ_nid2ln(base_nid));
437ad983 389 }
05aed12f 390
c230e938
RL
391 if (nid != NID_undef) {
392 num = ossl_namemap_add_name(arg, num, OBJ_nid2sn(nid));
393 num = ossl_namemap_add_name(arg, num, OBJ_nid2ln(nid));
394 if ((obj = OBJ_nid2obj(nid)) != NULL) {
395 char txtoid[OSSL_MAX_NAME_SIZE];
05aed12f 396
2349d7ba 397 if (OBJ_obj2txt(txtoid, sizeof(txtoid), obj, 1) > 0)
c230e938
RL
398 num = ossl_namemap_add_name(arg, num, txtoid);
399 }
05aed12f 400 }
c230e938
RL
401 if (pem_name != NULL)
402 num = ossl_namemap_add_name(arg, num, pem_name);
437ad983
RL
403}
404
405static void get_legacy_cipher_names(const OBJ_NAME *on, void *arg)
406{
407 const EVP_CIPHER *cipher = (void *)OBJ_NAME_get(on->name, on->type);
408
7a85dd46
P
409 if (cipher != NULL)
410 get_legacy_evp_names(NID_undef, EVP_CIPHER_get_type(cipher), NULL, arg);
437ad983
RL
411}
412
413static void get_legacy_md_names(const OBJ_NAME *on, void *arg)
414{
415 const EVP_MD *md = (void *)OBJ_NAME_get(on->name, on->type);
01ba6c8e 416
7a85dd46
P
417 if (md != NULL)
418 get_legacy_evp_names(0, EVP_MD_get_type(md), NULL, arg);
05aed12f
RL
419}
420
421static void get_legacy_pkey_meth_names(const EVP_PKEY_ASN1_METHOD *ameth,
422 void *arg)
423{
424 int nid = 0, base_nid = 0, flags = 0;
c230e938 425 const char *pem_name = NULL;
05aed12f 426
c230e938 427 EVP_PKEY_asn1_get0_info(&nid, &base_nid, &flags, NULL, &pem_name, ameth);
05aed12f
RL
428 if (nid != NID_undef) {
429 if ((flags & ASN1_PKEY_ALIAS) == 0) {
c230e938
RL
430 switch (nid) {
431 case EVP_PKEY_DHX:
432 /* We know that the name "DHX" is used too */
433 get_legacy_evp_names(0, nid, "DHX", arg);
434 /* FALLTHRU */
435 default:
436 get_legacy_evp_names(0, nid, pem_name, arg);
437 }
05aed12f
RL
438 } else {
439 /*
440 * Treat aliases carefully, some of them are undesirable, or
441 * should not be treated as such for providers.
442 */
443
444 switch (nid) {
445 case EVP_PKEY_SM2:
05aed12f
RL
446 /*
447 * SM2 is a separate keytype with providers, not an alias for
448 * EC.
05aed12f 449 */
c230e938 450 get_legacy_evp_names(0, nid, pem_name, arg);
05aed12f
RL
451 break;
452 default:
453 /* Use the short name of the base nid as the common reference */
c230e938 454 get_legacy_evp_names(base_nid, nid, pem_name, arg);
05aed12f
RL
455 }
456 }
457 }
437ad983
RL
458}
459#endif
460
461/*-
462 * Constructors / destructors
463 * ==========================
464 */
465
b4250010 466OSSL_NAMEMAP *ossl_namemap_stored(OSSL_LIB_CTX *libctx)
437ad983 467{
cd3f8c1b
RS
468#ifndef FIPS_MODULE
469 int nms;
470#endif
437ad983 471 OSSL_NAMEMAP *namemap =
b4250010
DMSP
472 ossl_lib_ctx_get_data(libctx, OSSL_LIB_CTX_NAMEMAP_INDEX,
473 &stored_namemap_method);
437ad983 474
cd3f8c1b
RS
475 if (namemap == NULL)
476 return NULL;
477
f844f9eb 478#ifndef FIPS_MODULE
cd3f8c1b
RS
479 nms = ossl_namemap_empty(namemap);
480 if (nms < 0) {
481 /*
482 * Could not get lock to make the count, so maybe internal objects
483 * weren't added. This seems safest.
484 */
485 return NULL;
486 }
487 if (nms == 1) {
05aed12f
RL
488 int i, end;
489
437ad983
RL
490 /* Before pilfering, we make sure the legacy database is populated */
491 OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS
492 | OPENSSL_INIT_ADD_ALL_DIGESTS, NULL);
493
494 OBJ_NAME_do_all(OBJ_NAME_TYPE_CIPHER_METH,
495 get_legacy_cipher_names, namemap);
496 OBJ_NAME_do_all(OBJ_NAME_TYPE_MD_METH,
497 get_legacy_md_names, namemap);
05aed12f
RL
498
499 /* We also pilfer data from the legacy EVP_PKEY_ASN1_METHODs */
500 for (i = 0, end = EVP_PKEY_asn1_get_count(); i < end; i++)
501 get_legacy_pkey_meth_names(EVP_PKEY_asn1_get0(i), namemap);
437ad983
RL
502 }
503#endif
504
505 return namemap;
506}
507
508OSSL_NAMEMAP *ossl_namemap_new(void)
509{
510 OSSL_NAMEMAP *namemap;
511
512 if ((namemap = OPENSSL_zalloc(sizeof(*namemap))) != NULL
513 && (namemap->lock = CRYPTO_THREAD_lock_new()) != NULL
514 && (namemap->namenum =
515 lh_NAMENUM_ENTRY_new(namenum_hash, namenum_cmp)) != NULL)
516 return namemap;
517
518 ossl_namemap_free(namemap);
519 return NULL;
520}
521
522void ossl_namemap_free(OSSL_NAMEMAP *namemap)
523{
524 if (namemap == NULL || namemap->stored)
525 return;
526
527 lh_NAMENUM_ENTRY_doall(namemap->namenum, namenum_free);
528 lh_NAMENUM_ENTRY_free(namemap->namenum);
529
530 CRYPTO_THREAD_lock_free(namemap->lock);
531 OPENSSL_free(namemap);
532}