Merge pull request #5438 from cherusker/cherusker-2017-08-24-complete-prototype

[mono.git] / mono / mini / jit.h

diff --git a/mono/mini/jit.h b/mono/mini/jit.h
index f78dd119de8fa234c3ba8b0b5a0cd595ef39168b..408fead304ef2f95073bbe518c329125f519ea24 100644 (file)
--- a/mono/mini/jit.h
+++ b/mono/mini/jit.h
@@ -1,4 +1,5 @@
-/*
+/**
+ * \file
  * Author:
  *   Dietmar Maurer (dietmar@ximian.com)
  *
@@ -10,33 +11,90 @@
 
 #include <mono/metadata/appdomain.h>
 
-G_BEGIN_DECLS
+MONO_BEGIN_DECLS
 
-MonoDomain * 
+MONO_API MonoDomain * 
 mono_jit_init              (const char *file);
 
-MonoDomain * 
+MONO_API MonoDomain * 
 mono_jit_init_version      (const char *root_domain_name, const char *runtime_version);
 
-int
+MONO_API int
 mono_jit_exec              (MonoDomain *domain, MonoAssembly *assembly, 
                            int argc, char *argv[]);
-void        
+MONO_API void        
 mono_jit_cleanup           (MonoDomain *domain);
 
-gboolean
+MONO_API mono_bool
 mono_jit_set_trace_options (const char* options);
 
-void
-mono_set_signal_chaining   (gboolean chain_signals);
+MONO_API void
+mono_set_signal_chaining   (mono_bool chain_signals);
+
+MONO_API void
+mono_set_crash_chaining   (mono_bool chain_signals);
 
-void
-mono_jit_set_aot_only      (gboolean aot_only);
+/**
+ * This function is deprecated, use mono_jit_set_aot_mode instead.
+ */
+MONO_API void
+mono_jit_set_aot_only      (mono_bool aot_only);
 
-void
+/**
+ * Allows control over our AOT (Ahead-of-time) compilation mode.
+ */
+typedef enum {
+       /* Disables AOT mode */
+       MONO_AOT_MODE_NONE,
+       /* Enables normal AOT mode, equivalent to mono_jit_set_aot_only (false) */
+       MONO_AOT_MODE_NORMAL,
+       /* Enables hybrid AOT mode, JIT can still be used for wrappers */
+       MONO_AOT_MODE_HYBRID,
+       /* Enables full AOT mode, JIT is disabled and not allowed,
+        * equivalent to mono_jit_set_aot_only (true) */
+       MONO_AOT_MODE_FULL,
+       /* Same as full, but use only llvm compiled code */
+       MONO_AOT_MODE_LLVMONLY,
+       /* Uses Interpreter, JIT is disabled and not allowed,
+        * equivalent to "--full-aot --interpreter" */
+       MONO_AOT_MODE_INTERP
+} MonoAotMode;
+
+MONO_API void
+mono_jit_set_aot_mode      (MonoAotMode mode);
+
+/*
+ * Returns whether the runtime was invoked for the purpose of AOT-compiling an
+ * assembly, i.e. no managed code will run.
+ */
+MONO_API mono_bool
+mono_jit_aot_compiling (void);
+
+/* Allow embedders to decide wherther to actually obey breakpoint instructions
+ * in specific methods (works for both break IL instructions and Debugger.Break ()
+ * method calls).
+ */
+typedef enum {
+       /* the default is to always obey the breakpoint */
+       MONO_BREAK_POLICY_ALWAYS,
+       /* a nop is inserted instead of a breakpoint */
+       MONO_BREAK_POLICY_NEVER,
+       /* the breakpoint is executed only if the program has ben started under
+        * the debugger (that is if a debugger was attached at the time the method
+        * was compiled).
+        */
+       MONO_BREAK_POLICY_ON_DBG
+} MonoBreakPolicy;
+
+typedef MonoBreakPolicy (*MonoBreakPolicyFunc) (MonoMethod *method);
+MONO_API void mono_set_break_policy (MonoBreakPolicyFunc policy_callback);
+
+MONO_API void
 mono_jit_parse_options     (int argc, char * argv[]);
 
-G_END_DECLS
+MONO_API char*       mono_get_runtime_build_info    (void);
+
+MONO_END_DECLS
 
 #endif