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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
/*
* Copyright (C) 2019 Intel Corporation. All rights reserved.
* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
*/
/**
* @file ems_gc.h
* @date Wed Aug 3 10:46:38 2011
*
* @brief This file defines GC modules types and interfaces.
*/
#ifndef _EMS_GC_H
#define _EMS_GC_H
#include "bh_platform.h"
#ifdef __cplusplus
extern "C" {
#endif
#define GC_HEAD_PADDING 4
#define NULL_REF ((gc_object_t)NULL)
#define GC_SUCCESS (0)
#define GC_ERROR (-1)
#define GC_TRUE (1)
#define GC_FALSE (0)
#define GC_MAX_HEAP_SIZE (256 * BH_KB)
typedef void *gc_handle_t;
typedef void *gc_object_t;
typedef int64 gc_int64;
typedef uint32 gc_uint32;
typedef int32 gc_int32;
typedef uint16 gc_uint16;
typedef int16 gc_int16;
typedef uint8 gc_uint8;
typedef int8 gc_int8;
typedef uint32 gc_size_t;
typedef enum {
GC_STAT_TOTAL = 0,
GC_STAT_FREE,
GC_STAT_HIGHMARK,
} GC_STAT_INDEX;
/**
* GC initialization from a buffer, which is separated into
* two parts: the beginning of the buffer is used to create
* the heap structure, and the left is used to create the
* actual pool data
*
* @param buf the buffer to be initialized to a heap
* @param buf_size the size of buffer
*
* @return gc handle if success, NULL otherwise
*/
gc_handle_t
gc_init_with_pool(char *buf, gc_size_t buf_size);
/**
* GC initialization from heap struct buffer and pool buffer
*
* @param struct_buf the struct buffer to create the heap structure
* @param struct_buf_size the size of struct buffer
* @param pool_buf the pool buffer to create pool data
* @param pool_buf_size the size of poll buffer
*
* @return gc handle if success, NULL otherwise
*/
gc_handle_t
gc_init_with_struct_and_pool(char *struct_buf, gc_size_t struct_buf_size,
char *pool_buf, gc_size_t pool_buf_size);
/**
* Destroy heap which is initilized from a buffer
*
* @param handle handle to heap needed destroy
*
* @return GC_SUCCESS if success
* GC_ERROR for bad parameters or failed system resource freeing.
*/
int
gc_destroy_with_pool(gc_handle_t handle);
/**
* Return heap struct size
*/
uint32
gc_get_heap_struct_size(void);
/**
* Migrate heap from one pool buf to another pool buf
*
* @param handle handle of the new heap
* @param pool_buf_new the new pool buffer
* @param pool_buf_size the size of new pool buffer
*
* @return GC_SUCCESS if success, GC_ERROR otherwise
*/
int
gc_migrate(gc_handle_t handle, char *pool_buf_new, gc_size_t pool_buf_size);
/**
* Check whether the heap is corrupted
*
* @param handle handle of the heap
*
* @return true if success, false otherwise
*/
bool
gc_is_heap_corrupted(gc_handle_t handle);
/**
* Get Heap Stats
*
* @param stats [out] integer array to save heap stats
* @param size [in] the size of stats
* @param mmt [in] type of heap, MMT_SHARED or MMT_INSTANCE
*/
void *
gc_heap_stats(void *heap, uint32 *stats, int size);
#if BH_ENABLE_GC_VERIFY == 0
gc_object_t
gc_alloc_vo(void *heap, gc_size_t size);
gc_object_t
gc_realloc_vo(void *heap, void *ptr, gc_size_t size);
int
gc_free_vo(void *heap, gc_object_t obj);
#else /* else of BH_ENABLE_GC_VERIFY */
gc_object_t
gc_alloc_vo_internal(void *heap, gc_size_t size, const char *file, int line);
gc_object_t
gc_realloc_vo_internal(void *heap, void *ptr, gc_size_t size, const char *file,
int line);
int
gc_free_vo_internal(void *heap, gc_object_t obj, const char *file, int line);
/* clang-format off */
#define gc_alloc_vo(heap, size) \
gc_alloc_vo_internal(heap, size, __FILE__, __LINE__)
#define gc_realloc_vo(heap, ptr, size) \
gc_realloc_vo_internal(heap, ptr, size, __FILE__, __LINE__)
#define gc_free_vo(heap, obj) \
gc_free_vo_internal(heap, obj, __FILE__, __LINE__)
/* clang-format on */
#endif /* end of BH_ENABLE_GC_VERIFY */
#ifdef __cplusplus
}
#endif
#endif
|
