mono/metadata/debug-mono-symfile.h

   1 /*
   2  * This header is only installed for use by the debugger:
   3  * the structures and the API declared here are not supported.
   4  */
   5
   6 #ifndef __MONO_DEBUG_MONO_SYMFILE_H__
   7 #define __MONO_DEBUG_MONO_SYMFILE_H__
   8
   9 #include <glib.h>
  10 #include <mono/metadata/class.h>
  11 #include <mono/metadata/reflection.h>
  12 #include <mono/metadata/mono-debug.h>
  13
  14 typedef struct MonoSymbolFileOffsetTable        MonoSymbolFileOffsetTable;
  15 typedef struct MonoSymbolFileLineNumberEntry    MonoSymbolFileLineNumberEntry;
  16 typedef struct MonoSymbolFileMethodEntry        MonoSymbolFileMethodEntry;
  17 typedef struct MonoSymbolFileMethodAddress      MonoSymbolFileMethodAddress;
  18 typedef struct MonoSymbolFileDynamicTable       MonoSymbolFileDynamicTable;
  19 typedef struct MonoSymbolFileSourceEntry        MonoSymbolFileSourceEntry;
  20 typedef struct MonoSymbolFileMethodIndexEntry   MonoSymbolFileMethodIndexEntry;
  21 typedef struct MonoSymbolFileLexicalBlockEntry  MonoSymbolFileLexicalBlockEntry;
  22
  23 typedef struct MonoDebugMethodInfo              MonoDebugMethodInfo;
  24 typedef struct MonoDebugLexicalBlockEntry       MonoDebugLexicalBlockEntry;
  25 typedef struct MonoDebugLineNumberEntry         MonoDebugLineNumberEntry;
  26
  27 /* Keep in sync with OffsetTable in mcs/class/Mono.CSharp.Debugger/MonoSymbolTable.cs */
  28 struct MonoSymbolFileOffsetTable {
  29         guint32 _total_file_size;
  30         guint32 _data_section_offset;
  31         guint32 _data_section_size;
  32         guint32 _source_count;
  33         guint32 _source_table_offset;
  34         guint32 _source_table_size;
  35         guint32 _method_count;
  36         guint32 _method_table_offset;
  37         guint32 _method_table_size;
  38         guint32 _type_count;
  39 };
  40
  41 struct MonoSymbolFileMethodEntry {
  42         guint32 _source_index;
  43         guint32 _token;
  44         guint32 _start_row;
  45         guint32 _end_row;
  46         guint32 _class_type_index;
  47         guint32 _num_parameters;
  48         guint32 _num_locals;
  49         guint32 _num_line_numbers;
  50         guint32 _name_offset;
  51         guint32 _type_index_table_offset;
  52         guint32 _local_variable_table_offset;
  53         guint32 _line_number_table_offset;
  54         guint32 _num_lexical_blocks;
  55         guint32 _lexical_block_table_offset;
  56         guint32 _namespace_idx;
  57         guint32 _local_names_ambiguous;
  58 };
  59
  60 struct MonoSymbolFileSourceEntry {
  61         guint32 _index;
  62         guint32 _num_methods;
  63         guint32 _num_namespaces;
  64         guint32 _name_offset;
  65         guint32 _method_offset;
  66         guint32 _nstable_offset;
  67 };
  68
  69 struct MonoSymbolFileMethodIndexEntry {
  70         guint32 _file_offset;
  71         guint32 _token;
  72 };
  73
  74 struct MonoSymbolFileMethodAddress {
  75         guint32 size;
  76         const guint8 *start_address;
  77         const guint8 *end_address;
  78         const guint8 *method_start_address;
  79         const guint8 *method_end_address;
  80         const guint8 *wrapper_address;
  81         guint32 has_this;
  82         guint32 variable_table_offset;
  83         guint32 type_table_offset;
  84         guint32 num_line_numbers;
  85         guint32 line_number_offset;
  86         guint32 lexical_block_table_offset;
  87         guint8 data [MONO_ZERO_LEN_ARRAY];
  88 };
  89
  90 struct MonoSymbolFileLexicalBlockEntry {
  91         guint32 _start_offset;
  92         guint32 _end_offset;
  93 };
  94
  95 struct MonoSymbolFileLineNumberEntry {
  96         guint32 _row;
  97         guint32 _offset;
  98 };
  99
 100 struct MonoDebugMethodInfo {
 101         MonoMethod *method;
 102         MonoDebugHandle *handle;
 103         guint32 index;
 104         guint32 num_il_offsets;
 105         MonoSymbolFileLineNumberEntry *il_offsets;
 106         MonoSymbolFileMethodEntry *entry;
 107 };
 108
 109 struct MonoDebugLexicalBlockEntry {
 110         guint32 start_address;
 111         guint32 end_address;
 112 };
 113
 114 struct MonoDebugLineNumberEntry {
 115         guint32 offset;
 116         guint32 address;
 117 };
 118
 119 struct _MonoSymbolFile {
 120         const guint8 *raw_contents;
 121         int raw_contents_size;
 122         GHashTable *method_hash;
 123         MonoSymbolFileOffsetTable *offset_table;
 124 };
 125
 126 #define MONO_SYMBOL_FILE_VERSION                37
 127 #define MONO_SYMBOL_FILE_MAGIC                  0x45e82623fd7fa614ULL
 128
 129 MonoSymbolFile *
 130 mono_debug_open_mono_symbol_file   (MonoDebugHandle           *handle,
 131                                     gboolean                   create_symfile);
 132
 133 void
 134 mono_debug_close_mono_symbol_file  (MonoSymbolFile           *symfile);
 135
 136 gchar *
 137 mono_debug_find_source_location    (MonoSymbolFile           *symfile,
 138                                     MonoMethod               *method,
 139                                     guint32                   offset,
 140                                     guint32                  *line_number);
 141
 142 gint32
 143 _mono_debug_address_from_il_offset (MonoDebugMethodJitInfo   *jit,
 144                                     guint32                   il_offset);
 145
 146 MonoDebugMethodInfo *
 147 mono_debug_find_method             (MonoDebugHandle           *handle,
 148                                     MonoMethod               *method);
 149
 150 #endif /* __MONO_SYMFILE_H__ */
 151