Wireshark  4.3.0
The Wireshark network protocol analyzer
wmem_core.h
Go to the documentation of this file.
1 
12 #ifndef __WMEM_CORE_H__
13 #define __WMEM_CORE_H__
14 
15 #include <stdint.h>
16 #include <stdbool.h>
17 #include <string.h>
18 #include <glib.h>
19 #include <ws_symbol_export.h>
20 #include <ws_attributes.h>
21 #include <ws_posix_compat.h>
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif /* __cplusplus */
26 
42 struct _wmem_allocator_t;
44 typedef struct _wmem_allocator_t wmem_allocator_t;
45 
47 typedef enum _wmem_allocator_type_t {
66 
73 WS_DLL_PUBLIC
74 void *
75 wmem_alloc(wmem_allocator_t *allocator, const size_t size)
76 G_GNUC_MALLOC;
77 
84 #define wmem_new(allocator, type) \
85  ((type*)wmem_alloc((allocator), sizeof(type)))
86 
87 /*
88  * Overflow-safe multiplication of the size of a type by a number of
89  * items of that type, returning 0 if the result would overflow (or
90  * if the number of elements is negative), and the product otherwise.
91  */
92 #define wmem_safe_mult_type_size(type, num) \
93  ((((num) <= 0) || ((size_t)sizeof(type) > (G_MAXSSIZE / (size_t)(num)))) ? 0 : (sizeof(type) * (num)))
94 
102 #define wmem_alloc_array(allocator, type, num) \
103  ((type*)wmem_alloc((allocator), wmem_safe_mult_type_size(type, (num))))
104 
112 WS_DLL_PUBLIC
113 void *
114 wmem_alloc0(wmem_allocator_t *allocator, const size_t size)
115 G_GNUC_MALLOC;
116 
124 #define wmem_new0(allocator, type) \
125  ((type*)wmem_alloc0((allocator), sizeof(type)))
126 
135 #define wmem_alloc0_array(allocator, type, num) \
136  ((type*)wmem_alloc0((allocator), wmem_safe_mult_type_size(type, (num))))
137 
148 WS_DLL_PUBLIC
149 void
150 wmem_free(wmem_allocator_t *allocator, void *ptr);
151 
161 WS_DLL_PUBLIC
162 void *
163 wmem_realloc(wmem_allocator_t *allocator, void *ptr, const size_t size);
164 
172 WS_DLL_PUBLIC
173 void
174 wmem_free_all(wmem_allocator_t *allocator);
175 
182 WS_DLL_PUBLIC
183 void
184 wmem_gc(wmem_allocator_t *allocator);
185 
191 WS_DLL_PUBLIC
192 void
194 
201 WS_DLL_PUBLIC
204 
208 WS_DLL_PUBLIC
209 void
210 wmem_init(void);
211 
216 WS_DLL_PUBLIC
217 void
218 wmem_cleanup(void);
219 
220 WS_DLL_PUBLIC
221 void
222 wmem_enter_scope(wmem_allocator_t *allocator);
223 
224 WS_DLL_PUBLIC
225 void
226 wmem_leave_scope(wmem_allocator_t *allocator);
227 
228 WS_DLL_PUBLIC
229 bool
230 wmem_in_scope(wmem_allocator_t *allocator);
231 
234 #ifdef __cplusplus
235 }
236 #endif /* __cplusplus */
237 
238 #endif /* __WMEM_CORE_H__ */
239 
240 /*
241  * Editor modelines - https://www.wireshark.org/tools/modelines.html
242  *
243  * Local variables:
244  * c-basic-offset: 4
245  * tab-width: 8
246  * indent-tabs-mode: nil
247  * End:
248  *
249  * vi: set shiftwidth=4 tabstop=8 expandtab:
250  * :indentSize=4:tabSize=8:noTabs=true:
251  */
WS_DLL_PUBLIC void wmem_init(void)
Definition: wmem_core.c:168
WS_DLL_PUBLIC void * wmem_alloc(wmem_allocator_t *allocator, const size_t size) G_GNUC_MALLOC
Definition: wmem_core.c:32
WS_DLL_PUBLIC void wmem_free_all(wmem_allocator_t *allocator)
Definition: wmem_core.c:108
WS_DLL_PUBLIC void * wmem_realloc(wmem_allocator_t *allocator, void *ptr, const size_t size)
Definition: wmem_core.c:79
WS_DLL_PUBLIC void wmem_free(wmem_allocator_t *allocator, void *ptr)
Definition: wmem_core.c:62
_wmem_allocator_type_t
Definition: wmem_core.h:47
WS_DLL_PUBLIC void wmem_cleanup(void)
Definition: wmem_core.c:205
WS_DLL_PUBLIC void wmem_gc(wmem_allocator_t *allocator)
Definition: wmem_core.c:114
WS_DLL_PUBLIC wmem_allocator_t * wmem_allocator_new(const wmem_allocator_type_t type)
Definition: wmem_core.c:129
WS_DLL_PUBLIC void * wmem_alloc0(wmem_allocator_t *allocator, const size_t size) G_GNUC_MALLOC
Definition: wmem_core.c:48
WS_DLL_PUBLIC void wmem_destroy_allocator(wmem_allocator_t *allocator)
Definition: wmem_core.c:120
enum _wmem_allocator_type_t wmem_allocator_type_t
@ WMEM_ALLOCATOR_BLOCK
Definition: wmem_core.h:52
@ WMEM_ALLOCATOR_STRICT
Definition: wmem_core.h:56
@ WMEM_ALLOCATOR_SIMPLE
Definition: wmem_core.h:48
@ WMEM_ALLOCATOR_BLOCK_FAST
Definition: wmem_core.h:60
Definition: wmem_allocator.h:27