summaryrefslogtreecommitdiffstats
path: root/hicn-light/src/config/symbolicNameTable.h
blob: 69919cf000c3bdd43546fd1749bf3ddddf86121a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
/*
 * Copyright (c) 2017-2019 Cisco and/or its affiliates.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * @file symbolicNameTable.h
 * @brief The symbolic name table maps a string name to a connection id
 *
 * When configuring tunnels/connections, the user provides a string name
 * (symbolic name) that they will use to refer to that connection.  The symblic
 * name table translates that symbolic name to a connection id.
 *
 */

#ifndef symbolicNameTable_h
#define symbolicNameTable_h

struct symblic_name_table;
typedef struct symblic_name_table SymbolicNameTable;

#include <stdbool.h>

/**
 * Creates a symbolic name table
 *
 * Allocates a SymbolicNameTable, which will store the symbolic names
 * in a hash table.
 *
 * @retval non-null An allocated SymbolicNameTable
 * @retval null An error
 *
 * Example:
 * @code
 * <#example#>
 * @endcode
 */
SymbolicNameTable *symbolicNameTable_Create(void);

/**
 * Destroys a name table
 *
 * All keys and data are released.
 *
 * @param [in,out] tablePtr A pointer to a SymbolicNameTable, which will be
 * NULL'd
 *
 * Example:
 * @code
 * <#example#>
 * @endcode
 */
void symbolicNameTable_Destroy(SymbolicNameTable **tablePtr);

/**
 * Checks if the name (case insensitive) is in the table
 *
 * Does a case-insensitive match to see if the name is in the table
 *
 * @param [in] table An allocated SymbolicNameTable
 * @param [in] symbolicName The name to check for
 *
 * @retval true The name is in the table
 * @retval false The name is not in the talbe
 *
 * Example:
 * @code
 * <#example#>
 * @endcode
 */
bool symbolicNameTable_Exists(SymbolicNameTable *table,
                              const char *symbolicName);

/**
 * Adds a (name, connid) pair to the table.
 *
 * The name is stored case insensitive.  The value UINT_MAX is used to indicate
 * a non-existent key, so it should not be stored as a value in the table.
 *
 * @param [in] table An allocated SymbolicNameTable
 * @param [in] symbolicName The name to save (will make a copy)
 * @param [in] connid The connection id to associate with the name
 *
 * @retval true The pair was added
 * @retval false The pair was not added (likely duplicate key)
 *
 * Example:
 * @code
 * <#example#>
 * @endcode
 */
bool symbolicNameTable_Add(SymbolicNameTable *table, const char *symbolicName,
                           unsigned connid);

/**
 * Returns the connection id associated with the symbolic name
 *
 * This function will look for the given name (case insensitive) and return the
 * corresponding connid.  If the name is not in the table, the function will
 * return UINT_MAX.
 *
 * @param [in] table An allocated SymbolicNameTable
 * @param [in] symbolicName The name to retrieve
 *
 * @retval UINT_MAX symbolicName not found
 * @retval number the corresponding connid.
 *
 * Example:
 * @code
 * <#example#>
 * @endcode
 */
unsigned symbolicNameTable_Get(SymbolicNameTable *table,
                               const char *symbolicName);

void symbolicNameTable_Remove(SymbolicNameTable *table,
                              const char *symbolicName);
const char *symbolicNameTable_GetNameByIndex(SymbolicNameTable *table,
                                             unsigned id);

#endif /* defined(symbolicNameTable_h) */