2005-01-05 Sebastien Pouliot <sebastien@ximian.com>
[mono.git] / mono / metadata / profiler.h
1 #ifndef __MONO_PROFILER_H__
2 #define __MONO_PROFILER_H__
3
4 #include <mono/metadata/object.h>
5 #include <mono/metadata/appdomain.h>
6
7 typedef enum {
8         MONO_PROFILE_NONE = 0,
9         MONO_PROFILE_APPDOMAIN_EVENTS = 1 << 0,
10         MONO_PROFILE_ASSEMBLY_EVENTS  = 1 << 1,
11         MONO_PROFILE_MODULE_EVENTS    = 1 << 2,
12         MONO_PROFILE_CLASS_EVENTS     = 1 << 3,
13         MONO_PROFILE_JIT_COMPILATION  = 1 << 4,
14         MONO_PROFILE_INLINING         = 1 << 5,
15         MONO_PROFILE_EXCEPTIONS       = 1 << 6,
16         MONO_PROFILE_ALLOCATIONS      = 1 << 7,
17         MONO_PROFILE_GC               = 1 << 8,
18         MONO_PROFILE_THREADS          = 1 << 9,
19         MONO_PROFILE_REMOTING         = 1 << 10,
20         MONO_PROFILE_TRANSITIONS      = 1 << 11,
21         MONO_PROFILE_ENTER_LEAVE      = 1 << 12,
22         MONO_PROFILE_COVERAGE         = 1 << 13,
23         MONO_PROFILE_INS_COVERAGE     = 1 << 14,
24         MONO_PROFILE_STATISTICAL      = 1 << 15
25 } MonoProfileFlags;
26
27 typedef enum {
28         MONO_PROFILE_OK,
29         MONO_PROFILE_FAILED
30 } MonoProfileResult;
31
32 /* coverage info */
33 typedef struct {
34         MonoMethod *method;
35         int iloffset;
36         int counter;
37         const char *filename;
38         int line;
39         int col;
40 } MonoProfileCoverageEntry;
41
42 typedef struct _MonoProfiler MonoProfiler;
43
44 /*
45  * Functions that the runtime will call on the profiler.
46  */
47
48 typedef void (*MonoProfileFunc) (MonoProfiler *prof);
49
50 typedef void (*MonoProfileAppDomainFunc) (MonoProfiler *prof, MonoDomain   *domain);
51 typedef void (*MonoProfileMethodFunc)   (MonoProfiler *prof, MonoMethod   *method);
52 typedef void (*MonoProfileClassFunc)    (MonoProfiler *prof, MonoClass    *klass);
53 typedef void (*MonoProfileModuleFunc)   (MonoProfiler *prof, MonoImage    *module);
54 typedef void (*MonoProfileAssemblyFunc) (MonoProfiler *prof, MonoAssembly *assembly);
55
56 typedef void (*MonoProfileAppDomainResult)(MonoProfiler *prof, MonoDomain   *domain,   int result);
57 typedef void (*MonoProfileMethodResult)   (MonoProfiler *prof, MonoMethod   *method,   int result);
58 typedef void (*MonoProfileClassResult)    (MonoProfiler *prof, MonoClass    *klass,    int result);
59 typedef void (*MonoProfileModuleResult)   (MonoProfiler *prof, MonoImage    *module,   int result);
60 typedef void (*MonoProfileAssemblyResult) (MonoProfiler *prof, MonoAssembly *assembly, int result);
61
62 typedef void (*MonoProfileMethodInline)   (MonoProfiler *prof, MonoMethod   *parent, MonoMethod *child, int *ok);
63
64 typedef void (*MonoProfileThreadFunc)     (MonoProfiler *prof, guint32 tid);
65 typedef void (*MonoProfileAllocFunc)      (MonoProfiler *prof, MonoObject *obj, MonoClass *klass);
66 typedef void (*MonoProfileStatFunc)       (MonoProfiler *prof, guchar *ip, void *context);
67
68 typedef gboolean (*MonoProfileCoverageFilterFunc)   (MonoProfiler *prof, MonoMethod *method);
69
70 typedef void (*MonoProfileCoverageFunc)   (MonoProfiler *prof, const MonoProfileCoverageEntry *entry);
71
72 /*
73  * Function the profiler may call.
74  */
75 void mono_profiler_install       (MonoProfiler *prof, MonoProfileFunc shutdown_callback);
76 void mono_profiler_set_events    (MonoProfileFlags events);
77
78 MonoProfileFlags mono_profiler_get_events (void);
79
80 void mono_profiler_install_appdomain   (MonoProfileAppDomainFunc start_load, MonoProfileAppDomainResult end_load,
81                                         MonoProfileAppDomainFunc start_unload, MonoProfileAppDomainFunc end_unload);
82 void mono_profiler_install_assembly    (MonoProfileAssemblyFunc start_load, MonoProfileAssemblyResult end_load,
83                                         MonoProfileAssemblyFunc start_unload, MonoProfileAssemblyFunc end_unload);
84 void mono_profiler_install_module      (MonoProfileModuleFunc start_load, MonoProfileModuleResult end_load,
85                                         MonoProfileModuleFunc start_unload, MonoProfileModuleFunc end_unload);
86 void mono_profiler_install_class       (MonoProfileClassFunc start_load, MonoProfileClassResult end_load,
87                                         MonoProfileClassFunc start_unload, MonoProfileClassFunc end_unload);
88
89 void mono_profiler_install_jit_compile (MonoProfileMethodFunc start, MonoProfileMethodResult end);
90 void mono_profiler_install_enter_leave (MonoProfileMethodFunc enter, MonoProfileMethodFunc fleave);
91 void mono_profiler_install_thread      (MonoProfileThreadFunc start, MonoProfileThreadFunc end);
92 void mono_profiler_install_transition  (MonoProfileMethodResult callback);
93 void mono_profiler_install_allocation  (MonoProfileAllocFunc callback);
94 void mono_profiler_install_statistical (MonoProfileStatFunc callback);
95 void mono_profiler_install_coverage_filter (MonoProfileCoverageFilterFunc callback);
96 void mono_profiler_coverage_get  (MonoProfiler *prof, MonoMethod *method, MonoProfileCoverageFunc func);
97
98 void mono_profiler_load             (const char *desc);
99
100 #endif /* __MONO_PROFILER_H__ */
101