2 * Licensed to the .NET Foundation under one or more agreements.
3 * The .NET Foundation licenses this file to you under the MIT license.
4 * See the LICENSE file in the project root for more information.
7 #include <mono/metadata/assembly.h>
8 #include <mono/metadata/gc-internals.h>
9 #include <mono/metadata/mono-config-dirs.h>
10 #include <mono/metadata/mono-debug.h>
11 #include <mono/metadata/profiler-private.h>
12 #include <mono/utils/mono-dl.h>
13 #include <mono/utils/mono-error-internals.h>
14 #include <mono/utils/mono-logger-internals.h>
16 MonoProfilerState mono_profiler_state;
18 typedef void (*MonoProfilerInitializer) (const char *);
20 #define OLD_INITIALIZER_NAME "mono_profiler_startup"
21 #define NEW_INITIALIZER_NAME "mono_profiler_init"
24 load_profiler (MonoDl *module, const char *name, const char *desc)
29 char *err, *old_name = g_strdup_printf (OLD_INITIALIZER_NAME);
30 MonoProfilerInitializer func;
32 if (!(err = mono_dl_symbol (module, old_name, (gpointer) &func))) {
33 mono_profiler_printf_err ("Found old-style startup symbol '%s' for the '%s' profiler; it has not been migrated to the new API.", old_name, name);
41 char *new_name = g_strdup_printf (NEW_INITIALIZER_NAME "_%s", name);
43 if ((err = mono_dl_symbol (module, new_name, (gpointer *) &func))) {
57 load_profiler_from_executable (const char *name, const char *desc)
62 * Some profilers (such as ours) may need to call back into the runtime
63 * from their sampling callback (which is called in async-signal context).
64 * They need to be able to know that all references back to the runtime
65 * have been resolved; otherwise, calling runtime functions may result in
66 * invoking the dynamic linker which is not async-signal-safe. Passing
67 * MONO_DL_EAGER will ask the dynamic linker to resolve everything upfront.
69 MonoDl *module = mono_dl_open (NULL, MONO_DL_EAGER, &err);
72 mono_profiler_printf_err ("Could not open main executable: %s", err);
77 return load_profiler (module, name, desc);
81 load_profiler_from_directory (const char *directory, const char *libname, const char *name, const char *desc)
86 while ((path = mono_dl_build_path (directory, libname, &iter))) {
87 // See the comment in load_embedded_profiler ().
88 MonoDl *module = mono_dl_open (path, MONO_DL_EAGER, NULL);
93 return load_profiler (module, name, desc);
100 load_profiler_from_installation (const char *libname, const char *name, const char *desc)
103 MonoDl *module = mono_dl_open_runtime_lib (libname, MONO_DL_EAGER, &err);
108 return load_profiler (module, name, desc);
114 mono_profiler_load (const char *desc)
116 if (!desc || !strcmp ("default", desc))
119 const char *col = strchr (desc, ':');
123 mname = (char *) g_memdup (desc, col - desc + 1);
124 mname [col - desc] = 0;
126 mname = g_strdup (desc);
128 if (!load_profiler_from_executable (mname, desc)) {
129 char *libname = g_strdup_printf ("mono-profiler-%s", mname);
130 gboolean res = load_profiler_from_installation (libname, mname, desc);
132 if (!res && mono_config_get_assemblies_dir ())
133 res = load_profiler_from_directory (mono_assembly_getrootdir (), libname, mname, desc);
136 res = load_profiler_from_directory (NULL, libname, mname, desc);
139 mono_profiler_printf_err ("The '%s' profiler wasn't found in the main executable nor could it be loaded from '%s'.", mname, libname);
148 mono_profiler_create (MonoProfiler *prof)
150 MonoProfilerHandle handle = g_new0 (struct _MonoProfilerDesc, 1);
153 handle->next = mono_profiler_state.profilers;
155 mono_profiler_state.profilers = handle;
161 mono_profiler_set_coverage_filter_callback (MonoProfilerHandle handle, MonoProfilerCoverageFilterCallback cb)
163 InterlockedWritePointer (&handle->coverage_filter, (gpointer) cb);
167 mono_profiler_enable_coverage (void)
169 if (mono_profiler_state.startup_done)
172 mono_os_mutex_init (&mono_profiler_state.coverage_mutex);
173 mono_profiler_state.coverage_hash = g_hash_table_new (NULL, NULL);
175 if (!mono_debug_enabled ())
176 mono_debug_init (MONO_DEBUG_FORMAT_MONO);
184 mono_os_mutex_lock (&mono_profiler_state.coverage_mutex);
188 coverage_unlock (void)
190 mono_os_mutex_unlock (&mono_profiler_state.coverage_mutex);
194 mono_profiler_get_coverage_data (MonoProfilerHandle handle, MonoMethod *method, MonoProfilerCoverageCallback cb)
196 if (!mono_profiler_state.code_coverage)
201 MonoProfilerCoverageInfo *info = g_hash_table_lookup (mono_profiler_state.coverage_hash, method);
209 MonoMethodHeader *header = mono_method_get_header_checked (method, &error);
210 mono_error_assert_ok (&error);
214 const unsigned char *start = mono_method_header_get_code (header, &size, NULL);
215 const unsigned char *end = start - size;
216 MonoDebugMethodInfo *minfo = mono_debug_lookup_method (method);
218 for (guint32 i = 0; i < info->entries; i++) {
219 guchar *cil_code = info->data [i].cil_code;
221 if (cil_code && cil_code >= start && cil_code < end) {
222 guint32 offset = cil_code - start;
224 MonoProfilerCoverageData data = {
227 .counter = info->data [i].count,
233 MonoDebugSourceLocation *loc = mono_debug_method_lookup_location (minfo, offset);
236 data.file_name = g_strdup (loc->source_file);
237 data.line = loc->row;
238 data.column = loc->column;
240 mono_debug_free_source_location (loc);
244 cb (handle->prof, &data);
246 g_free ((char *) data.file_name);
250 mono_metadata_free_mh (header);
255 MonoProfilerCoverageInfo *
256 mono_profiler_coverage_alloc (MonoMethod *method, guint32 entries)
258 if (!mono_profiler_state.code_coverage)
261 gboolean cover = FALSE;
263 for (MonoProfilerHandle handle = mono_profiler_state.profilers; handle; handle = handle->next) {
264 MonoProfilerCoverageFilterCallback cb = handle->coverage_filter;
267 cover |= cb (handle->prof, method);
275 MonoProfilerCoverageInfo *info = g_malloc0 (sizeof (MonoProfilerCoverageInfo) + SIZEOF_VOID_P * 2 * entries);
277 info->entries = entries;
279 g_hash_table_insert (mono_profiler_state.coverage_hash, method, info);
287 mono_profiler_enable_sampling (MonoProfilerHandle handle)
289 if (mono_profiler_state.startup_done)
292 if (mono_profiler_state.sampling_owner)
295 mono_profiler_state.sampling_owner = handle;
296 mono_profiler_state.sample_mode = MONO_PROFILER_SAMPLE_MODE_NONE;
297 mono_profiler_state.sample_freq = 100;
298 mono_os_sem_init (&mono_profiler_state.sampling_semaphore, 0);
304 mono_profiler_set_sample_mode (MonoProfilerHandle handle, MonoProfilerSampleMode mode, uint32_t freq)
306 if (handle != mono_profiler_state.sampling_owner)
309 mono_profiler_state.sample_mode = mode;
310 mono_profiler_state.sample_freq = freq;
312 mono_profiler_sampling_thread_post ();
318 mono_profiler_get_sample_mode (MonoProfilerHandle handle, MonoProfilerSampleMode *mode, uint32_t *freq)
321 *mode = mono_profiler_state.sample_mode;
324 *freq = mono_profiler_state.sample_freq;
326 return handle == mono_profiler_state.sampling_owner;
330 mono_profiler_sampling_enabled (void)
332 return !!mono_profiler_state.sampling_owner;
336 mono_profiler_sampling_thread_post (void)
338 mono_os_sem_post (&mono_profiler_state.sampling_semaphore);
342 mono_profiler_sampling_thread_wait (void)
344 mono_os_sem_wait (&mono_profiler_state.sampling_semaphore, MONO_SEM_FLAGS_NONE);
348 mono_profiler_enable_allocations (void)
350 if (mono_profiler_state.startup_done)
353 return mono_profiler_state.allocations = TRUE;
357 mono_profiler_set_call_instrumentation_filter_callback (MonoProfilerHandle handle, MonoProfilerCallInstrumentationFilterCallback cb)
359 InterlockedWritePointer (&handle->call_instrumentation_filter, (gpointer) cb);
363 mono_profiler_enable_call_context_introspection (void)
365 if (mono_profiler_state.startup_done)
368 mono_profiler_state.context_enable ();
370 return mono_profiler_state.call_contexts = TRUE;
374 mono_profiler_call_context_get_this (MonoProfilerCallContext *context)
376 if (!mono_profiler_state.call_contexts)
379 return mono_profiler_state.context_get_this (context);
383 mono_profiler_call_context_get_argument (MonoProfilerCallContext *context, uint32_t position)
385 if (!mono_profiler_state.call_contexts)
388 return mono_profiler_state.context_get_argument (context, position);
392 mono_profiler_call_context_get_local (MonoProfilerCallContext *context, uint32_t position)
394 if (!mono_profiler_state.call_contexts)
397 return mono_profiler_state.context_get_local (context, position);
401 mono_profiler_call_context_get_result (MonoProfilerCallContext *context)
403 if (!mono_profiler_state.call_contexts)
406 return mono_profiler_state.context_get_result (context);
410 mono_profiler_call_context_free_buffer (void *buffer)
412 mono_profiler_state.context_free_buffer (buffer);
415 MonoProfilerCallInstrumentationFlags
416 mono_profiler_get_call_instrumentation_flags (MonoMethod *method)
418 MonoProfilerCallInstrumentationFlags flags = MONO_PROFILER_CALL_INSTRUMENTATION_NONE;
420 for (MonoProfilerHandle handle = mono_profiler_state.profilers; handle; handle = handle->next) {
421 MonoProfilerCallInstrumentationFilterCallback cb = handle->call_instrumentation_filter;
424 flags |= cb (handle->prof, method);
431 mono_profiler_started (void)
433 mono_profiler_state.startup_done = TRUE;
437 mono_profiler_cleanup (void)
439 for (MonoProfilerHandle handle = mono_profiler_state.profilers; handle; handle = handle->next) {
440 #define _MONO_PROFILER_EVENT(name) \
441 mono_profiler_set_ ## name ## _callback (handle, NULL); \
442 g_assert (!handle->name ## _cb);
443 #define MONO_PROFILER_EVENT_0(name, type) \
444 _MONO_PROFILER_EVENT(name)
445 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
446 _MONO_PROFILER_EVENT(name)
447 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
448 _MONO_PROFILER_EVENT(name)
449 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
450 _MONO_PROFILER_EVENT(name)
451 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
452 _MONO_PROFILER_EVENT(name)
453 #include <mono/metadata/profiler-events.h>
454 #undef MONO_PROFILER_EVENT_0
455 #undef MONO_PROFILER_EVENT_1
456 #undef MONO_PROFILER_EVENT_2
457 #undef MONO_PROFILER_EVENT_3
458 #undef MONO_PROFILER_EVENT_4
459 #undef _MONO_PROFILER_EVENT
462 #define _MONO_PROFILER_EVENT(name, type) \
463 g_assert (!mono_profiler_state.name ## _count);
464 #define MONO_PROFILER_EVENT_0(name, type) \
465 _MONO_PROFILER_EVENT(name, type)
466 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
467 _MONO_PROFILER_EVENT(name, type)
468 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
469 _MONO_PROFILER_EVENT(name, type)
470 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
471 _MONO_PROFILER_EVENT(name, type)
472 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
473 _MONO_PROFILER_EVENT(name, type)
474 #include <mono/metadata/profiler-events.h>
475 #undef MONO_PROFILER_EVENT_0
476 #undef MONO_PROFILER_EVENT_1
477 #undef MONO_PROFILER_EVENT_2
478 #undef MONO_PROFILER_EVENT_3
479 #undef MONO_PROFILER_EVENT_4
480 #undef _MONO_PROFILER_EVENT
484 update_callback (volatile gpointer *location, gpointer new_, volatile gint32 *counter)
489 old = InterlockedReadPointer (location);
490 } while (InterlockedCompareExchangePointer (location, new_, old) != old);
493 * At this point, we could have installed a NULL callback while the counter
494 * is still non-zero, i.e. setting the callback and modifying the counter
495 * is not a single atomic operation. This is fine as we make sure callbacks
496 * are non-NULL before invoking them (see the code below that generates the
497 * raise functions), and besides, updating callbacks at runtime is an
498 * inherently racy operation.
502 InterlockedDecrement (counter);
505 InterlockedIncrement (counter);
508 #define _MONO_PROFILER_EVENT(name, type) \
510 mono_profiler_set_ ## name ## _callback (MonoProfilerHandle handle, MonoProfiler ## type ## Callback cb) \
512 update_callback (&handle->name ## _cb, (gpointer) cb, &mono_profiler_state.name ## _count); \
514 #define MONO_PROFILER_EVENT_0(name, type) \
515 _MONO_PROFILER_EVENT(name, type)
516 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
517 _MONO_PROFILER_EVENT(name, type)
518 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
519 _MONO_PROFILER_EVENT(name, type)
520 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
521 _MONO_PROFILER_EVENT(name, type)
522 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
523 _MONO_PROFILER_EVENT(name, type)
524 #include <mono/metadata/profiler-events.h>
525 #undef MONO_PROFILER_EVENT_0
526 #undef MONO_PROFILER_EVENT_1
527 #undef MONO_PROFILER_EVENT_2
528 #undef MONO_PROFILER_EVENT_3
529 #undef MONO_PROFILER_EVENT_4
530 #undef _MONO_PROFILER_EVENT
532 #define _MONO_PROFILER_EVENT(name, type, params, args) \
534 mono_profiler_raise_ ## name params \
536 for (MonoProfilerHandle h = mono_profiler_state.profilers; h; h = h->next) { \
537 MonoProfiler ## type ## Callback cb = h->name ## _cb; \
542 #define MONO_PROFILER_EVENT_0(name, type) \
543 _MONO_PROFILER_EVENT(name, type, (void), (h->prof))
544 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
545 _MONO_PROFILER_EVENT(name, type, (arg1_type arg1_name), (h->prof, arg1_name))
546 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
547 _MONO_PROFILER_EVENT(name, type, (arg1_type arg1_name, arg2_type arg2_name), (h->prof, arg1_name, arg2_name))
548 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
549 _MONO_PROFILER_EVENT(name, type, (arg1_type arg1_name, arg2_type arg2_name, arg3_type arg3_name), (h->prof, arg1_name, arg2_name, arg3_name))
550 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
551 _MONO_PROFILER_EVENT(name, type, (arg1_type arg1_name, arg2_type arg2_name, arg3_type arg3_name, arg4_type arg4_name), (h->prof, arg1_name, arg2_name, arg3_name, arg4_name))
552 #include <mono/metadata/profiler-events.h>
553 #undef MONO_PROFILER_EVENT_0
554 #undef MONO_PROFILER_EVENT_1
555 #undef MONO_PROFILER_EVENT_2
556 #undef MONO_PROFILER_EVENT_3
557 #undef MONO_PROFILER_EVENT_4
558 #undef _MONO_PROFILER_EVENT
561 * The following code is here to maintain compatibility with a few profiler API
562 * functions used by Xamarin.{Android,iOS,Mac} so that they keep working
563 * regardless of which system Mono version is used.
565 * TODO: Remove this some day if we're OK with breaking compatibility.
568 typedef void *MonoLegacyProfiler;
570 typedef void (*MonoLegacyProfileFunc) (MonoLegacyProfiler *prof);
571 typedef void (*MonoLegacyProfileThreadFunc) (MonoLegacyProfiler *prof, uintptr_t tid);
572 typedef void (*MonoLegacyProfileGCFunc) (MonoLegacyProfiler *prof, MonoProfilerGCEvent event, int generation);
573 typedef void (*MonoLegacyProfileGCResizeFunc) (MonoLegacyProfiler *prof, int64_t new_size);
574 typedef void (*MonoLegacyProfileJitResult) (MonoLegacyProfiler *prof, MonoMethod *method, MonoJitInfo *jinfo, int result);
576 struct _MonoProfiler {
577 MonoProfilerHandle handle;
578 MonoLegacyProfiler *profiler;
579 MonoLegacyProfileFunc shutdown_callback;
580 MonoLegacyProfileThreadFunc thread_start, thread_end;
581 MonoLegacyProfileGCFunc gc_event;
582 MonoLegacyProfileGCResizeFunc gc_heap_resize;
583 MonoLegacyProfileJitResult jit_end2;
586 static MonoProfiler *current;
588 MONO_API void mono_profiler_install (MonoLegacyProfiler *prof, MonoLegacyProfileFunc callback);
589 MONO_API void mono_profiler_install_thread (MonoLegacyProfileThreadFunc start, MonoLegacyProfileThreadFunc end);
590 MONO_API void mono_profiler_install_gc (MonoLegacyProfileGCFunc callback, MonoLegacyProfileGCResizeFunc heap_resize_callback);
591 MONO_API void mono_profiler_install_jit_end (MonoLegacyProfileJitResult end);
592 MONO_API void mono_profiler_set_events (int flags);
595 shutdown_cb (MonoProfiler *prof)
597 prof->shutdown_callback (prof->profiler);
601 mono_profiler_install (MonoLegacyProfiler *prof, MonoLegacyProfileFunc callback)
603 current = g_new0 (MonoProfiler, 1);
604 current->handle = mono_profiler_create (current);
605 current->profiler = prof;
606 current->shutdown_callback = callback;
609 mono_profiler_set_runtime_shutdown_end_callback (current->handle, shutdown_cb);
613 thread_start_cb (MonoProfiler *prof, uintptr_t tid)
615 prof->thread_start (prof->profiler, tid);
619 thread_stop_cb (MonoProfiler *prof, uintptr_t tid)
621 prof->thread_end (prof->profiler, tid);
625 mono_profiler_install_thread (MonoLegacyProfileThreadFunc start, MonoLegacyProfileThreadFunc end)
627 current->thread_start = start;
628 current->thread_end = end;
631 mono_profiler_set_thread_started_callback (current->handle, thread_start_cb);
634 mono_profiler_set_thread_stopped_callback (current->handle, thread_stop_cb);
638 gc_event_cb (MonoProfiler *prof, MonoProfilerGCEvent event, uint32_t generation)
640 prof->gc_event (prof->profiler, event, generation);
644 gc_resize_cb (MonoProfiler *prof, uintptr_t size)
646 prof->gc_heap_resize (prof->profiler, size);
650 mono_profiler_install_gc (MonoLegacyProfileGCFunc callback, MonoLegacyProfileGCResizeFunc heap_resize_callback)
652 current->gc_event = callback;
653 current->gc_heap_resize = heap_resize_callback;
656 mono_profiler_set_gc_event_callback (current->handle, gc_event_cb);
658 if (heap_resize_callback)
659 mono_profiler_set_gc_resize_callback (current->handle, gc_resize_cb);
663 jit_done_cb (MonoProfiler *prof, MonoMethod *method, MonoJitInfo *jinfo)
665 prof->jit_end2 (prof->profiler, method, jinfo, 0);
669 jit_failed_cb (MonoProfiler *prof, MonoMethod *method)
671 prof->jit_end2 (prof->profiler, method, NULL, 1);
675 mono_profiler_install_jit_end (MonoLegacyProfileJitResult end)
677 current->jit_end2 = end;
680 mono_profiler_set_jit_done_callback (current->handle, jit_done_cb);
681 mono_profiler_set_jit_failed_callback (current->handle, jit_failed_cb);
686 mono_profiler_set_events (int flags)