blob: aeaebe7fec43f7e210b4244e2f69134031f735e4 (
plain) (
blame)
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
|
#ifndef _rA_MEMPOOL_H_
#define _rA_MEMPOOL_H_
#include "../common/cbasetypes.h"
typedef struct mempool *mempool;
typedef void (*memPoolOnNodeAllocationProc)(void *ptr);
typedef void (*memPoolOnNodeDeallocationProc)(void *ptr);
typedef struct mempool_stats{
int64 num_nodes_total;
int64 num_nodes_free;
int64 num_nodes_used;
int64 num_segments;
int64 num_realloc_events;
int64 peak_nodes_used;
int64 num_bytes_total;
} mempool_stats;
//
void mempool_init();
void mempool_final();
/**
* Creates a new Mempool
*
* @param name - Name of the pool (used for debug / error messages)
* @param elem_size - size of each element
* @param initial_count - preallocation count
* @param realloc_count - #no of nodes being allocated when pool is running empty.
* @param onNodeAlloc - Node Allocation callback (see @note!)
* @param onNodeDealloc - Node Deallocation callback (see @note!)
*
* @note:
* The onNode(De)alloc callbacks are only called once during segment allocation
* (pool initialization / rallocation )
* you can use this callbacks for example to initlaize a mutex or somethingelse
* you definitly need during runtime
*
* @return not NULL
*/
mempool mempool_create(const char *name,
uint64 elem_size,
uint64 initial_count,
uint64 realloc_count,
memPoolOnNodeAllocationProc onNodeAlloc,
memPoolOnNodeDeallocationProc onNodeDealloc);
/**
* Destroys a Mempool
*
* @param pool - the mempool to destroy
*
* @note:
* Everything gets deallocated, regardless if everything was freed properly!
* So you have to ensure that all references are cleared properly!
*/
void mempool_destroy(mempool pool);
/**
* Gets a new / empty node from the given mempool.
*
* @param pool - the pool to get an empty node from.
*
* @return Address of empty Node
*/
void *mempool_node_get(mempool pool);
/**
* Returns the given node to the given mempool
*
* @param pool - the pool to put the node, to
* @param node - the node to return
*/
void mempool_node_put(mempool pool, void *node);
/**
* Returns Statistics for the given mempool
*
* @param pool - the pool to get thats for
*
* @note: i dont like pushing masses of values over the stack, too - but its lazy and okay for stats. (blacksirius)
*
* @return stats struct
*/
mempool_stats mempool_get_stats(mempool pool);
#endif
|
