xref: /freebsd/crypto/openssl/include/internal/namemap.h (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1*b077aed3SPierre Pronchery /*
2*b077aed3SPierre Pronchery  * Copyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved.
3*b077aed3SPierre Pronchery  *
4*b077aed3SPierre Pronchery  * Licensed under the Apache License 2.0 (the "License").  You may not use
5*b077aed3SPierre Pronchery  * this file except in compliance with the License.  You can obtain a copy
6*b077aed3SPierre Pronchery  * in the file LICENSE in the source distribution or at
7*b077aed3SPierre Pronchery  * https://www.openssl.org/source/license.html
8*b077aed3SPierre Pronchery  */
9*b077aed3SPierre Pronchery 
10*b077aed3SPierre Pronchery #include "internal/cryptlib.h"
11*b077aed3SPierre Pronchery 
12*b077aed3SPierre Pronchery typedef struct ossl_namemap_st OSSL_NAMEMAP;
13*b077aed3SPierre Pronchery 
14*b077aed3SPierre Pronchery OSSL_NAMEMAP *ossl_namemap_stored(OSSL_LIB_CTX *libctx);
15*b077aed3SPierre Pronchery 
16*b077aed3SPierre Pronchery OSSL_NAMEMAP *ossl_namemap_new(void);
17*b077aed3SPierre Pronchery void ossl_namemap_free(OSSL_NAMEMAP *namemap);
18*b077aed3SPierre Pronchery int ossl_namemap_empty(OSSL_NAMEMAP *namemap);
19*b077aed3SPierre Pronchery 
20*b077aed3SPierre Pronchery int ossl_namemap_add_name(OSSL_NAMEMAP *namemap, int number, const char *name);
21*b077aed3SPierre Pronchery int ossl_namemap_add_name_n(OSSL_NAMEMAP *namemap, int number,
22*b077aed3SPierre Pronchery                             const char *name, size_t name_len);
23*b077aed3SPierre Pronchery 
24*b077aed3SPierre Pronchery /*
25*b077aed3SPierre Pronchery  * The number<->name relationship is 1<->many
26*b077aed3SPierre Pronchery  * Therefore, the name->number mapping is a simple function, while the
27*b077aed3SPierre Pronchery  * number->name mapping is an iterator.
28*b077aed3SPierre Pronchery  */
29*b077aed3SPierre Pronchery int ossl_namemap_name2num(const OSSL_NAMEMAP *namemap, const char *name);
30*b077aed3SPierre Pronchery int ossl_namemap_name2num_n(const OSSL_NAMEMAP *namemap,
31*b077aed3SPierre Pronchery                             const char *name, size_t name_len);
32*b077aed3SPierre Pronchery const char *ossl_namemap_num2name(const OSSL_NAMEMAP *namemap, int number,
33*b077aed3SPierre Pronchery                                   size_t idx);
34*b077aed3SPierre Pronchery int ossl_namemap_doall_names(const OSSL_NAMEMAP *namemap, int number,
35*b077aed3SPierre Pronchery                              void (*fn)(const char *name, void *data),
36*b077aed3SPierre Pronchery                              void *data);
37*b077aed3SPierre Pronchery 
38*b077aed3SPierre Pronchery /*
39*b077aed3SPierre Pronchery  * A utility that handles several names in a string, divided by a given
40*b077aed3SPierre Pronchery  * separator.
41*b077aed3SPierre Pronchery  */
42*b077aed3SPierre Pronchery int ossl_namemap_add_names(OSSL_NAMEMAP *namemap, int number,
43*b077aed3SPierre Pronchery                            const char *names, const char separator);
44