[exdoc] Handle punctuation better in code formatting.
[mono.git] / mono / metadata / mono-debug.c
1 /**
2  * \file
3  *
4  * Author:
5  *      Mono Project (http://www.mono-project.com)
6  *
7  * Copyright 2001-2003 Ximian, Inc (http://www.ximian.com)
8  * Copyright 2004-2009 Novell, Inc (http://www.novell.com)
9  * Copyright 2011 Xamarin Inc (http://www.xamarin.com)
10  * Licensed under the MIT license. See LICENSE file in the project root for full license information.
11  */
12
13 #include <config.h>
14 #include <mono/metadata/assembly.h>
15 #include <mono/metadata/tabledefs.h>
16 #include <mono/metadata/tokentype.h>
17 #include <mono/metadata/appdomain.h>
18 #include <mono/metadata/class-internals.h>
19 #include <mono/metadata/mono-debug.h>
20 #include <mono/metadata/debug-internals.h>
21 #include <mono/metadata/mono-endian.h>
22 #include <mono/metadata/gc-internals.h>
23 #include <mono/metadata/mempool.h>
24 #include <mono/metadata/debug-mono-symfile.h>
25 #include <mono/metadata/debug-mono-ppdb.h>
26 #include <mono/metadata/exception-internals.h>
27 #include <mono/metadata/runtime.h>
28 #include <string.h>
29
30 #define ALIGN_TO(val,align) ((((guint64)val) + ((align) - 1)) & ~((align) - 1))
31
32 #if NO_UNALIGNED_ACCESS
33 #define WRITE_UNALIGNED(type, addr, val) \
34         memcpy(addr, &val, sizeof(type))
35 #define READ_UNALIGNED(type, addr, val) \
36         memcpy(&val, addr, sizeof(type))
37 #else
38 #define WRITE_UNALIGNED(type, addr, val) \
39         (*(type *)(addr) = (val))
40 #define READ_UNALIGNED(type, addr, val) \
41         val = (*(type *)(addr))
42 #endif
43
44 /* This contains per-domain info */
45 struct _MonoDebugDataTable {
46         MonoMemPool *mp;
47         GHashTable *method_address_hash;
48 };
49
50 /* This contains JIT debugging information about a method in serialized format */
51 struct _MonoDebugMethodAddress {
52         const guint8 *code_start;
53         guint32 code_size;
54         guint8 data [MONO_ZERO_LEN_ARRAY];
55 };
56
57 static MonoDebugFormat mono_debug_format = MONO_DEBUG_FORMAT_NONE;
58
59 static gboolean mono_debug_initialized = FALSE;
60 /* Maps MonoImage -> MonoMonoDebugHandle */
61 static GHashTable *mono_debug_handles;
62 /* Maps MonoDomain -> MonoDataTable */
63 static GHashTable *data_table_hash;
64
65 static mono_mutex_t debugger_lock_mutex;
66
67 static gboolean is_attached = FALSE;
68
69 static MonoDebugHandle     *mono_debug_open_image      (MonoImage *image, const guint8 *raw_contents, int size);
70
71 static MonoDebugHandle     *mono_debug_get_image      (MonoImage *image);
72 static void                 mono_debug_add_assembly    (MonoAssembly *assembly,
73                                                         gpointer user_data);
74
75 static MonoDebugHandle     *open_symfile_from_bundle   (MonoImage *image);
76
77 static MonoDebugDataTable *
78 create_data_table (MonoDomain *domain)
79 {
80         MonoDebugDataTable *table;
81
82         table = g_new0 (MonoDebugDataTable, 1);
83
84         table->mp = mono_mempool_new ();
85         table->method_address_hash = g_hash_table_new (NULL, NULL);
86
87         if (domain)
88                 g_hash_table_insert (data_table_hash, domain, table);
89
90         return table;
91 }
92
93 static void
94 free_data_table (MonoDebugDataTable *table)
95 {
96         mono_mempool_destroy (table->mp);
97         g_hash_table_destroy (table->method_address_hash);
98
99         g_free (table);
100 }
101
102 static MonoDebugDataTable *
103 lookup_data_table (MonoDomain *domain)
104 {
105         MonoDebugDataTable *table;
106
107         table = (MonoDebugDataTable *)g_hash_table_lookup (data_table_hash, domain);
108         if (!table) {
109                 g_error ("lookup_data_table () failed for %p\n", domain);
110                 g_assert (table);
111         }
112         return table;
113 }
114
115 static void
116 free_debug_handle (MonoDebugHandle *handle)
117 {
118         if (handle->ppdb)
119                 mono_ppdb_close (handle);
120         if (handle->symfile)
121                 mono_debug_close_mono_symbol_file (handle->symfile);
122         /* decrease the refcount added with mono_image_addref () */
123         mono_image_close (handle->image);
124         g_free (handle);
125 }
126
127 /*
128  * Initialize debugging support.
129  *
130  * This method must be called after loading corlib,
131  * but before opening the application's main assembly because we need to set some
132  * callbacks here.
133  */
134 void
135 mono_debug_init (MonoDebugFormat format)
136 {
137         g_assert (!mono_debug_initialized);
138         if (format == MONO_DEBUG_FORMAT_DEBUGGER)
139                 g_error ("The mdb debugger is no longer supported.");
140
141         mono_debug_initialized = TRUE;
142         mono_debug_format = format;
143
144         mono_os_mutex_init_recursive (&debugger_lock_mutex);
145
146         mono_debugger_lock ();
147
148         mono_debug_handles = g_hash_table_new_full
149                 (NULL, NULL, NULL, (GDestroyNotify) free_debug_handle);
150
151         data_table_hash = g_hash_table_new_full (
152                 NULL, NULL, NULL, (GDestroyNotify) free_data_table);
153
154         mono_install_assembly_load_hook (mono_debug_add_assembly, NULL);
155
156         mono_debugger_unlock ();
157 }
158
159 void
160 mono_debug_open_image_from_memory (MonoImage *image, const guint8 *raw_contents, int size)
161 {
162         if (!mono_debug_initialized)
163                 return;
164
165         mono_debug_open_image (image, raw_contents, size);
166 }
167
168 void
169 mono_debug_cleanup (void)
170 {
171         if (mono_debug_handles)
172                 g_hash_table_destroy (mono_debug_handles);
173         mono_debug_handles = NULL;
174
175         if (data_table_hash) {
176                 g_hash_table_destroy (data_table_hash);
177                 data_table_hash = NULL;
178         }
179 }
180
181 void
182 mono_debug_domain_create (MonoDomain *domain)
183 {
184         if (!mono_debug_initialized)
185                 return;
186
187         mono_debugger_lock ();
188
189         create_data_table (domain);
190
191         mono_debugger_unlock ();
192 }
193
194 void
195 mono_debug_domain_unload (MonoDomain *domain)
196 {
197         MonoDebugDataTable *table;
198
199         if (!mono_debug_initialized)
200                 return;
201
202         mono_debugger_lock ();
203
204         table = (MonoDebugDataTable *)g_hash_table_lookup (data_table_hash, domain);
205         if (!table) {
206                 g_warning (G_STRLOC ": unloading unknown domain %p / %d",
207                            domain, mono_domain_get_id (domain));
208                 mono_debugger_unlock ();
209                 return;
210         }
211
212         g_hash_table_remove (data_table_hash, domain);
213
214         mono_debugger_unlock ();
215 }
216
217 /*
218  * LOCKING: Assumes the debug lock is held.
219  */
220 static MonoDebugHandle *
221 mono_debug_get_image (MonoImage *image)
222 {
223         return (MonoDebugHandle *)g_hash_table_lookup (mono_debug_handles, image);
224 }
225
226 void
227 mono_debug_close_image (MonoImage *image)
228 {
229         MonoDebugHandle *handle;
230
231         if (!mono_debug_initialized)
232                 return;
233
234         mono_debugger_lock ();
235
236         handle = mono_debug_get_image (image);
237         if (!handle) {
238                 mono_debugger_unlock ();
239                 return;
240         }
241
242         g_hash_table_remove (mono_debug_handles, image);
243
244         mono_debugger_unlock ();
245 }
246
247 static MonoDebugHandle *
248 mono_debug_open_image (MonoImage *image, const guint8 *raw_contents, int size)
249 {
250         MonoDebugHandle *handle;
251
252         if (mono_image_is_dynamic (image))
253                 return NULL;
254
255         mono_debugger_lock ();
256
257         handle = mono_debug_get_image (image);
258         if (handle != NULL) {
259                 mono_debugger_unlock ();
260                 return handle;
261         }
262
263         handle = g_new0 (MonoDebugHandle, 1);
264
265         handle->image = image;
266         mono_image_addref (image);
267
268         /* Try a ppdb file first */
269         handle->ppdb = mono_ppdb_load_file (handle->image, raw_contents, size);
270
271         if (!handle->ppdb)
272                 handle->symfile = mono_debug_open_mono_symbols (handle, raw_contents, size, FALSE);
273
274         g_hash_table_insert (mono_debug_handles, image, handle);
275
276         mono_debugger_unlock ();
277
278         return handle;
279 }
280
281 static void
282 mono_debug_add_assembly (MonoAssembly *assembly, gpointer user_data)
283 {
284         MonoDebugHandle *handle;
285         MonoImage *image;
286
287         mono_debugger_lock ();
288         image = mono_assembly_get_image (assembly);
289         handle = open_symfile_from_bundle (image);
290         if (!handle)
291                 mono_debug_open_image (image, NULL, 0);
292         mono_debugger_unlock ();
293 }
294
295 struct LookupMethodData
296 {
297         MonoDebugMethodInfo *minfo;
298         MonoMethod *method;
299 };
300
301 static void
302 lookup_method_func (gpointer key, gpointer value, gpointer user_data)
303 {
304         MonoDebugHandle *handle = (MonoDebugHandle *) value;
305         struct LookupMethodData *data = (struct LookupMethodData *) user_data;
306
307         if (data->minfo)
308                 return;
309
310         if (handle->ppdb)
311                 data->minfo = mono_ppdb_lookup_method (handle, data->method);
312         else if (handle->symfile)
313                 data->minfo = mono_debug_symfile_lookup_method (handle, data->method);
314 }
315
316 static MonoDebugMethodInfo *
317 mono_debug_lookup_method_internal (MonoMethod *method)
318 {
319         struct LookupMethodData data;
320
321         data.minfo = NULL;
322         data.method = method;
323
324         if (!mono_debug_handles)
325                 return NULL;
326
327         g_hash_table_foreach (mono_debug_handles, lookup_method_func, &data);
328         return data.minfo;
329 }
330
331 /**
332  * mono_debug_lookup_method:
333  *
334  * Lookup symbol file information for the method \p method.  The returned
335  * \c MonoDebugMethodInfo is a private structure, but it can be passed to
336  * mono_debug_symfile_lookup_location().
337  */
338 MonoDebugMethodInfo *
339 mono_debug_lookup_method (MonoMethod *method)
340 {
341         MonoDebugMethodInfo *minfo;
342
343         if (mono_debug_format == MONO_DEBUG_FORMAT_NONE)
344                 return NULL;
345
346         mono_debugger_lock ();
347         minfo = mono_debug_lookup_method_internal (method);
348         mono_debugger_unlock ();
349         return minfo;
350 }
351
352 typedef struct
353 {
354         gboolean found;
355         MonoImage *image;
356 } LookupImageData;
357
358 static void
359 lookup_image_func (gpointer key, gpointer value, gpointer user_data)
360 {
361         MonoDebugHandle *handle = (MonoDebugHandle *) value;
362         LookupImageData *data = (LookupImageData *) user_data;
363
364         if (data->found)
365                 return;
366
367         if (handle->image == data->image && handle->symfile)
368                 data->found = TRUE;
369 }
370
371 gboolean
372 mono_debug_image_has_debug_info (MonoImage *image)
373 {
374         LookupImageData data;
375
376         if (!mono_debug_handles)
377                 return FALSE;
378
379         memset (&data, 0, sizeof (data));
380         data.image = image;
381
382         mono_debugger_lock ();
383         g_hash_table_foreach (mono_debug_handles, lookup_image_func, &data);
384         mono_debugger_unlock ();
385         return data.found;
386 }
387
388 static inline void
389 write_leb128 (guint32 value, guint8 *ptr, guint8 **rptr)
390 {
391         do {
392                 guint8 byte = value & 0x7f;
393                 value >>= 7;
394                 if (value)
395                         byte |= 0x80;
396                 *ptr++ = byte;
397         } while (value);
398
399         *rptr = ptr;
400 }
401
402 static inline void
403 write_sleb128 (gint32 value, guint8 *ptr, guint8 **rptr)
404 {
405         gboolean more = 1;
406
407         while (more) {
408                 guint8 byte = value & 0x7f;
409                 value >>= 7;
410
411                 if (((value == 0) && ((byte & 0x40) == 0)) || ((value == -1) && (byte & 0x40)))
412                         more = 0;
413                 else
414                         byte |= 0x80;
415                 *ptr++ = byte;
416         }
417
418         *rptr = ptr;
419 }
420
421 static void
422 write_variable (MonoDebugVarInfo *var, guint8 *ptr, guint8 **rptr)
423 {
424         write_leb128 (var->index, ptr, &ptr);
425         write_sleb128 (var->offset, ptr, &ptr);
426         write_leb128 (var->size, ptr, &ptr);
427         write_leb128 (var->begin_scope, ptr, &ptr);
428         write_leb128 (var->end_scope, ptr, &ptr);
429         WRITE_UNALIGNED (gpointer, ptr, var->type);
430         ptr += sizeof (gpointer);
431         *rptr = ptr;
432 }
433
434 MonoDebugMethodAddress *
435 mono_debug_add_method (MonoMethod *method, MonoDebugMethodJitInfo *jit, MonoDomain *domain)
436 {
437         MonoDebugDataTable *table;
438         MonoDebugMethodAddress *address;
439         guint8 buffer [BUFSIZ];
440         guint8 *ptr, *oldptr;
441         guint32 i, size, total_size, max_size;
442
443         mono_debugger_lock ();
444
445         table = lookup_data_table (domain);
446
447         max_size = (5 * 5) + 1 + (10 * jit->num_line_numbers) +
448                 (25 + sizeof (gpointer)) * (1 + jit->num_params + jit->num_locals);
449
450         if (max_size > BUFSIZ)
451                 ptr = oldptr = (guint8 *)g_malloc (max_size);
452         else
453                 ptr = oldptr = buffer;
454
455         write_leb128 (jit->prologue_end, ptr, &ptr);
456         write_leb128 (jit->epilogue_begin, ptr, &ptr);
457
458         write_leb128 (jit->num_line_numbers, ptr, &ptr);
459         for (i = 0; i < jit->num_line_numbers; i++) {
460                 MonoDebugLineNumberEntry *lne = &jit->line_numbers [i];
461
462                 write_sleb128 (lne->il_offset, ptr, &ptr);
463                 write_sleb128 (lne->native_offset, ptr, &ptr);
464         }
465         write_leb128 (jit->has_var_info, ptr, &ptr);
466         if (jit->has_var_info) {
467                 *ptr++ = jit->this_var ? 1 : 0;
468                 if (jit->this_var)
469                         write_variable (jit->this_var, ptr, &ptr);
470
471                 write_leb128 (jit->num_params, ptr, &ptr);
472                 for (i = 0; i < jit->num_params; i++)
473                         write_variable (&jit->params [i], ptr, &ptr);
474
475                 write_leb128 (jit->num_locals, ptr, &ptr);
476                 for (i = 0; i < jit->num_locals; i++)
477                         write_variable (&jit->locals [i], ptr, &ptr);
478
479                 *ptr++ = jit->gsharedvt_info_var ? 1 : 0;
480                 if (jit->gsharedvt_info_var) {
481                         write_variable (jit->gsharedvt_info_var, ptr, &ptr);
482                         write_variable (jit->gsharedvt_locals_var, ptr, &ptr);
483                 }
484         }
485
486         size = ptr - oldptr;
487         g_assert (size < max_size);
488         total_size = size + sizeof (MonoDebugMethodAddress);
489
490         if (method_is_dynamic (method)) {
491                 address = (MonoDebugMethodAddress *)g_malloc0 (total_size);
492         } else {
493                 address = (MonoDebugMethodAddress *)mono_mempool_alloc (table->mp, total_size);
494         }
495
496         address->code_start = jit->code_start;
497         address->code_size = jit->code_size;
498
499         memcpy (&address->data, oldptr, size);
500         if (max_size > BUFSIZ)
501                 g_free (oldptr);
502
503         g_hash_table_insert (table->method_address_hash, method, address);
504
505         mono_debugger_unlock ();
506         return address;
507 }
508
509 void
510 mono_debug_remove_method (MonoMethod *method, MonoDomain *domain)
511 {
512         MonoDebugDataTable *table;
513         MonoDebugMethodAddress *address;
514
515         if (!mono_debug_initialized)
516                 return;
517
518         g_assert (method_is_dynamic (method));
519
520         mono_debugger_lock ();
521
522         table = lookup_data_table (domain);
523
524         address = (MonoDebugMethodAddress *)g_hash_table_lookup (table->method_address_hash, method);
525         if (address)
526                 g_free (address);
527
528         g_hash_table_remove (table->method_address_hash, method);
529
530         mono_debugger_unlock ();
531 }
532
533 void
534 mono_debug_add_delegate_trampoline (gpointer code, int size)
535 {
536 }
537
538 static inline guint32
539 read_leb128 (guint8 *ptr, guint8 **rptr)
540 {
541         guint32 result = 0, shift = 0;
542
543         while (TRUE) {
544                 guint8 byte = *ptr++;
545
546                 result |= (byte & 0x7f) << shift;
547                 if ((byte & 0x80) == 0)
548                         break;
549                 shift += 7;
550         }
551
552         *rptr = ptr;
553         return result;
554 }
555
556 static inline gint32
557 read_sleb128 (guint8 *ptr, guint8 **rptr)
558 {
559         gint32 result = 0;
560         guint32 shift = 0;
561
562         while (TRUE) {
563                 guint8 byte = *ptr++;
564
565                 result |= (byte & 0x7f) << shift;
566                 shift += 7;
567
568                 if (byte & 0x80)
569                         continue;
570
571                 if ((shift < 32) && (byte & 0x40))
572                         result |= - (1 << shift);
573                 break;
574         }
575
576         *rptr = ptr;
577         return result;
578 }
579
580 static void
581 read_variable (MonoDebugVarInfo *var, guint8 *ptr, guint8 **rptr)
582 {
583         var->index = read_leb128 (ptr, &ptr);
584         var->offset = read_sleb128 (ptr, &ptr);
585         var->size = read_leb128 (ptr, &ptr);
586         var->begin_scope = read_leb128 (ptr, &ptr);
587         var->end_scope = read_leb128 (ptr, &ptr);
588         READ_UNALIGNED (MonoType *, ptr, var->type);
589         ptr += sizeof (gpointer);
590         *rptr = ptr;
591 }
592
593 void
594 mono_debug_free_method_jit_info (MonoDebugMethodJitInfo *jit)
595 {
596         if (!jit)
597                 return;
598         g_free (jit->line_numbers);
599         g_free (jit->this_var);
600         g_free (jit->params);
601         g_free (jit->locals);
602         g_free (jit->gsharedvt_info_var);
603         g_free (jit->gsharedvt_locals_var);
604         g_free (jit);
605 }
606
607 static MonoDebugMethodJitInfo *
608 mono_debug_read_method (MonoDebugMethodAddress *address)
609 {
610         MonoDebugMethodJitInfo *jit;
611         guint32 i;
612         guint8 *ptr;
613
614         jit = g_new0 (MonoDebugMethodJitInfo, 1);
615         jit->code_start = address->code_start;
616         jit->code_size = address->code_size;
617
618         ptr = (guint8 *) &address->data;
619
620         jit->prologue_end = read_leb128 (ptr, &ptr);
621         jit->epilogue_begin = read_leb128 (ptr, &ptr);
622
623         jit->num_line_numbers = read_leb128 (ptr, &ptr);
624         jit->line_numbers = g_new0 (MonoDebugLineNumberEntry, jit->num_line_numbers);
625         for (i = 0; i < jit->num_line_numbers; i++) {
626                 MonoDebugLineNumberEntry *lne = &jit->line_numbers [i];
627
628                 lne->il_offset = read_sleb128 (ptr, &ptr);
629                 lne->native_offset = read_sleb128 (ptr, &ptr);
630         }
631         jit->has_var_info = read_leb128 (ptr, &ptr);
632         if (jit->has_var_info) {
633                 if (*ptr++) {
634                         jit->this_var = g_new0 (MonoDebugVarInfo, 1);
635                         read_variable (jit->this_var, ptr, &ptr);
636                 }
637
638                 jit->num_params = read_leb128 (ptr, &ptr);
639                 jit->params = g_new0 (MonoDebugVarInfo, jit->num_params);
640                 for (i = 0; i < jit->num_params; i++)
641                         read_variable (&jit->params [i], ptr, &ptr);
642
643                 jit->num_locals = read_leb128 (ptr, &ptr);
644                 jit->locals = g_new0 (MonoDebugVarInfo, jit->num_locals);
645                 for (i = 0; i < jit->num_locals; i++)
646                         read_variable (&jit->locals [i], ptr, &ptr);
647
648                 if (*ptr++) {
649                         jit->gsharedvt_info_var = g_new0 (MonoDebugVarInfo, 1);
650                         jit->gsharedvt_locals_var = g_new0 (MonoDebugVarInfo, 1);
651                         read_variable (jit->gsharedvt_info_var, ptr, &ptr);
652                         read_variable (jit->gsharedvt_locals_var, ptr, &ptr);
653                 }
654         }
655
656         return jit;
657 }
658
659 static MonoDebugMethodJitInfo *
660 find_method (MonoMethod *method, MonoDomain *domain)
661 {
662         MonoDebugDataTable *table;
663         MonoDebugMethodAddress *address;
664
665         table = lookup_data_table (domain);
666         address = (MonoDebugMethodAddress *)g_hash_table_lookup (table->method_address_hash, method);
667
668         if (!address)
669                 return NULL;
670
671         return mono_debug_read_method (address);
672 }
673
674 MonoDebugMethodJitInfo *
675 mono_debug_find_method (MonoMethod *method, MonoDomain *domain)
676 {
677         MonoDebugMethodJitInfo *res;
678
679         if (mono_debug_format == MONO_DEBUG_FORMAT_NONE)
680                 return NULL;
681
682         mono_debugger_lock ();
683         res = find_method (method, domain);
684         mono_debugger_unlock ();
685         return res;
686 }
687
688 MonoDebugMethodAddressList *
689 mono_debug_lookup_method_addresses (MonoMethod *method)
690 {
691         g_assert_not_reached ();
692         return NULL;
693 }
694
695 static gint32
696 il_offset_from_address (MonoMethod *method, MonoDomain *domain, guint32 native_offset)
697 {
698         MonoDebugMethodJitInfo *jit;
699         int i;
700
701         jit = find_method (method, domain);
702         if (!jit || !jit->line_numbers)
703                 goto cleanup_and_fail;
704
705         for (i = jit->num_line_numbers - 1; i >= 0; i--) {
706                 MonoDebugLineNumberEntry lne = jit->line_numbers [i];
707
708                 if (lne.native_offset <= native_offset) {
709                         mono_debug_free_method_jit_info (jit);
710                         return lne.il_offset;
711                 }
712         }
713
714 cleanup_and_fail:
715         mono_debug_free_method_jit_info (jit);
716         return -1;
717 }
718
719 /**
720  * mono_debug_il_offset_from_address:
721  *
722  *   Compute the IL offset corresponding to NATIVE_OFFSET inside the native
723  * code of METHOD in DOMAIN.
724  */
725 gint32
726 mono_debug_il_offset_from_address (MonoMethod *method, MonoDomain *domain, guint32 native_offset)
727 {
728         gint32 res;
729
730         mono_debugger_lock ();
731
732         res = il_offset_from_address (method, domain, native_offset);
733
734         mono_debugger_unlock ();
735
736         return res;
737 }
738
739 /**
740  * mono_debug_lookup_source_location:
741  * \param address Native offset within the \p method's machine code.
742  * Lookup the source code corresponding to the machine instruction located at
743  * native offset \p address within \p method.
744  * The returned \c MonoDebugSourceLocation contains both file / line number
745  * information and the corresponding IL offset.  It must be freed by
746  * mono_debug_free_source_location().
747  */
748 MonoDebugSourceLocation *
749 mono_debug_lookup_source_location (MonoMethod *method, guint32 address, MonoDomain *domain)
750 {
751         MonoDebugMethodInfo *minfo;
752         MonoDebugSourceLocation *location;
753         gint32 offset;
754
755         if (mono_debug_format == MONO_DEBUG_FORMAT_NONE)
756                 return NULL;
757
758         mono_debugger_lock ();
759         minfo = mono_debug_lookup_method_internal (method);
760         if (!minfo || !minfo->handle) {
761                 mono_debugger_unlock ();
762                 return NULL;
763         }
764
765         if (!minfo->handle->ppdb && (!minfo->handle->symfile || !mono_debug_symfile_is_loaded (minfo->handle->symfile))) {
766                 mono_debugger_unlock ();
767                 return NULL;
768         }
769
770         offset = il_offset_from_address (method, domain, address);
771         if (offset < 0) {
772                 mono_debugger_unlock ();
773                 return NULL;
774         }
775
776         if (minfo->handle->ppdb)
777                 location = mono_ppdb_lookup_location (minfo, offset);
778         else
779                 location = mono_debug_symfile_lookup_location (minfo, offset);
780         mono_debugger_unlock ();
781         return location;
782 }
783
784 MonoDebugSourceLocation *
785 mono_debug_method_lookup_location (MonoDebugMethodInfo *minfo, int il_offset)
786 {
787         MonoDebugSourceLocation *location;
788
789         mono_debugger_lock ();
790         if (minfo->handle->ppdb)
791                 location = mono_ppdb_lookup_location (minfo, il_offset);
792         else
793                 location = mono_debug_symfile_lookup_location (minfo, il_offset);
794         mono_debugger_unlock ();
795         return location;
796 }
797
798 /*
799  * mono_debug_lookup_locals:
800  *
801  *   Return information about the local variables of MINFO.
802  * The result should be freed using mono_debug_free_locals ().
803  */
804 MonoDebugLocalsInfo*
805 mono_debug_lookup_locals (MonoMethod *method)
806 {
807         MonoDebugMethodInfo *minfo;
808         MonoDebugLocalsInfo *res;
809
810         if (mono_debug_format == MONO_DEBUG_FORMAT_NONE)
811                 return NULL;
812
813         mono_debugger_lock ();
814         minfo = mono_debug_lookup_method_internal (method);
815         if (!minfo || !minfo->handle) {
816                 mono_debugger_unlock ();
817                 return NULL;
818         }
819
820         if (minfo->handle->ppdb) {
821                 res = mono_ppdb_lookup_locals (minfo);
822         } else {
823                 if (!minfo->handle->symfile || !mono_debug_symfile_is_loaded (minfo->handle->symfile))
824                         res = NULL;
825                 else
826                         res = mono_debug_symfile_lookup_locals (minfo);
827         }
828         mono_debugger_unlock ();
829
830         return res;
831 }
832
833 /*
834  * mono_debug_free_locals:
835  *
836  *   Free all the data allocated by mono_debug_lookup_locals ().
837  */
838 void
839 mono_debug_free_locals (MonoDebugLocalsInfo *info)
840 {
841         int i;
842
843         for (i = 0; i < info->num_locals; ++i)
844                 g_free (info->locals [i].name);
845         g_free (info->locals);
846         g_free (info->code_blocks);
847         g_free (info);
848 }
849
850 /*
851 * mono_debug_lookup_method_async_debug_info:
852 *
853 *   Return information about the async stepping information of method.
854 * The result should be freed using mono_debug_free_async_debug_info ().
855 */
856 MonoDebugMethodAsyncInfo*
857 mono_debug_lookup_method_async_debug_info (MonoMethod *method)
858 {
859         MonoDebugMethodInfo *minfo;
860         MonoDebugMethodAsyncInfo *res = NULL;
861
862         if (mono_debug_format == MONO_DEBUG_FORMAT_NONE)
863                 return NULL;
864
865         mono_debugger_lock ();
866         minfo = mono_debug_lookup_method_internal (method);
867         if (!minfo || !minfo->handle) {
868                 mono_debugger_unlock ();
869                 return NULL;
870         }
871
872         if (minfo->handle->ppdb)
873                 res = mono_ppdb_lookup_method_async_debug_info (minfo);
874
875         mono_debugger_unlock ();
876
877         return res;
878 }
879
880 /*
881  * mono_debug_free_method_async_debug_info:
882  *
883  *   Free all the data allocated by mono_debug_lookup_method_async_debug_info ().
884  */
885 void
886 mono_debug_free_method_async_debug_info (MonoDebugMethodAsyncInfo *info)
887 {
888         if (info->num_awaits) {
889                 g_free (info->yield_offsets);
890                 g_free (info->resume_offsets);
891                 g_free (info->move_next_method_token);
892         }
893         g_free (info);
894 }
895
896 /**
897  * mono_debug_free_source_location:
898  * \param location A \c MonoDebugSourceLocation
899  * Frees the \p location.
900  */
901 void
902 mono_debug_free_source_location (MonoDebugSourceLocation *location)
903 {
904         if (location) {
905                 g_free (location->source_file);
906                 g_free (location);
907         }
908 }
909
910 static int (*get_seq_point) (MonoDomain *domain, MonoMethod *method, gint32 native_offset);
911
912 void
913 mono_install_get_seq_point (MonoGetSeqPointFunc func)
914 {
915         get_seq_point = func;
916 }
917
918 /**
919  * mono_debug_print_stack_frame:
920  * \param native_offset Native offset within the \p method's machine code.
921  * Conventient wrapper around mono_debug_lookup_source_location() which can be
922  * used if you only want to use the location to print a stack frame.
923  */
924 gchar *
925 mono_debug_print_stack_frame (MonoMethod *method, guint32 native_offset, MonoDomain *domain)
926 {
927         MonoDebugSourceLocation *location;
928         gchar *fname, *ptr, *res;
929         int offset;
930
931         fname = mono_method_full_name (method, TRUE);
932         for (ptr = fname; *ptr; ptr++) {
933                 if (*ptr == ':') *ptr = '.';
934         }
935
936         location = mono_debug_lookup_source_location (method, native_offset, domain);
937
938         if (!location) {
939                 if (mono_debug_initialized) {
940                         mono_debugger_lock ();
941                         offset = il_offset_from_address (method, domain, native_offset);
942                         mono_debugger_unlock ();
943                 } else {
944                         offset = -1;
945                 }
946
947                 if (offset < 0 && get_seq_point)
948                         offset = get_seq_point (domain, method, native_offset);
949
950                 if (offset < 0)
951                         res = g_strdup_printf ("at %s <0x%05x>", fname, native_offset);
952                 else {
953                         char *mvid = mono_guid_to_string_minimal ((uint8_t*)method->klass->image->heap_guid.data);
954                         char *aotid = mono_runtime_get_aotid ();
955                         if (aotid)
956                                 res = g_strdup_printf ("at %s [0x%05x] in <%s#%s>:0" , fname, offset, mvid, aotid);
957                         else
958                                 res = g_strdup_printf ("at %s [0x%05x] in <%s>:0" , fname, offset, mvid);
959
960                         g_free (aotid);
961                         g_free (mvid);
962                 }
963                 g_free (fname);
964                 return res;
965         }
966
967         res = g_strdup_printf ("at %s [0x%05x] in %s:%d", fname, location->il_offset,
968                                location->source_file, location->row);
969
970         g_free (fname);
971         mono_debug_free_source_location (location);
972         return res;
973 }
974
975 void
976 mono_set_is_debugger_attached (gboolean attached)
977 {
978         is_attached = attached;
979 }
980
981 gboolean
982 mono_is_debugger_attached (void)
983 {
984         return is_attached;
985 }
986
987 /*
988  * Bundles
989  */
990
991 typedef struct _BundledSymfile BundledSymfile;
992
993 struct _BundledSymfile {
994         BundledSymfile *next;
995         const char *aname;
996         const mono_byte *raw_contents;
997         int size;
998 };
999
1000 static BundledSymfile *bundled_symfiles = NULL;
1001
1002 void
1003 mono_register_symfile_for_assembly (const char *assembly_name, const mono_byte *raw_contents, int size)
1004 {
1005         BundledSymfile *bsymfile;
1006
1007         bsymfile = g_new0 (BundledSymfile, 1);
1008         bsymfile->aname = assembly_name;
1009         bsymfile->raw_contents = raw_contents;
1010         bsymfile->size = size;
1011         bsymfile->next = bundled_symfiles;
1012         bundled_symfiles = bsymfile;
1013 }
1014
1015 static MonoDebugHandle *
1016 open_symfile_from_bundle (MonoImage *image)
1017 {
1018         BundledSymfile *bsymfile;
1019
1020         for (bsymfile = bundled_symfiles; bsymfile; bsymfile = bsymfile->next) {
1021                 if (strcmp (bsymfile->aname, image->module_name))
1022                         continue;
1023
1024                 return mono_debug_open_image (image, bsymfile->raw_contents, bsymfile->size);
1025         }
1026
1027         return NULL;
1028 }
1029
1030 void
1031 mono_debugger_lock (void)
1032 {
1033         g_assert (mono_debug_initialized);
1034         mono_os_mutex_lock (&debugger_lock_mutex);
1035 }
1036
1037 void
1038 mono_debugger_unlock (void)
1039 {
1040         g_assert (mono_debug_initialized);
1041         mono_os_mutex_unlock (&debugger_lock_mutex);
1042 }
1043
1044 /**
1045  * mono_debug_enabled:
1046  *
1047  * Returns true is debug information is enabled. This doesn't relate if a debugger is present or not.
1048  */
1049 mono_bool
1050 mono_debug_enabled (void)
1051 {
1052         return mono_debug_format != MONO_DEBUG_FORMAT_NONE;
1053 }
1054
1055 void
1056 mono_debug_get_seq_points (MonoDebugMethodInfo *minfo, char **source_file, GPtrArray **source_file_list, int **source_files, MonoSymSeqPoint **seq_points, int *n_seq_points)
1057 {
1058         if (minfo->handle->ppdb)
1059                 mono_ppdb_get_seq_points (minfo, source_file, source_file_list, source_files, seq_points, n_seq_points);
1060         else
1061                 mono_debug_symfile_get_seq_points (minfo, source_file, source_file_list, source_files, seq_points, n_seq_points);
1062 }