Ruby 4.1.0dev (2026-04-04 revision 3b6245536cf55da9e8bfcdb03c845fe9ef931d7f)
mmtk.h
1#ifndef MMTK_H
2#define MMTK_H
3
4/* Warning, this file is autogenerated by cbindgen from the mmtk-ruby repository. Don't modify this manually. */
5
6#include <stdarg.h>
7#include <stdbool.h>
8#include <stddef.h>
9#include <stdint.h>
10#include <stdlib.h>
11
12typedef struct MMTk_Builder MMTk_Builder;
13typedef struct MMTk_Mutator MMTk_Mutator;
14
15typedef struct MMTk_ractor_cache *MMTk_VMThread;
18typedef void *MMTk_Address;
19typedef void *MMTk_ObjectReference;
20typedef void *MMTk_NullableObjectReference;
21typedef uint32_t MMTk_AllocationSemantics;
22
23typedef struct MMTk_BumpPointer {
24 uintptr_t cursor;
25 uintptr_t limit;
27
28
29#define MMTk_OBJREF_OFFSET 8
30
31#define MMTk_MIN_OBJ_ALIGN 8
32
33#define MMTk_GC_THREAD_KIND_WORKER 1
34
36 bool ractor_check_mode;
37 size_t suffix_size;
39
40typedef MMTk_ObjectReference (*MMTk_ObjectClosureFunction)(void*, void*, MMTk_ObjectReference, bool);
41
42typedef struct MMTk_ObjectClosure {
46 MMTk_ObjectClosureFunction c_function;
52
53typedef struct MMTk_GCThreadTLS {
54 int kind;
55 void *gc_context;
56 struct MMTk_ObjectClosure object_closure;
58
59typedef struct MMTk_RubyUpcalls {
60 void (*init_gc_worker_thread)(struct MMTk_GCThreadTLS *gc_worker_tls);
61 bool (*is_mutator)(void);
62 void (*stop_the_world)(void);
63 void (*resume_mutators)(bool gc_may_move);
64 void (*block_for_gc)(MMTk_VMMutatorThread tls);
65 void (*before_updating_jit_code)(void);
66 void (*after_updating_jit_code)(void);
67 size_t (*number_of_mutators)(void);
68 void (*get_mutators)(void (*visit_mutator)(MMTk_Mutator*, void*), void *data);
69 void (*scan_gc_roots)(void);
70 void (*scan_objspace)(void);
71 void (*move_obj_during_marking)(MMTk_ObjectReference from, MMTk_ObjectReference to);
72 void (*update_object_references)(MMTk_ObjectReference object);
73 void (*call_gc_mark_children)(MMTk_ObjectReference object);
74 void (*handle_weak_references)(MMTk_ObjectReference object, bool moving);
75 void (*call_obj_free)(MMTk_ObjectReference object);
76 size_t (*vm_live_bytes)(void);
77 void (*update_global_tables)(int tbl_idx, bool moving);
78 int (*global_tables_count)(void);
79 void (*update_finalizer_table)(void);
80 bool (*special_const_p)(MMTk_ObjectReference object);
81 void (*mutator_thread_panic_handler)(void);
82 void (*gc_thread_panic_handler)(void);
84
85typedef struct MMTk_RawVecOfObjRef {
86 MMTk_ObjectReference *ptr;
87 size_t len;
88 size_t capa;
90
91bool mmtk_is_live_object(MMTk_ObjectReference object);
92
93bool mmtk_is_reachable(MMTk_ObjectReference object);
94
95MMTk_Builder *mmtk_builder_default(void);
96
97void mmtk_init_binding(MMTk_Builder *builder,
98 const struct MMTk_RubyBindingOptions *_binding_options,
99 const struct MMTk_RubyUpcalls *upcalls);
100
101void mmtk_initialize_collection(MMTk_VMThread tls);
102
103MMTk_Mutator *mmtk_bind_mutator(MMTk_VMMutatorThread tls);
104
105MMTk_BumpPointer *mmtk_get_bump_pointer_allocator(MMTk_Mutator *m);
106
107void mmtk_destroy_mutator(MMTk_Mutator *mutator);
108
109void mmtk_handle_user_collection_request(MMTk_VMMutatorThread tls, bool force, bool exhaustive);
110
111void mmtk_set_gc_enabled(bool enable);
112
113bool mmtk_gc_enabled_p(void);
114
115MMTk_Address mmtk_alloc(MMTk_Mutator *mutator,
116 size_t size,
117 size_t align,
118 size_t offset,
119 MMTk_AllocationSemantics semantics);
120
121void mmtk_post_alloc(MMTk_Mutator *mutator,
122 MMTk_ObjectReference refer,
123 size_t bytes,
124 MMTk_AllocationSemantics semantics);
125
126void mmtk_add_obj_free_candidates(const MMTk_ObjectReference *objects,
127 size_t count,
128 bool can_parallel_free);
129
130void mmtk_declare_weak_references(MMTk_ObjectReference object);
131
132bool mmtk_weak_references_alive_p(MMTk_ObjectReference object);
133
134size_t mmtk_weak_references_count(void);
135
136void mmtk_register_pinning_obj(MMTk_ObjectReference obj);
137
138void mmtk_object_reference_write_post(MMTk_Mutator *mutator, MMTk_ObjectReference object);
139
140void mmtk_register_wb_unprotected_object(MMTk_ObjectReference object);
141
142bool mmtk_object_wb_unprotected_p(MMTk_ObjectReference object);
143
144void mmtk_enumerate_objects(void (*callback)(MMTk_ObjectReference, void*), void *data);
145
146struct MMTk_RawVecOfObjRef mmtk_get_all_obj_free_candidates(void);
147
148void mmtk_free_raw_vec_of_obj_ref(struct MMTk_RawVecOfObjRef raw_vec);
149
150void mmtk_before_fork(void);
151
152void mmtk_after_fork(MMTk_VMThread tls);
153
154size_t mmtk_total_bytes(void);
155
156size_t mmtk_used_bytes(void);
157
158size_t mmtk_free_bytes(void);
159
160MMTk_Address mmtk_starting_heap_address(void);
161
162MMTk_Address mmtk_last_heap_address(void);
163
164size_t mmtk_worker_count(void);
165
166const uint8_t *mmtk_plan(void);
167
168const uint8_t *mmtk_heap_mode(void);
169
170size_t mmtk_heap_min(void);
171
172size_t mmtk_heap_max(void);
173
174bool mmtk_is_mmtk_object(MMTk_Address addr);
175
176#endif /* MMTK_H */
Defines old _.
C99 shim for <stdbool.h>
void * rust_closure
The pointer to the Rust-level closure object.
Definition mmtk.h:50
MMTk_ObjectClosureFunction c_function
The function to be called from C.
Definition mmtk.h:46