[profiler] Implement call context introspection for enter/leave events.
[mono.git] / mono / metadata / profiler-private.h
1 /*
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.
5  */
6
7 #ifndef __MONO_PROFILER_PRIVATE_H__
8 #define __MONO_PROFILER_PRIVATE_H__
9
10 #define MONO_PROFILER_UNSTABLE_GC_ROOTS
11 #include <mono/metadata/profiler.h>
12 #include <mono/utils/mono-context.h>
13 #include <mono/utils/mono-lazy-init.h>
14 #include <mono/utils/mono-os-mutex.h>
15 #include <mono/utils/mono-os-semaphore.h>
16
17 struct _MonoProfilerDesc {
18         MonoProfilerHandle next;
19         MonoProfiler *prof;
20         volatile gpointer coverage_filter;
21         volatile gpointer call_instrumentation_filter;
22
23 #define _MONO_PROFILER_EVENT(name) \
24         volatile gpointer name ## _cb;
25 #define MONO_PROFILER_EVENT_0(name, type) \
26         _MONO_PROFILER_EVENT(name)
27 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
28         _MONO_PROFILER_EVENT(name)
29 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
30         _MONO_PROFILER_EVENT(name)
31 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
32         _MONO_PROFILER_EVENT(name)
33 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
34         _MONO_PROFILER_EVENT(name)
35 #include <mono/metadata/profiler-events.h>
36 #undef MONO_PROFILER_EVENT_0
37 #undef MONO_PROFILER_EVENT_1
38 #undef MONO_PROFILER_EVENT_2
39 #undef MONO_PROFILER_EVENT_3
40 #undef MONO_PROFILER_EVENT_4
41 #undef _MONO_PROFILER_EVENT
42 };
43
44 typedef struct {
45         gboolean startup_done;
46
47         MonoProfilerHandle profilers;
48
49         mono_lazy_init_t coverage_status;
50         mono_mutex_t coverage_mutex;
51         GHashTable *coverage_hash;
52
53         MonoProfilerHandle sampling_owner;
54         MonoSemType sampling_semaphore;
55         MonoProfilerSampleMode sample_mode;
56         guint32 sample_freq;
57
58         gboolean allocations;
59
60         gboolean call_contexts;
61         void (*context_enable) (void);
62         gpointer (*context_get_this) (MonoProfilerCallContext *);
63         gpointer (*context_get_argument) (MonoProfilerCallContext *, guint32);
64         gpointer (*context_get_local) (MonoProfilerCallContext *, guint32);
65         gpointer (*context_get_result) (MonoProfilerCallContext *);
66         gpointer (*context_free_buffer) (gpointer);
67
68 #define _MONO_PROFILER_EVENT(name) \
69         volatile gint32 name ## _count;
70 #define MONO_PROFILER_EVENT_0(name, type) \
71         _MONO_PROFILER_EVENT(name)
72 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
73         _MONO_PROFILER_EVENT(name)
74 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
75         _MONO_PROFILER_EVENT(name)
76 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
77         _MONO_PROFILER_EVENT(name)
78 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
79         _MONO_PROFILER_EVENT(name)
80 #include <mono/metadata/profiler-events.h>
81 #undef MONO_PROFILER_EVENT_0
82 #undef MONO_PROFILER_EVENT_1
83 #undef MONO_PROFILER_EVENT_2
84 #undef MONO_PROFILER_EVENT_3
85 #undef MONO_PROFILER_EVENT_4
86 #undef _MONO_PROFILER_EVENT
87 } MonoProfilerState;
88
89 extern MonoProfilerState mono_profiler_state;
90
91 typedef struct {
92         guint32 entries;
93         struct {
94                 guchar *cil_code;
95                 guint32 count;
96         } data [1];
97 } MonoProfilerCoverageInfo;
98
99 void mono_profiler_started (void);
100 void mono_profiler_cleanup (void);
101
102 static inline gboolean
103 mono_profiler_installed (void)
104 {
105         return !!mono_profiler_state.profilers;
106 }
107
108 MonoProfilerCoverageInfo *mono_profiler_coverage_alloc (MonoMethod *method, guint32 entries);
109 void mono_profiler_coverage_free (MonoMethod *method);
110
111 struct _MonoProfilerCallContext {
112         /*
113          * Must be the first field (the JIT relies on it). Only filled out if this
114          * is a JIT frame; otherwise, zeroed.
115          */
116         MonoContext context;
117         /*
118          * A non-NULL MonoInterpFrameHandle if this is an interpreter frame.
119          */
120         gpointer interp_frame;
121         MonoMethod *method;
122         /*
123          * Points to the return value for an epilogue context. For a prologue, this
124          * is set to NULL.
125          */
126         gpointer return_value;
127 };
128
129 MonoProfilerCallInstrumentationFlags mono_profiler_get_call_instrumentation_flags (MonoMethod *method);
130
131 gboolean mono_profiler_sampling_enabled (void);
132 void mono_profiler_sampling_thread_post (void);
133 void mono_profiler_sampling_thread_wait (void);
134
135 static inline gboolean
136 mono_profiler_allocations_enabled (void)
137 {
138         return mono_profiler_state.allocations;
139 }
140
141 #define _MONO_PROFILER_EVENT(name, ...) \
142         void mono_profiler_raise_ ## name (__VA_ARGS__);
143 #define MONO_PROFILER_EVENT_0(name, type) \
144         _MONO_PROFILER_EVENT(name, void)
145 #define MONO_PROFILER_EVENT_1(name, type, arg1_type, arg1_name) \
146         _MONO_PROFILER_EVENT(name, arg1_type arg1_name)
147 #define MONO_PROFILER_EVENT_2(name, type, arg1_type, arg1_name, arg2_type, arg2_name) \
148         _MONO_PROFILER_EVENT(name, arg1_type arg1_name, arg2_type arg2_name)
149 #define MONO_PROFILER_EVENT_3(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name) \
150         _MONO_PROFILER_EVENT(name, arg1_type arg1_name, arg2_type arg2_name, arg3_type arg3_name)
151 #define MONO_PROFILER_EVENT_4(name, type, arg1_type, arg1_name, arg2_type, arg2_name, arg3_type, arg3_name, arg4_type, arg4_name) \
152         _MONO_PROFILER_EVENT(name, arg1_type arg1_name, arg2_type arg2_name, arg3_type arg3_name, arg4_type arg4_name)
153 #include <mono/metadata/profiler-events.h>
154 #undef MONO_PROFILER_EVENT_0
155 #undef MONO_PROFILER_EVENT_1
156 #undef MONO_PROFILER_EVENT_2
157 #undef MONO_PROFILER_EVENT_3
158 #undef MONO_PROFILER_EVENT_4
159 #undef _MONO_PROFILER_EVENT
160
161 // These are the macros the rest of the runtime should use.
162
163 #define MONO_PROFILER_ENABLED(name) \
164         G_UNLIKELY (mono_profiler_state.name ## _count)
165
166 #define MONO_PROFILER_RAISE(name, args) \
167         do { \
168                 if (MONO_PROFILER_ENABLED (name)) \
169                         mono_profiler_raise_ ## name args; \
170         } while (0)
171
172 #endif // __MONO_PROFILER_PRIVATE_H__