2 * This header is only installed for use by the debugger:
3 * the structures and the API declared here are not supported.
6 #ifndef __MONO_DEBUG_H__
7 #define __MONO_DEBUG_H__
9 #include <mono/utils/mono-publib.h>
10 #include <mono/metadata/image.h>
11 #include <mono/metadata/appdomain.h>
15 typedef struct _MonoSymbolTable MonoSymbolTable;
16 typedef struct _MonoDebugDataTable MonoDebugDataTable;
18 typedef struct _MonoSymbolFile MonoSymbolFile;
19 typedef struct _MonoPPDBFile MonoPPDBFile;
21 typedef struct _MonoDebugHandle MonoDebugHandle;
23 typedef struct _MonoDebugLineNumberEntry MonoDebugLineNumberEntry;
25 typedef struct _MonoDebugVarInfo MonoDebugVarInfo;
26 typedef struct _MonoDebugMethodJitInfo MonoDebugMethodJitInfo;
27 typedef struct _MonoDebugMethodAddress MonoDebugMethodAddress;
28 typedef struct _MonoDebugMethodAddressList MonoDebugMethodAddressList;
29 typedef struct _MonoDebugClassEntry MonoDebugClassEntry;
31 typedef struct _MonoDebugMethodInfo MonoDebugMethodInfo;
32 typedef struct _MonoDebugLocalsInfo MonoDebugLocalsInfo;
33 typedef struct _MonoDebugMethodAsyncInfo MonoDebugMethodAsyncInfo;
34 typedef struct _MonoDebugSourceLocation MonoDebugSourceLocation;
36 typedef struct _MonoDebugList MonoDebugList;
39 MONO_DEBUG_FORMAT_NONE,
40 MONO_DEBUG_FORMAT_MONO,
41 /* Deprecated, the mdb debugger is not longer supported. */
42 MONO_DEBUG_FORMAT_DEBUGGER
47 * We intentionally do not use GList here since the debugger needs to know about
48 * the layout of the fields.
50 struct _MonoDebugList {
55 struct _MonoSymbolTable {
61 * Corlib and metadata info.
63 MonoDebugHandle *corlib;
64 MonoDebugDataTable *global_data_table;
65 MonoDebugList *data_tables;
70 MonoDebugList *symbol_files;
73 struct _MonoDebugHandle {
77 MonoDebugDataTable *type_table;
78 MonoSymbolFile *symfile;
82 struct _MonoDebugMethodJitInfo {
83 const mono_byte *code_start;
85 uint32_t prologue_end;
86 uint32_t epilogue_begin;
87 const mono_byte *wrapper_addr;
88 uint32_t num_line_numbers;
89 MonoDebugLineNumberEntry *line_numbers;
90 uint32_t has_var_info;
92 MonoDebugVarInfo *this_var;
93 MonoDebugVarInfo *params;
95 MonoDebugVarInfo *locals;
96 MonoDebugVarInfo *gsharedvt_info_var;
97 MonoDebugVarInfo *gsharedvt_locals_var;
100 struct _MonoDebugMethodAddressList {
103 mono_byte data [MONO_ZERO_LEN_ARRAY];
106 struct _MonoDebugSourceLocation {
108 uint32_t row, column;
112 MONO_API mono_bool mono_debug_enabled (void);
115 * These bits of the MonoDebugLocalInfo's "index" field are flags specifying
116 * where the variable is actually stored.
118 * See relocate_variable() in debug-symfile.c for more info.
120 #define MONO_DEBUG_VAR_ADDRESS_MODE_FLAGS 0xf0000000
122 /* The variable is in register "index". */
123 #define MONO_DEBUG_VAR_ADDRESS_MODE_REGISTER 0
125 /* The variable is at offset "offset" from register "index". */
126 #define MONO_DEBUG_VAR_ADDRESS_MODE_REGOFFSET 0x10000000
128 /* The variable is in the two registers "offset" and "index". */
129 #define MONO_DEBUG_VAR_ADDRESS_MODE_TWO_REGISTERS 0x20000000
131 /* The variable is dead. */
132 #define MONO_DEBUG_VAR_ADDRESS_MODE_DEAD 0x30000000
134 /* Same as REGOFFSET, but do an indirection */
135 #define MONO_DEBUG_VAR_ADDRESS_MODE_REGOFFSET_INDIR 0x40000000
137 /* gsharedvt local */
138 #define MONO_DEBUG_VAR_ADDRESS_MODE_GSHAREDVT_LOCAL 0x50000000
140 /* variable is a vt address */
141 #define MONO_DEBUG_VAR_ADDRESS_MODE_VTADDR 0x60000000
143 struct _MonoDebugVarInfo {
147 uint32_t begin_scope;
152 #define MONO_DEBUGGER_MAJOR_VERSION 81
153 #define MONO_DEBUGGER_MINOR_VERSION 6
154 #define MONO_DEBUGGER_MAGIC 0x7aff65af4253d427ULL
156 MONO_API void mono_debug_init (MonoDebugFormat format);
157 MONO_API void mono_debug_open_image_from_memory (MonoImage *image, const mono_byte *raw_contents, int size);
158 MONO_API void mono_debug_cleanup (void);
160 MONO_API void mono_debug_close_image (MonoImage *image);
162 MONO_API void mono_debug_domain_unload (MonoDomain *domain);
163 MONO_API void mono_debug_domain_create (MonoDomain *domain);
165 MONO_API MonoDebugMethodAddress *
166 mono_debug_add_method (MonoMethod *method, MonoDebugMethodJitInfo *jit, MonoDomain *domain);
169 mono_debug_remove_method (MonoMethod *method, MonoDomain *domain);
171 MONO_API MonoDebugMethodInfo *
172 mono_debug_lookup_method (MonoMethod *method);
174 MONO_API MonoDebugMethodAddressList *
175 mono_debug_lookup_method_addresses (MonoMethod *method);
177 MONO_API MonoDebugMethodJitInfo*
178 mono_debug_find_method (MonoMethod *method, MonoDomain *domain);
181 mono_debug_free_method_jit_info (MonoDebugMethodJitInfo *jit);
185 mono_debug_add_delegate_trampoline (void* code, int size);
187 MONO_API MonoDebugLocalsInfo*
188 mono_debug_lookup_locals (MonoMethod *method);
190 MonoDebugMethodAsyncInfo*
191 mono_debug_lookup_method_async_debug_info (MonoMethod *method);
193 MonoDebugSourceLocation *
194 mono_debug_method_lookup_location (MonoDebugMethodInfo *minfo, int il_offset);
197 * Line number support.
200 MONO_API MonoDebugSourceLocation *
201 mono_debug_lookup_source_location (MonoMethod *method, uint32_t address, MonoDomain *domain);
204 mono_debug_il_offset_from_address (MonoMethod *method, MonoDomain *domain, uint32_t native_offset);
207 mono_debug_free_source_location (MonoDebugSourceLocation *location);
210 mono_debug_print_stack_frame (MonoMethod *method, uint32_t native_offset, MonoDomain *domain);
213 * Mono Debugger support functions
215 * These methods are used by the JIT while running inside the Mono Debugger.
218 MONO_API int mono_debugger_method_has_breakpoint (MonoMethod *method);
219 MONO_API int mono_debugger_insert_breakpoint (const char *method_name, mono_bool include_namespace);
221 MONO_API void mono_set_is_debugger_attached (mono_bool attached);
222 MONO_API mono_bool mono_is_debugger_attached (void);
226 #endif /* __MONO_DEBUG_H__ */