2 * driver.c: The new mono JIT compiler.
5 * Paolo Molaro (lupus@ximian.com)
6 * Dietmar Maurer (dietmar@ximian.com)
8 * (C) 2002-2003 Ximian, Inc.
9 * (C) 2003-2006 Novell, Inc.
10 * Licensed under the MIT license. See LICENSE file in the project root for full license information.
17 #if HAVE_SCHED_SETAFFINITY
24 #include <mono/metadata/assembly.h>
25 #include <mono/metadata/loader.h>
26 #include <mono/metadata/tabledefs.h>
27 #include <mono/metadata/class.h>
28 #include <mono/metadata/object.h>
29 #include <mono/metadata/exception.h>
30 #include <mono/metadata/opcodes.h>
31 #include <mono/metadata/mono-endian.h>
32 #include <mono/metadata/tokentype.h>
33 #include <mono/metadata/tabledefs.h>
34 #include <mono/metadata/threads.h>
35 #include <mono/metadata/marshal.h>
36 #include <mono/metadata/appdomain.h>
37 #include <mono/metadata/debug-helpers.h>
38 #include "mono/metadata/profiler.h"
39 #include <mono/metadata/profiler-private.h>
40 #include <mono/metadata/mono-config.h>
41 #include <mono/metadata/environment.h>
42 #include <mono/metadata/verify.h>
43 #include <mono/metadata/verify-internals.h>
44 #include <mono/metadata/mono-debug.h>
45 #include <mono/metadata/security-manager.h>
46 #include <mono/metadata/security-core-clr.h>
47 #include <mono/metadata/gc-internals.h>
48 #include <mono/metadata/coree.h>
49 #include <mono/metadata/attach.h>
50 #include <mono/metadata/w32process.h>
51 #include "mono/utils/mono-counters.h"
52 #include "mono/utils/mono-hwcap.h"
53 #include "mono/utils/mono-logger-internals.h"
54 #include "mono/metadata/w32handle.h"
58 #include "aot-compiler.h"
59 #include "interpreter/interp.h"
65 #include "debugger-agent.h"
67 # include <sys/resource.h>
70 static FILE *mini_stats_fd;
72 static void mini_usage (void);
75 /* Need this to determine whether to detach console */
76 #include <mono/metadata/cil-coff.h>
77 /* This turns off command line globbing under win32 */
81 typedef void (*OptFunc) (const char *p);
84 #ifdef HAVE_ARRAY_ELEM_INIT
85 #define MSGSTRFIELD(line) MSGSTRFIELD1(line)
86 #define MSGSTRFIELD1(line) str##line
88 static const struct msgstr_t {
89 #define OPTFLAG(id,shift,name,desc) char MSGSTRFIELD(__LINE__) [sizeof (name) + sizeof (desc)];
90 #include "optflags-def.h"
93 #define OPTFLAG(id,shift,name,desc) name "\0" desc,
94 #include "optflags-def.h"
97 static const gint16 opt_names [] = {
98 #define OPTFLAG(id,shift,name,desc) [(shift)] = offsetof (struct msgstr_t, MSGSTRFIELD(__LINE__)),
99 #include "optflags-def.h"
103 #define optflag_get_name(id) ((const char*)&opstr + opt_names [(id)])
104 #define optflag_get_desc(id) (optflag_get_name(id) + 1 + strlen (optflag_get_name(id)))
106 #else /* !HAVE_ARRAY_ELEM_INIT */
112 #define OPTFLAG(id,shift,name,desc) {name,desc},
115 #include "optflags-def.h"
118 #define optflag_get_name(id) (opt_names [(id)].name)
119 #define optflag_get_desc(id) (opt_names [(id)].desc)
124 opt_funcs [sizeof (int) * 8] = {
128 #ifdef __native_client__
129 extern char *nacl_mono_path;
132 #define DEFAULT_OPTIMIZATIONS ( \
133 MONO_OPT_PEEPHOLE | \
136 MONO_OPT_CONSPROP | \
137 MONO_OPT_COPYPROP | \
143 MONO_OPT_EXCEPTION | \
147 MONO_OPT_ALIAS_ANALYSIS | \
150 #define EXCLUDED_FROM_ALL (MONO_OPT_SHARED | MONO_OPT_PRECOMP | MONO_OPT_UNSAFE | MONO_OPT_GSHAREDVT | MONO_OPT_FLOAT32)
153 parse_optimizations (guint32 opt, const char* p, gboolean cpu_opts)
159 /* Initialize the hwcap module if necessary. */
162 /* call out to cpu detection code here that sets the defaults ... */
164 opt |= mono_arch_cpu_optimizations (&exclude);
177 for (i = 0; i < G_N_ELEMENTS (opt_names) && optflag_get_name (i); ++i) {
178 n = optflag_get_name (i);
180 if (strncmp (p, n, len) == 0) {
189 } else if (*p == '=') {
193 while (*p && *p++ != ',');
200 if (i == G_N_ELEMENTS (opt_names) || !optflag_get_name (i)) {
201 if (strncmp (p, "all", 3) == 0) {
205 opt = ~(EXCLUDED_FROM_ALL | exclude);
210 fprintf (stderr, "Invalid optimization name `%s'\n", p);
219 parse_debug_options (const char* p)
221 MonoDebugOptions *opt = mini_get_debug_options ();
225 fprintf (stderr, "Syntax error; expected debug option name\n");
229 if (!strncmp (p, "casts", 5)) {
230 opt->better_cast_details = TRUE;
232 } else if (!strncmp (p, "mdb-optimizations", 17)) {
233 opt->mdb_optimizations = TRUE;
235 } else if (!strncmp (p, "gdb", 3)) {
239 fprintf (stderr, "Invalid debug option `%s', use --help-debug for details\n", p);
246 fprintf (stderr, "Syntax error; expected debug option name\n");
257 const char desc [18];
258 MonoGraphOptions value;
261 static const GraphName
263 {"cfg", "Control Flow", MONO_GRAPH_CFG},
264 {"dtree", "Dominator Tree", MONO_GRAPH_DTREE},
265 {"code", "CFG showing code", MONO_GRAPH_CFG_CODE},
266 {"ssa", "CFG after SSA", MONO_GRAPH_CFG_SSA},
267 {"optc", "CFG after IR opts", MONO_GRAPH_CFG_OPTCODE}
270 static MonoGraphOptions
271 mono_parse_graph_options (const char* p)
276 for (i = 0; i < G_N_ELEMENTS (graph_names); ++i) {
277 n = graph_names [i].name;
279 if (strncmp (p, n, len) == 0)
280 return graph_names [i].value;
283 fprintf (stderr, "Invalid graph name provided: %s\n", p);
288 mono_parse_default_optimizations (const char* p)
292 opt = parse_optimizations (DEFAULT_OPTIMIZATIONS, p, TRUE);
297 mono_opt_descr (guint32 flags) {
298 GString *str = g_string_new ("");
302 for (i = 0; i < G_N_ELEMENTS (opt_names); ++i) {
303 if (flags & (1 << i) && optflag_get_name (i)) {
305 g_string_append_c (str, ',');
306 g_string_append (str, optflag_get_name (i));
310 return g_string_free (str, FALSE);
320 MONO_OPT_ALIAS_ANALYSIS,
321 #ifdef MONO_ARCH_SIMD_INTRINSICS
324 MONO_OPT_SIMD | MONO_OPT_SSE2,
326 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_INTRINS,
327 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_INTRINS | MONO_OPT_ALIAS_ANALYSIS,
328 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS,
329 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP,
330 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_CFOLD,
331 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE,
332 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_ALIAS_ANALYSIS,
333 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS,
334 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_TAILC,
335 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_SSA,
336 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_EXCEPTION,
337 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_EXCEPTION | MONO_OPT_CMOV,
338 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_EXCEPTION | MONO_OPT_ABCREM,
339 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_ABCREM,
340 MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_LOOP | MONO_OPT_INLINE | MONO_OPT_INTRINS | MONO_OPT_ABCREM | MONO_OPT_SHARED,
341 DEFAULT_OPTIMIZATIONS,
344 typedef int (*TestMethod) (void);
348 domain_dump_native_code (MonoDomain *domain) {
349 // need to poke into the domain, move to metadata/domain.c
350 // need to empty jit_info_table and code_mp
355 mini_regression_step (MonoImage *image, int verbose, int *total_run, int *total,
357 GTimer *timer, MonoDomain *domain)
359 int result, expected, failed, cfailed, run, code_size;
361 double elapsed, comp_time, start_time;
365 mono_set_defaults (verbose, opt_flags);
366 n = mono_opt_descr (opt_flags);
367 g_print ("Test run: image=%s, opts=%s\n", mono_image_get_filename (image), n);
369 cfailed = failed = run = code_size = 0;
370 comp_time = elapsed = 0.0;
372 /* fixme: ugly hack - delete all previously compiled methods */
373 if (domain_jit_info (domain)) {
374 g_hash_table_destroy (domain_jit_info (domain)->jit_trampoline_hash);
375 domain_jit_info (domain)->jit_trampoline_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
376 mono_internal_hash_table_destroy (&(domain->jit_code_hash));
377 mono_jit_code_hash_init (&(domain->jit_code_hash));
380 g_timer_start (timer);
382 fprintf (mini_stats_fd, "[");
383 for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
385 MonoMethod *method = mono_get_method_checked (image, MONO_TOKEN_METHOD_DEF | (i + 1), NULL, NULL, &error);
387 mono_error_cleanup (&error); /* FIXME don't swallow the error */
390 if (strncmp (method->name, "test_", 5) == 0) {
393 expected = atoi (method->name + 5);
395 start_time = g_timer_elapsed (timer, NULL);
396 comp_time -= start_time;
397 cfg = mini_method_compile (method, mono_get_optimizations_for_method (method, opt_flags), mono_get_root_domain (), JIT_FLAG_RUN_CCTORS, 0, -1);
398 comp_time += g_timer_elapsed (timer, NULL);
399 if (cfg->exception_type == MONO_EXCEPTION_NONE) {
401 g_print ("Running '%s' ...\n", method->name);
402 #ifdef MONO_USE_AOT_COMPILER
404 func = (TestMethod)mono_aot_get_method_checked (mono_get_root_domain (), method, &error);
405 mono_error_cleanup (&error);
407 func = (TestMethod)(gpointer)cfg->native_code;
409 func = (TestMethod)(gpointer)cfg->native_code;
411 func = (TestMethod)mono_create_ftnptr (mono_get_root_domain (), func);
413 if (result != expected) {
415 g_print ("Test '%s' failed result (got %d, expected %d).\n", method->name, result, expected);
417 code_size += cfg->code_len;
418 mono_destroy_compile (cfg);
422 g_print ("Test '%s' failed compilation.\n", method->name);
425 fprintf (mini_stats_fd, "%f, ",
426 g_timer_elapsed (timer, NULL) - start_time);
430 fprintf (mini_stats_fd, "],\n");
431 g_timer_stop (timer);
432 elapsed = g_timer_elapsed (timer, NULL);
433 if (failed > 0 || cfailed > 0){
434 g_print ("Results: total tests: %d, failed: %d, cfailed: %d (pass: %.2f%%)\n",
435 run, failed, cfailed, 100.0*(run-failed-cfailed)/run);
437 g_print ("Results: total tests: %d, all pass \n", run);
440 g_print ("Elapsed time: %f secs (%f, %f), Code size: %d\n\n", elapsed,
441 elapsed - comp_time, comp_time, code_size);
442 *total += failed + cfailed;
447 mini_regression (MonoImage *image, int verbose, int *total_run)
452 GTimer *timer = g_timer_new ();
453 MonoDomain *domain = mono_domain_get ();
457 /* Note: mono_hwcap_init () called in mono_init () before we get here. */
458 mono_arch_cpu_optimizations (&exclude);
461 fprintf (mini_stats_fd, "$stattitle = \'Mono Benchmark Results (various optimizations)\';\n");
463 fprintf (mini_stats_fd, "$graph->set_legend(qw(");
464 for (opt = 0; opt < G_N_ELEMENTS (opt_sets); opt++) {
465 guint32 opt_flags = opt_sets [opt];
466 n = mono_opt_descr (opt_flags);
470 fprintf (mini_stats_fd, " ");
471 fprintf (mini_stats_fd, "%s", n);
475 fprintf (mini_stats_fd, "));\n");
477 fprintf (mini_stats_fd, "@data = (\n");
478 fprintf (mini_stats_fd, "[");
481 /* load the metadata */
482 for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
484 method = mono_get_method_checked (image, MONO_TOKEN_METHOD_DEF | (i + 1), NULL, NULL, &error);
486 mono_error_cleanup (&error);
489 mono_class_init (method->klass);
491 if (!strncmp (method->name, "test_", 5) && mini_stats_fd) {
492 fprintf (mini_stats_fd, "\"%s\",", method->name);
496 fprintf (mini_stats_fd, "],\n");
501 if (mono_do_single_method_regression) {
504 mini_regression_step (image, verbose, total_run, &total,
509 g_print ("Single method regression: %d methods\n", g_slist_length (mono_single_method_list));
511 for (iter = mono_single_method_list; iter; iter = g_slist_next (iter)) {
514 mono_current_single_method = (MonoMethod *)iter->data;
516 method_name = mono_method_full_name (mono_current_single_method, TRUE);
517 g_print ("Current single method: %s\n", method_name);
518 g_free (method_name);
520 mini_regression_step (image, verbose, total_run, &total,
527 for (opt = 0; opt < G_N_ELEMENTS (opt_sets); ++opt) {
528 mini_regression_step (image, verbose, total_run, &total,
529 opt_sets [opt] & ~exclude,
535 fprintf (mini_stats_fd, ");\n");
536 fflush (mini_stats_fd);
539 g_timer_destroy (timer);
544 mini_regression_list (int verbose, int count, char *images [])
546 int i, total, total_run, run;
549 total_run = total = 0;
550 for (i = 0; i < count; ++i) {
551 ass = mono_assembly_open (images [i], NULL);
553 g_warning ("failed to load assembly: %s", images [i]);
556 total += mini_regression (mono_assembly_get_image (ass), verbose, &run);
560 g_print ("Overall results: tests: %d, failed: %d, opt combinations: %d (pass: %.2f%%)\n",
561 total_run, total, (int)G_N_ELEMENTS (opt_sets), 100.0*(total_run-total)/total_run);
563 g_print ("Overall results: tests: %d, 100%% pass, opt combinations: %d\n",
564 total_run, (int)G_N_ELEMENTS (opt_sets));
570 #ifdef MONO_JIT_INFO_TABLE_TEST
571 typedef struct _JitInfoData
576 struct _JitInfoData *next;
596 static int num_threads;
597 static ThreadData *thread_datas;
598 static MonoDomain *test_domain;
601 alloc_random_data (Region *region)
614 data = ®ion->data;
615 pos = random () % (region->num_datas + 1);
617 while (*data != NULL) {
621 data = &(*data)->next;
625 g_assert (*data == region->data);
627 g_assert (prev->next == *data);
630 prev_end = region->start;
632 prev_end = prev->start + prev->length;
635 next_start = region->start + region->length;
637 next_start = (*data)->start;
639 g_assert (prev_end <= next_start);
641 max_len = next_start - prev_end;
643 if (++num_retries >= 10)
650 d = g_new0 (JitInfoData, 1);
651 d->start = prev_end + random () % (max_len / 2);
652 d->length = random () % MIN (max_len, next_start - d->start) + 1;
654 g_assert (d->start >= prev_end && d->start + d->length <= next_start);
656 d->ji = g_new0 (MonoJitInfo, 1);
657 d->ji->d.method = (MonoMethod*) 0xABadBabe;
658 d->ji->code_start = (gpointer)(gulong) d->start;
659 d->ji->code_size = d->length;
660 d->ji->cas_inited = 1; /* marks an allocated jit info */
671 choose_random_data (Region *region)
677 g_assert (region->num_datas > 0);
679 n = random () % region->num_datas;
681 for (d = ®ion->data, i = 0;
683 d = &(*d)->next, ++i)
690 choose_random_region (ThreadData *td)
692 return &td->regions [random () % td->num_regions];
696 choose_random_thread (void)
698 return &thread_datas [random () % num_threads];
702 free_jit_info_data (ThreadData *td, JitInfoData *free)
704 free->next = td->frees;
707 if (++td->num_frees >= 1000) {
710 for (i = 0; i < 500; ++i)
713 while (free->next != NULL) {
714 JitInfoData *next = free->next->next;
716 //g_free (free->next->ji);
725 #define NUM_THREADS 8
726 #define REGIONS_PER_THREAD 10
727 #define REGION_SIZE 0x10000
729 #define MAX_ADDR (REGION_SIZE * REGIONS_PER_THREAD * NUM_THREADS)
735 test_thread_func (ThreadData *td)
737 int mode = MODE_ALLOC;
739 gulong lookup_successes = 0, lookup_failures = 0;
740 MonoDomain *domain = test_domain;
741 int thread_num = (int)(td - thread_datas);
742 gboolean modify_thread = thread_num < NUM_THREADS / 2; /* only half of the threads modify the table */
748 if (td->num_datas == 0) {
751 } else if (modify_thread && random () % 1000 < 5) {
753 if (mode == MODE_ALLOC)
754 alloc = (random () % 100) < 70;
755 else if (mode == MODE_FREE)
756 alloc = (random () % 100) < 30;
760 /* modify threads sometimes look up their own jit infos */
761 if (modify_thread && random () % 10 < 5) {
762 Region *region = choose_random_region (td);
764 if (region->num_datas > 0) {
765 JitInfoData **data = choose_random_data (region);
766 guint pos = (*data)->start + random () % (*data)->length;
769 ji = mono_jit_info_table_find (domain, (char*)(gulong) pos);
771 g_assert (ji->cas_inited);
772 g_assert ((*data)->ji == ji);
775 int pos = random () % MAX_ADDR;
776 char *addr = (char*)(gulong) pos;
779 ji = mono_jit_info_table_find (domain, addr);
782 * FIXME: We are actually not allowed
783 * to do this. By the time we examine
784 * the ji another thread might already
788 g_assert (addr >= (char*)ji->code_start && addr < (char*)ji->code_start + ji->code_size);
794 JitInfoData *data = alloc_random_data (choose_random_region (td));
797 mono_jit_info_table_add (domain, data->ji);
802 Region *region = choose_random_region (td);
804 if (region->num_datas > 0) {
805 JitInfoData **data = choose_random_data (region);
808 mono_jit_info_table_remove (domain, (*data)->ji);
810 //(*data)->ji->cas_inited = 0; /* marks a free jit info */
813 *data = (*data)->next;
815 free_jit_info_data (td, free);
822 if (++i % 100000 == 0) {
824 g_print ("num datas %d (%ld - %ld): %d", (int)(td - thread_datas),
825 lookup_successes, lookup_failures, td->num_datas);
826 for (j = 0; j < td->num_regions; ++j)
827 g_print (" %d", td->regions [j].num_datas);
831 if (td->num_datas < 100)
833 else if (td->num_datas > 2000)
840 small_id_thread_func (gpointer arg)
842 MonoThread *thread = mono_thread_current ();
843 MonoThreadHazardPointers *hp = mono_hazard_pointer_get ();
845 g_print ("my small id is %d\n", (int)thread->small_id);
846 mono_hazard_pointer_clear (hp, 1);
848 g_print ("done %d\n", (int)thread->small_id);
853 jit_info_table_test (MonoDomain *domain)
858 g_print ("testing jit_info_table\n");
860 num_threads = NUM_THREADS;
861 thread_datas = g_new0 (ThreadData, num_threads);
863 for (i = 0; i < num_threads; ++i) {
866 thread_datas [i].num_regions = REGIONS_PER_THREAD;
867 thread_datas [i].regions = g_new0 (Region, REGIONS_PER_THREAD);
869 for (j = 0; j < REGIONS_PER_THREAD; ++j) {
870 thread_datas [i].regions [j].start = (num_threads * j + i) * REGION_SIZE;
871 thread_datas [i].regions [j].length = REGION_SIZE;
875 test_domain = domain;
878 for (i = 0; i < 72; ++i)
879 mono_thread_create (domain, small_id_thread_func, NULL);
884 for (i = 0; i < num_threads; ++i) {
885 mono_thread_create_checked (domain, test_thread_func, &thread_datas [i], &error);
886 mono_error_assert_ok (&error);
894 DO_SINGLE_METHOD_REGRESSION,
901 typedef struct CompileAllThreadArgs {
905 guint32 recompilation_times;
906 } CompileAllThreadArgs;
909 compile_all_methods_thread_main_inner (CompileAllThreadArgs *args)
911 MonoAssembly *ass = args->ass;
912 int verbose = args->verbose;
913 MonoImage *image = mono_assembly_get_image (ass);
916 int i, count = 0, fail_count = 0;
918 for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
920 guint32 token = MONO_TOKEN_METHOD_DEF | (i + 1);
921 MonoMethodSignature *sig;
923 if (mono_metadata_has_generic_params (image, token))
926 method = mono_get_method_checked (image, token, NULL, NULL, &error);
928 mono_error_cleanup (&error); /* FIXME don't swallow the error */
931 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
932 (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL) ||
933 (method->iflags & METHOD_IMPL_ATTRIBUTE_RUNTIME) ||
934 (method->flags & METHOD_ATTRIBUTE_ABSTRACT))
937 if (mono_class_is_gtd (method->klass))
939 sig = mono_method_signature (method);
941 char * desc = mono_method_full_name (method, TRUE);
942 g_print ("Could not retrieve method signature for %s\n", desc);
948 if (sig->has_type_parameters)
953 char * desc = mono_method_full_name (method, TRUE);
954 g_print ("Compiling %d %s\n", count, desc);
957 cfg = mini_method_compile (method, mono_get_optimizations_for_method (method, args->opts), mono_get_root_domain (), (JitFlags)JIT_FLAG_DISCARD_RESULTS, 0, -1);
958 if (cfg->exception_type != MONO_EXCEPTION_NONE) {
959 printf ("Compilation of %s failed with exception '%s':\n", mono_method_full_name (cfg->method, TRUE), cfg->exception_message);
962 mono_destroy_compile (cfg);
970 compile_all_methods_thread_main (CompileAllThreadArgs *args)
973 for (i = 0; i < args->recompilation_times; ++i)
974 compile_all_methods_thread_main_inner (args);
978 compile_all_methods (MonoAssembly *ass, int verbose, guint32 opts, guint32 recompilation_times)
981 CompileAllThreadArgs args;
984 args.verbose = verbose;
986 args.recompilation_times = recompilation_times;
989 * Need to create a mono thread since compilation might trigger
990 * running of managed code.
992 mono_thread_create_checked (mono_domain_get (), compile_all_methods_thread_main, &args, &error);
993 mono_error_assert_ok (&error);
995 mono_thread_manage ();
1000 * @assembly: reference to an assembly
1001 * @argc: argument count
1002 * @argv: argument vector
1004 * Start execution of a program.
1007 mono_jit_exec (MonoDomain *domain, MonoAssembly *assembly, int argc, char *argv[])
1010 MonoImage *image = mono_assembly_get_image (assembly);
1012 guint32 entry = mono_image_get_entry_point (image);
1015 g_print ("Assembly '%s' doesn't have an entry point.\n", mono_image_get_filename (image));
1016 /* FIXME: remove this silly requirement. */
1017 mono_environment_exitcode_set (1);
1021 method = mono_get_method_checked (image, entry, NULL, NULL, &error);
1022 if (method == NULL){
1023 g_print ("The entry point method could not be loaded due to %s\n", mono_error_get_message (&error));
1024 mono_error_cleanup (&error);
1025 mono_environment_exitcode_set (1);
1029 if (mono_llvm_only) {
1030 MonoObject *exc = NULL;
1033 res = mono_runtime_try_run_main (method, argc, argv, &exc);
1035 mono_unhandled_exception (exc);
1036 mono_invoke_unhandled_exception_hook (exc);
1037 g_assert_not_reached ();
1041 int res = mono_runtime_run_main_checked (method, argc, argv, &error);
1042 if (!is_ok (&error)) {
1043 MonoException *ex = mono_error_convert_to_exception (&error);
1045 mono_unhandled_exception (&ex->object);
1046 mono_invoke_unhandled_exception_hook (&ex->object);
1047 g_assert_not_reached ();
1064 static void main_thread_handler (gpointer user_data)
1066 MainThreadArgs *main_args = (MainThreadArgs *)user_data;
1067 MonoAssembly *assembly;
1069 if (mono_compile_aot) {
1072 /* Treat the other arguments as assemblies to compile too */
1073 for (i = 0; i < main_args->argc; ++i) {
1074 assembly = mono_domain_assembly_open (main_args->domain, main_args->argv [i]);
1076 fprintf (stderr, "Can not open image %s\n", main_args->argv [i]);
1079 /* Check that the assembly loaded matches the filename */
1081 MonoImageOpenStatus status;
1084 img = mono_image_open (main_args->argv [i], &status);
1085 if (img && strcmp (img->name, assembly->image->name)) {
1086 fprintf (stderr, "Error: Loaded assembly '%s' doesn't match original file name '%s'. Set MONO_PATH to the assembly's location.\n", assembly->image->name, img->name);
1090 res = mono_compile_assembly (assembly, main_args->opts, main_args->aot_options);
1092 fprintf (stderr, "AOT of image %s failed.\n", main_args->argv [i]);
1097 assembly = mono_domain_assembly_open (main_args->domain, main_args->file);
1099 fprintf (stderr, "Can not open image %s\n", main_args->file);
1104 * This must be done in a thread managed by mono since it can invoke
1107 if (main_args->opts & MONO_OPT_PRECOMP)
1108 mono_precompile_assemblies ();
1110 mono_jit_exec (main_args->domain, assembly, main_args->argc, main_args->argv);
1115 load_agent (MonoDomain *domain, char *desc)
1118 char* col = strchr (desc, ':');
1120 MonoAssembly *agent_assembly;
1124 MonoArray *main_args;
1126 MonoImageOpenStatus open_status;
1129 agent = (char *)g_memdup (desc, col - desc + 1);
1130 agent [col - desc] = '\0';
1133 agent = g_strdup (desc);
1137 agent_assembly = mono_assembly_open (agent, &open_status);
1138 if (!agent_assembly) {
1139 fprintf (stderr, "Cannot open agent assembly '%s': %s.\n", agent, mono_image_strerror (open_status));
1145 * Can't use mono_jit_exec (), as it sets things which might confuse the
1148 image = mono_assembly_get_image (agent_assembly);
1149 entry = mono_image_get_entry_point (image);
1151 g_print ("Assembly '%s' doesn't have an entry point.\n", mono_image_get_filename (image));
1156 method = mono_get_method_checked (image, entry, NULL, NULL, &error);
1157 if (method == NULL){
1158 g_print ("The entry point method of assembly '%s' could not be loaded due to %s\n", agent, mono_error_get_message (&error));
1159 mono_error_cleanup (&error);
1164 mono_thread_set_main (mono_thread_current ());
1167 main_args = (MonoArray*)mono_array_new_checked (domain, mono_defaults.string_class, 1, &error);
1169 mono_array_set (main_args, MonoString*, 0, mono_string_new (domain, args));
1171 main_args = (MonoArray*)mono_array_new_checked (domain, mono_defaults.string_class, 0, &error);
1174 g_print ("Could not allocate array for main args of assembly '%s' due to %s\n", agent, mono_error_get_message (&error));
1175 mono_error_cleanup (&error);
1182 /* Pass NULL as 'exc' so unhandled exceptions abort the runtime */
1183 mono_runtime_invoke_checked (method, NULL, pa, &error);
1184 if (!is_ok (&error)) {
1185 g_print ("The entry point method of assembly '%s' could not execute due to %s\n", agent, mono_error_get_message (&error));
1186 mono_error_cleanup (&error);
1196 mini_usage_jitdeveloper (void)
1201 "Runtime and JIT debugging options:\n"
1202 " --breakonex Inserts a breakpoint on exceptions\n"
1203 " --break METHOD Inserts a breakpoint at METHOD entry\n"
1204 " --break-at-bb METHOD N Inserts a breakpoint in METHOD at BB N\n"
1205 " --compile METHOD Just compile METHOD in assembly\n"
1206 " --compile-all=N Compiles all the methods in the assembly multiple times (default: 1)\n"
1207 " --ncompile N Number of times to compile METHOD (default: 1)\n"
1208 " --print-vtable Print the vtable of all used classes\n"
1209 " --regression Runs the regression test contained in the assembly\n"
1210 " --single-method=OPTS Runs regressions with only one method optimized with OPTS at any time\n"
1211 " --statfile FILE Sets the stat file to FILE\n"
1212 " --stats Print statistics about the JIT operations\n"
1213 " --wapi=hps|semdel|seminfo IO-layer maintenance\n"
1214 " --inject-async-exc METHOD OFFSET Inject an asynchronous exception at METHOD\n"
1215 " --verify-all Run the verifier on all assemblies and methods\n"
1216 " --full-aot Avoid JITting any code\n"
1217 " --llvmonly Use LLVM compiled code only\n"
1218 " --agent=ASSEMBLY[:ARG] Loads the specific agent assembly and executes its Main method with the given argument before loading the main assembly.\n"
1219 " --no-x86-stack-align Don't align stack on x86\n"
1221 "The options supported by MONO_DEBUG can also be passed on the command line.\n"
1224 " --graph[=TYPE] METHOD Draws a graph of the specified method:\n");
1226 for (i = 0; i < G_N_ELEMENTS (graph_names); ++i) {
1227 fprintf (stdout, " %-10s %s\n", graph_names [i].name, graph_names [i].desc);
1232 mini_usage_list_opt (void)
1236 for (i = 0; i < G_N_ELEMENTS (opt_names); ++i)
1237 fprintf (stdout, " %-10s %s\n", optflag_get_name (i), optflag_get_desc (i));
1244 "Usage is: mono [options] program [program-options]\n"
1247 " --aot[=<options>] Compiles the assembly to native code\n"
1248 " --debug[=<options>] Enable debugging support, use --help-debug for details\n"
1249 " --debugger-agent=options Enable the debugger agent\n"
1250 " --profile[=profiler] Runs in profiling mode with the specified profiler module\n"
1251 " --trace[=EXPR] Enable tracing, use --help-trace for details\n"
1252 " --jitmap Output a jit method map to /tmp/perf-PID.map\n"
1253 " --help-devel Shows more options available to developers\n"
1256 " --config FILE Loads FILE as the Mono config\n"
1257 " --verbose, -v Increases the verbosity level\n"
1258 " --help, -h Show usage information\n"
1259 " --version, -V Show version information\n"
1260 " --runtime=VERSION Use the VERSION runtime, instead of autodetecting\n"
1261 " --optimize=OPT Turns on or off a specific optimization\n"
1262 " Use --list-opt to get a list of optimizations\n"
1263 #ifndef DISABLE_SECURITY
1264 " --security[=mode] Turns on the unsupported security manager (off by default)\n"
1265 " mode is one of cas, core-clr, verifiable or validil\n"
1267 " --attach=OPTIONS Pass OPTIONS to the attach agent in the runtime.\n"
1268 " Currently the only supported option is 'disable'.\n"
1269 " --llvm, --nollvm Controls whenever the runtime uses LLVM to compile code.\n"
1270 " --gc=[sgen,boehm] Select SGen or Boehm GC (runs mono or mono-sgen)\n"
1272 " --arch=[32,64] Select architecture (runs mono32 or mono64)\n"
1275 " --mixed-mode Enable mixed-mode image support.\n"
1277 " --handlers Install custom handlers, use --help-handlers for details.\n"
1278 " --aot-path=PATH List of additional directories to search for AOT images.\n"
1283 mini_trace_usage (void)
1286 "Tracing options:\n"
1287 " --trace[=EXPR] Trace every call, optional EXPR controls the scope\n"
1289 "EXPR is composed of:\n"
1290 " all All assemblies\n"
1291 " none No assemblies\n"
1292 " program Entry point assembly\n"
1293 " assembly Specifies an assembly\n"
1294 " wrapper All wrappers bridging native and managed code\n"
1295 " M:Type:Method Specifies a method\n"
1296 " N:Namespace Specifies a namespace\n"
1297 " T:Type Specifies a type\n"
1298 " E:Type Specifies stack traces for an exception type\n"
1299 " EXPR Includes expression\n"
1300 " -EXPR Excludes expression\n"
1301 " EXPR,EXPR Multiple expressions\n"
1302 " disabled Don't print any output until toggled via SIGUSR2\n");
1306 mini_debug_usage (void)
1309 "Debugging options:\n"
1310 " --debug[=OPTIONS] Enable debugging support, optional OPTIONS is a comma\n"
1311 " separated list of options\n"
1313 "OPTIONS is composed of:\n"
1314 " casts Enable more detailed InvalidCastException messages.\n"
1315 " mdb-optimizations Disable some JIT optimizations which are normally\n"
1316 " disabled when running inside the debugger.\n"
1317 " This is useful if you plan to attach to the running\n"
1318 " process with the debugger.\n");
1321 #if defined(MONO_ARCH_ARCHITECTURE)
1322 /* Redefine MONO_ARCHITECTURE to include more information */
1323 #undef MONO_ARCHITECTURE
1324 #define MONO_ARCHITECTURE MONO_ARCH_ARCHITECTURE
1327 static const char info[] =
1328 #ifdef HAVE_KW_THREAD
1332 #endif /* HAVE_KW_THREAD */
1333 #ifdef MONO_ARCH_SIGSEGV_ON_ALTSTACK
1334 "\tSIGSEGV: altstack\n"
1336 "\tSIGSEGV: normal\n"
1339 "\tNotifications: epoll\n"
1340 #elif defined(HAVE_KQUEUE)
1341 "\tNotification: kqueue\n"
1343 "\tNotification: Thread + polling\n"
1345 "\tArchitecture: " MONO_ARCHITECTURE "\n"
1346 "\tDisabled: " DISABLED_FEATURES "\n"
1348 #ifdef MONO_SMALL_CONFIG
1351 #ifdef MONO_BIG_ARRAYS
1354 #if defined(MONO_ARCH_SOFT_DEBUG_SUPPORTED) && !defined(DISABLE_SOFT_DEBUG)
1358 #ifdef MONO_ARCH_LLVM_SUPPORTED
1360 "\tLLVM: yes(" LLVM_VERSION ")\n"
1362 "\tLLVM: supported, not enabled.\n"
1367 #ifndef MONO_ARCH_AOT_SUPPORTED
1368 #define error_if_aot_unsupported() do {fprintf (stderr, "AOT compilation is not supported on this platform.\n"); exit (1);} while (0)
1370 #define error_if_aot_unsupported()
1373 static gboolean enable_debugging;
1376 * mono_jit_parse_options:
1378 * Process the command line options in ARGV as done by the runtime executable.
1379 * This should be called before mono_jit_init ().
1382 mono_jit_parse_options (int argc, char * argv[])
1385 char *trace_options = NULL;
1386 int mini_verbose = 0;
1390 * Some options have no effect here, since they influence the behavior of
1394 opt = mono_parse_default_optimizations (NULL);
1396 /* FIXME: Avoid code duplication */
1397 for (i = 0; i < argc; ++i) {
1398 if (argv [i] [0] != '-')
1400 if (strncmp (argv [i], "--debugger-agent=", 17) == 0) {
1401 MonoDebugOptions *opt = mini_get_debug_options ();
1403 mono_debugger_agent_parse_options (argv [i] + 17);
1404 opt->mdb_optimizations = TRUE;
1405 enable_debugging = TRUE;
1406 } else if (!strcmp (argv [i], "--soft-breakpoints")) {
1407 MonoDebugOptions *opt = mini_get_debug_options ();
1409 opt->soft_breakpoints = TRUE;
1410 opt->explicit_null_checks = TRUE;
1411 } else if (strncmp (argv [i], "--optimize=", 11) == 0) {
1412 opt = parse_optimizations (opt, argv [i] + 11, TRUE);
1413 mono_set_optimizations (opt);
1414 } else if (strncmp (argv [i], "-O=", 3) == 0) {
1415 opt = parse_optimizations (opt, argv [i] + 3, TRUE);
1416 mono_set_optimizations (opt);
1417 } else if (strcmp (argv [i], "--trace") == 0) {
1418 trace_options = (char*)"";
1419 } else if (strncmp (argv [i], "--trace=", 8) == 0) {
1420 trace_options = &argv [i][8];
1421 } else if (strcmp (argv [i], "--verbose") == 0 || strcmp (argv [i], "-v") == 0) {
1423 } else if (strcmp (argv [i], "--breakonex") == 0) {
1424 MonoDebugOptions *opt = mini_get_debug_options ();
1426 opt->break_on_exc = TRUE;
1427 } else if (strcmp (argv [i], "--stats") == 0) {
1428 mono_counters_enable (-1);
1429 mono_stats.enabled = TRUE;
1430 mono_jit_stats.enabled = TRUE;
1431 } else if (strcmp (argv [i], "--break") == 0) {
1433 fprintf (stderr, "Missing method name in --break command line option\n");
1437 if (!mono_debugger_insert_breakpoint (argv [++i], FALSE))
1438 fprintf (stderr, "Error: invalid method name '%s'\n", argv [i]);
1439 } else if (strncmp (argv[i], "--gc-params=", 12) == 0) {
1440 mono_gc_params_set (argv[i] + 12);
1441 } else if (strncmp (argv[i], "--gc-debug=", 11) == 0) {
1442 mono_gc_debug_set (argv[i] + 11);
1443 } else if (strcmp (argv [i], "--llvm") == 0) {
1444 #ifndef MONO_ARCH_LLVM_SUPPORTED
1445 fprintf (stderr, "Mono Warning: --llvm not supported on this platform.\n");
1446 #elif !defined(ENABLE_LLVM)
1447 fprintf (stderr, "Mono Warning: --llvm not enabled in this runtime.\n");
1449 mono_use_llvm = TRUE;
1451 } else if (argv [i][0] == '-' && argv [i][1] == '-' && mini_parse_debug_option (argv [i] + 2)) {
1453 fprintf (stderr, "Unsupported command line option: '%s'\n", argv [i]);
1458 if (trace_options != NULL) {
1460 * Need to call this before mini_init () so we can trace methods
1461 * compiled there too.
1463 mono_jit_trace_calls = mono_trace_parse_options (trace_options);
1464 if (mono_jit_trace_calls == NULL)
1469 mono_set_verbose_level (mini_verbose);
1473 mono_set_use_smp (int use_smp)
1475 #if HAVE_SCHED_SETAFFINITY
1477 unsigned long proc_mask = 1;
1478 #ifdef GLIBC_BEFORE_2_3_4_SCHED_SETAFFINITY
1479 sched_setaffinity (getpid(), (gpointer)&proc_mask);
1481 sched_setaffinity (getpid(), sizeof (unsigned long), (const cpu_set_t *)&proc_mask);
1488 switch_gc (char* argv[], const char* target_gc)
1492 if (!strcmp (mono_gc_get_gc_name (), target_gc)) {
1496 path = g_string_new (argv [0]);
1498 /*Running mono without any argument*/
1499 if (strstr (argv [0], "-sgen"))
1500 g_string_truncate (path, path->len - 5);
1501 else if (strstr (argv [0], "-boehm"))
1502 g_string_truncate (path, path->len - 6);
1504 g_string_append_c (path, '-');
1505 g_string_append (path, target_gc);
1508 execvp (path->str, argv);
1509 fprintf (stderr, "Error: Failed to switch to %s gc. mono-%s is not installed.\n", target_gc, target_gc);
1511 fprintf (stderr, "Error: --gc=<NAME> option not supported on this platform.\n");
1518 * tries to increase the minimum number of files, if the number is below 1024
1521 darwin_change_default_file_handles ()
1523 struct rlimit limit;
1525 if (getrlimit (RLIMIT_NOFILE, &limit) == 0){
1526 if (limit.rlim_cur < 1024){
1527 limit.rlim_cur = MAX(1024,limit.rlim_cur);
1528 setrlimit (RLIMIT_NOFILE, &limit);
1534 switch_arch (char* argv[], const char* target_arch)
1539 if ((strcmp (target_arch, "32") == 0 && strcmp (MONO_ARCHITECTURE, "x86") == 0) ||
1540 (strcmp (target_arch, "64") == 0 && strcmp (MONO_ARCHITECTURE, "amd64") == 0)) {
1541 return; /* matching arch loaded */
1544 path = g_string_new (argv [0]);
1545 arch_offset = path->len -2; /* last two characters */
1547 /* Remove arch suffix if present */
1548 if (strstr (&path->str[arch_offset], "32") || strstr (&path->str[arch_offset], "64")) {
1549 g_string_truncate (path, arch_offset);
1552 g_string_append (path, target_arch);
1554 if (execvp (path->str, argv) < 0) {
1555 fprintf (stderr, "Error: --arch=%s Failed to switch to '%s'.\n", target_arch, path->str);
1562 #define MONO_HANDLERS_ARGUMENT "--handlers="
1563 #define MONO_HANDLERS_ARGUMENT_LEN G_N_ELEMENTS(MONO_HANDLERS_ARGUMENT)-1
1567 * @argc: number of arguments in the argv array
1568 * @argv: array of strings containing the startup arguments
1570 * Launches the Mono JIT engine and parses all the command line options
1571 * in the same way that the mono command line VM would.
1574 mono_main (int argc, char* argv[])
1576 MainThreadArgs main_args;
1577 MonoAssembly *assembly;
1578 MonoMethodDesc *desc;
1582 MonoImageOpenStatus open_status;
1583 const char* aname, *mname = NULL;
1584 char *config_file = NULL;
1586 guint32 opt, action = DO_EXEC, recompilation_times = 1;
1587 MonoGraphOptions mono_graph_options = (MonoGraphOptions)0;
1588 int mini_verbose = 0;
1589 gboolean enable_profile = FALSE;
1590 char *trace_options = NULL;
1591 char *profile_options = NULL;
1592 char *aot_options = NULL;
1593 char *forced_version = NULL;
1594 GPtrArray *agents = NULL;
1595 char *attach_options = NULL;
1596 #ifdef MONO_JIT_INFO_TABLE_TEST
1597 int test_jit_info_table = FALSE;
1600 int mixed_mode = FALSE;
1602 #ifdef __native_client__
1603 gboolean nacl_null_checks_off = FALSE;
1608 /* stdout defaults to block buffering if it's not writing to a terminal, which
1609 * happens with our test harness: we redirect stdout to capture it. Force line
1610 * buffering in all cases. */
1611 setlinebuf (stdout);
1615 setlocale (LC_ALL, "");
1618 darwin_change_default_file_handles ();
1621 if (g_getenv ("MONO_NO_SMP"))
1622 mono_set_use_smp (FALSE);
1624 g_log_set_always_fatal (G_LOG_LEVEL_ERROR);
1625 g_log_set_fatal_mask (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR);
1627 opt = mono_parse_default_optimizations (NULL);
1629 for (i = 1; i < argc; ++i) {
1630 if (argv [i] [0] != '-')
1632 if (strcmp (argv [i], "--regression") == 0) {
1633 action = DO_REGRESSION;
1634 } else if (strncmp (argv [i], "--single-method=", 16) == 0) {
1635 char *full_opts = g_strdup_printf ("-all,%s", argv [i] + 16);
1636 action = DO_SINGLE_METHOD_REGRESSION;
1637 mono_single_method_regression_opt = parse_optimizations (opt, full_opts, TRUE);
1639 } else if (strcmp (argv [i], "--verbose") == 0 || strcmp (argv [i], "-v") == 0) {
1641 } else if (strcmp (argv [i], "--version") == 0 || strcmp (argv [i], "-V") == 0) {
1642 char *build = mono_get_runtime_build_info ();
1645 g_print ("Mono JIT compiler version %s\nCopyright (C) 2002-2014 Novell, Inc, Xamarin Inc and Contributors. www.mono-project.com\n", build);
1648 gc_descr = mono_gc_get_description ();
1649 g_print ("\tGC: %s\n", gc_descr);
1652 } else if (strcmp (argv [i], "--help") == 0 || strcmp (argv [i], "-h") == 0) {
1655 } else if (strcmp (argv [i], "--help-trace") == 0){
1656 mini_trace_usage ();
1658 } else if (strcmp (argv [i], "--help-devel") == 0){
1659 mini_usage_jitdeveloper ();
1661 } else if (strcmp (argv [i], "--help-debug") == 0){
1662 mini_debug_usage ();
1664 } else if (strcmp (argv [i], "--list-opt") == 0){
1665 mini_usage_list_opt ();
1667 } else if (strncmp (argv [i], "--statfile", 10) == 0) {
1669 fprintf (stderr, "error: --statfile requires a filename argument\n");
1672 mini_stats_fd = fopen (argv [++i], "w+");
1673 } else if (strncmp (argv [i], "--optimize=", 11) == 0) {
1674 opt = parse_optimizations (opt, argv [i] + 11, TRUE);
1675 } else if (strncmp (argv [i], "-O=", 3) == 0) {
1676 opt = parse_optimizations (opt, argv [i] + 3, TRUE);
1677 } else if (strncmp (argv [i], "--bisect=", 9) == 0) {
1678 char *param = argv [i] + 9;
1679 char *sep = strchr (param, ':');
1681 fprintf (stderr, "Error: --bisect requires OPT:FILENAME\n");
1684 char *opt_string = g_strndup (param, sep - param);
1685 guint32 opt = parse_optimizations (0, opt_string, FALSE);
1686 g_free (opt_string);
1687 mono_set_bisect_methods (opt, sep + 1);
1688 } else if (strcmp (argv [i], "--gc=sgen") == 0) {
1689 switch_gc (argv, "sgen");
1690 } else if (strcmp (argv [i], "--gc=boehm") == 0) {
1691 switch_gc (argv, "boehm");
1692 } else if (strncmp (argv[i], "--gc-params=", 12) == 0) {
1693 mono_gc_params_set (argv[i] + 12);
1694 } else if (strncmp (argv[i], "--gc-debug=", 11) == 0) {
1695 mono_gc_debug_set (argv[i] + 11);
1698 else if (strcmp (argv [i], "--arch=32") == 0) {
1699 switch_arch (argv, "32");
1700 } else if (strcmp (argv [i], "--arch=64") == 0) {
1701 switch_arch (argv, "64");
1704 else if (strcmp (argv [i], "--config") == 0) {
1706 fprintf (stderr, "error: --config requires a filename argument\n");
1709 config_file = argv [++i];
1711 } else if (strcmp (argv [i], "--mixed-mode") == 0) {
1714 } else if (strcmp (argv [i], "--ncompile") == 0) {
1716 fprintf (stderr, "error: --ncompile requires an argument\n");
1719 count = atoi (argv [++i]);
1721 } else if (strcmp (argv [i], "--trace") == 0) {
1722 trace_options = (char*)"";
1723 } else if (strncmp (argv [i], "--trace=", 8) == 0) {
1724 trace_options = &argv [i][8];
1725 } else if (strcmp (argv [i], "--breakonex") == 0) {
1726 MonoDebugOptions *opt = mini_get_debug_options ();
1728 opt->break_on_exc = TRUE;
1729 } else if (strcmp (argv [i], "--break") == 0) {
1731 fprintf (stderr, "Missing method name in --break command line option\n");
1735 if (!mono_debugger_insert_breakpoint (argv [++i], FALSE))
1736 fprintf (stderr, "Error: invalid method name '%s'\n", argv [i]);
1737 } else if (strcmp (argv [i], "--break-at-bb") == 0) {
1738 if (i + 2 >= argc) {
1739 fprintf (stderr, "Missing method name or bb num in --break-at-bb command line option.");
1742 mono_break_at_bb_method = mono_method_desc_new (argv [++i], TRUE);
1743 if (mono_break_at_bb_method == NULL) {
1744 fprintf (stderr, "Method name is in a bad format in --break-at-bb command line option.");
1747 mono_break_at_bb_bb_num = atoi (argv [++i]);
1748 } else if (strcmp (argv [i], "--inject-async-exc") == 0) {
1749 if (i + 2 >= argc) {
1750 fprintf (stderr, "Missing method name or position in --inject-async-exc command line option\n");
1753 mono_inject_async_exc_method = mono_method_desc_new (argv [++i], TRUE);
1754 if (mono_inject_async_exc_method == NULL) {
1755 fprintf (stderr, "Method name is in a bad format in --inject-async-exc command line option\n");
1758 mono_inject_async_exc_pos = atoi (argv [++i]);
1759 } else if (strcmp (argv [i], "--verify-all") == 0) {
1760 mono_verifier_enable_verify_all ();
1761 } else if (strcmp (argv [i], "--full-aot") == 0) {
1762 mono_jit_set_aot_mode (MONO_AOT_MODE_FULL);
1763 } else if (strcmp (argv [i], "--llvmonly") == 0) {
1764 mono_jit_set_aot_mode (MONO_AOT_MODE_LLVMONLY);
1765 } else if (strcmp (argv [i], "--hybrid-aot") == 0) {
1766 mono_jit_set_aot_mode (MONO_AOT_MODE_HYBRID);
1767 } else if (strcmp (argv [i], "--print-vtable") == 0) {
1768 mono_print_vtable = TRUE;
1769 } else if (strcmp (argv [i], "--stats") == 0) {
1770 mono_counters_enable (-1);
1771 mono_stats.enabled = TRUE;
1772 mono_jit_stats.enabled = TRUE;
1774 } else if (strcmp (argv [i], "--aot") == 0) {
1775 error_if_aot_unsupported ();
1776 mono_compile_aot = TRUE;
1777 } else if (strncmp (argv [i], "--aot=", 6) == 0) {
1778 error_if_aot_unsupported ();
1779 mono_compile_aot = TRUE;
1780 aot_options = &argv [i][6];
1782 } else if (strncmp (argv [i], "--aot-path=", 11) == 0) {
1785 splitted = g_strsplit (argv [i] + 11, G_SEARCHPATH_SEPARATOR_S, 1000);
1787 char *tmp = *splitted;
1788 mono_aot_paths = g_list_append (mono_aot_paths, g_strdup (tmp));
1792 } else if (strncmp (argv [i], "--compile-all=", 14) == 0) {
1793 action = DO_COMPILE;
1794 recompilation_times = atoi (argv [i] + 14);
1795 } else if (strcmp (argv [i], "--compile-all") == 0) {
1796 action = DO_COMPILE;
1797 } else if (strncmp (argv [i], "--runtime=", 10) == 0) {
1798 forced_version = &argv [i][10];
1799 } else if (strcmp (argv [i], "--jitmap") == 0) {
1800 mono_enable_jit_map ();
1801 } else if (strcmp (argv [i], "--profile") == 0) {
1802 enable_profile = TRUE;
1803 profile_options = NULL;
1804 } else if (strncmp (argv [i], "--profile=", 10) == 0) {
1805 enable_profile = TRUE;
1806 profile_options = argv [i] + 10;
1807 } else if (strncmp (argv [i], "--agent=", 8) == 0) {
1809 agents = g_ptr_array_new ();
1810 g_ptr_array_add (agents, argv [i] + 8);
1811 } else if (strncmp (argv [i], "--attach=", 9) == 0) {
1812 attach_options = argv [i] + 9;
1813 } else if (strcmp (argv [i], "--compile") == 0) {
1815 fprintf (stderr, "error: --compile option requires a method name argument\n");
1821 } else if (strncmp (argv [i], "--graph=", 8) == 0) {
1823 fprintf (stderr, "error: --graph option requires a method name argument\n");
1827 mono_graph_options = mono_parse_graph_options (argv [i] + 8);
1830 } else if (strcmp (argv [i], "--graph") == 0) {
1832 fprintf (stderr, "error: --graph option requires a method name argument\n");
1837 mono_graph_options = MONO_GRAPH_CFG;
1839 } else if (strcmp (argv [i], "--debug") == 0) {
1840 enable_debugging = TRUE;
1841 } else if (strncmp (argv [i], "--debug=", 8) == 0) {
1842 enable_debugging = TRUE;
1843 if (!parse_debug_options (argv [i] + 8))
1845 } else if (strncmp (argv [i], "--debugger-agent=", 17) == 0) {
1846 MonoDebugOptions *opt = mini_get_debug_options ();
1848 mono_debugger_agent_parse_options (argv [i] + 17);
1849 opt->mdb_optimizations = TRUE;
1850 enable_debugging = TRUE;
1851 } else if (strcmp (argv [i], "--security") == 0) {
1852 #ifndef DISABLE_SECURITY
1853 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1855 fprintf (stderr, "error: --security: not compiled with security manager support");
1858 } else if (strncmp (argv [i], "--security=", 11) == 0) {
1859 /* Note: validil, and verifiable need to be
1860 accepted even if DISABLE_SECURITY is defined. */
1862 if (strcmp (argv [i] + 11, "core-clr") == 0) {
1863 #ifndef DISABLE_SECURITY
1864 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1865 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1867 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1870 } else if (strcmp (argv [i] + 11, "core-clr-test") == 0) {
1871 #ifndef DISABLE_SECURITY
1872 /* fixme should we enable verifiable code here?*/
1873 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1874 mono_security_core_clr_test = TRUE;
1876 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1879 } else if (strcmp (argv [i] + 11, "cas") == 0) {
1880 #ifndef DISABLE_SECURITY
1881 fprintf (stderr, "warning: --security=cas not supported.");
1883 fprintf (stderr, "error: --security: not compiled with CAS support");
1886 } else if (strcmp (argv [i] + 11, "validil") == 0) {
1887 mono_verifier_set_mode (MONO_VERIFIER_MODE_VALID);
1888 } else if (strcmp (argv [i] + 11, "verifiable") == 0) {
1889 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1891 fprintf (stderr, "error: --security= option has invalid argument (cas, core-clr, verifiable or validil)\n");
1894 } else if (strcmp (argv [i], "--desktop") == 0) {
1895 mono_gc_set_desktop_mode ();
1896 /* Put more desktop-specific optimizations here */
1897 } else if (strcmp (argv [i], "--server") == 0){
1898 mono_config_set_server_mode (TRUE);
1899 /* Put more server-specific optimizations here */
1900 } else if (strcmp (argv [i], "--inside-mdb") == 0) {
1901 action = DO_DEBUGGER;
1902 } else if (strncmp (argv [i], "--wapi=", 7) == 0) {
1903 fprintf (stderr, "--wapi= option no longer supported\n.");
1905 } else if (strcmp (argv [i], "--no-x86-stack-align") == 0) {
1906 mono_do_x86_stack_align = FALSE;
1907 #ifdef MONO_JIT_INFO_TABLE_TEST
1908 } else if (strcmp (argv [i], "--test-jit-info-table") == 0) {
1909 test_jit_info_table = TRUE;
1911 } else if (strcmp (argv [i], "--llvm") == 0) {
1912 #ifndef MONO_ARCH_LLVM_SUPPORTED
1913 fprintf (stderr, "Mono Warning: --llvm not supported on this platform.\n");
1914 #elif !defined(ENABLE_LLVM)
1915 fprintf (stderr, "Mono Warning: --llvm not enabled in this runtime.\n");
1917 mono_use_llvm = TRUE;
1919 } else if (strcmp (argv [i], "--nollvm") == 0){
1920 mono_use_llvm = FALSE;
1921 #ifdef ENABLE_INTERPRETER
1922 } else if (strcmp (argv [i], "--interpreter") == 0) {
1923 mono_use_interpreter = TRUE;
1926 #ifdef __native_client__
1927 } else if (strcmp (argv [i], "--nacl-mono-path") == 0){
1928 nacl_mono_path = g_strdup(argv[++i]);
1929 } else if (strcmp (argv [i], "--nacl-null-checks-off") == 0){
1930 nacl_null_checks_off = TRUE;
1932 } else if (strncmp (argv [i], MONO_HANDLERS_ARGUMENT, MONO_HANDLERS_ARGUMENT_LEN) == 0) {
1933 //Install specific custom handlers.
1934 if (!mono_runtime_install_custom_handlers (argv[i] + MONO_HANDLERS_ARGUMENT_LEN)) {
1935 fprintf (stderr, "error: " MONO_HANDLERS_ARGUMENT ", one or more unknown handlers: '%s'\n", argv [i]);
1938 } else if (strcmp (argv [i], "--help-handlers") == 0) {
1939 mono_runtime_install_custom_handlers_usage ();
1941 } else if (argv [i][0] == '-' && argv [i][1] == '-' && mini_parse_debug_option (argv [i] + 2)) {
1943 fprintf (stderr, "Unknown command line option: '%s'\n", argv [i]);
1948 #ifdef __native_client_codegen__
1949 if (!nacl_null_checks_off) {
1950 MonoDebugOptions *opt = mini_get_debug_options ();
1951 opt->explicit_null_checks = TRUE;
1955 #if defined(DISABLE_HW_TRAPS) || defined(MONO_ARCH_DISABLE_HW_TRAPS)
1956 // Signal handlers not available
1958 MonoDebugOptions *opt = mini_get_debug_options ();
1959 opt->explicit_null_checks = TRUE;
1968 #if !defined(HOST_WIN32) && defined(HAVE_UNISTD_H)
1970 * If we are not embedded, use the mono runtime executable to run managed exe's.
1975 runtime_path = mono_w32process_get_path (getpid ());
1977 mono_w32process_set_cli_launcher (runtime_path);
1978 g_free (runtime_path);
1983 if (g_getenv ("MONO_XDEBUG"))
1984 enable_debugging = TRUE;
1986 #ifdef MONO_CROSS_COMPILE
1987 if (!mono_compile_aot) {
1988 fprintf (stderr, "This mono runtime is compiled for cross-compiling. Only the --aot option is supported.\n");
1991 #if SIZEOF_VOID_P == 8 && (defined(TARGET_ARM) || defined(TARGET_X86))
1992 fprintf (stderr, "Can't cross-compile on 64-bit platforms to 32-bit architecture.\n");
1994 #elif SIZEOF_VOID_P == 4 && (defined(TARGET_ARM64) || defined(TARGET_AMD64))
1995 fprintf (stderr, "Can't cross-compile on 32-bit platforms to 64-bit architecture.\n");
2000 if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
2001 g_set_prgname (argv[i]);
2004 mono_counters_init ();
2007 mono_w32handle_init ();
2010 /* Set rootdir before loading config */
2011 mono_set_rootdir ();
2013 if (enable_profile) {
2014 mini_profiler_enable_with_options (profile_options);
2017 mono_attach_parse_options (attach_options);
2019 if (trace_options != NULL){
2021 * Need to call this before mini_init () so we can trace methods
2022 * compiled there too.
2024 mono_jit_trace_calls = mono_trace_parse_options (trace_options);
2025 if (mono_jit_trace_calls == NULL)
2030 if (!mono_aot_only) {
2031 fprintf (stderr, "This runtime has been configured with --enable-minimal=jit, so the --full-aot command line option is required.\n");
2036 if (action == DO_DEBUGGER) {
2037 enable_debugging = TRUE;
2038 g_print ("The Mono Debugger is no longer supported.\n");
2040 } else if (enable_debugging)
2041 mono_debug_init (MONO_DEBUG_FORMAT_MONO);
2045 mono_load_coree (argv [i]);
2048 /* Parse gac loading options before loading assemblies. */
2049 if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
2050 mono_config_parse (config_file);
2053 mono_set_defaults (mini_verbose, opt);
2054 #ifdef ENABLE_INTERPRETER
2055 mono_interp_init ();
2057 domain = mini_init (argv [i], forced_version);
2059 mono_gc_set_stack_end (&domain);
2064 for (i = 0; i < agents->len; ++i) {
2065 int res = load_agent (domain, (char*)g_ptr_array_index (agents, i));
2067 g_ptr_array_free (agents, TRUE);
2068 mini_cleanup (domain);
2073 g_ptr_array_free (agents, TRUE);
2077 case DO_SINGLE_METHOD_REGRESSION:
2078 mono_do_single_method_regression = TRUE;
2080 #ifdef ENABLE_INTERPRETER
2081 if (mono_use_interpreter) {
2082 if (interp_regression_list (2, argc -i, argv + i)) {
2083 g_print ("Regression ERRORS!\n");
2084 // mini_cleanup (domain);
2087 // mini_cleanup (domain);
2091 if (mini_regression_list (mini_verbose, argc -i, argv + i)) {
2092 g_print ("Regression ERRORS!\n");
2093 mini_cleanup (domain);
2096 mini_cleanup (domain);
2099 if (argc - i != 1 || mname == NULL) {
2100 g_print ("Usage: mini --ncompile num --compile method assembly\n");
2101 mini_cleanup (domain);
2107 if (argc - i != 1) {
2109 mini_cleanup (domain);
2115 if (argc - i != 1 || mname == NULL) {
2117 mini_cleanup (domain);
2123 #ifdef ENABLE_INTERPRETER
2124 if (mono_use_interpreter)
2125 g_error ("not yet");
2129 mini_cleanup (domain);
2136 #ifdef MONO_JIT_INFO_TABLE_TEST
2137 if (test_jit_info_table)
2138 jit_info_table_test (domain);
2141 assembly = mono_assembly_open (aname, &open_status);
2143 fprintf (stderr, "Cannot open assembly '%s': %s.\n", aname, mono_image_strerror (open_status));
2144 mini_cleanup (domain);
2148 if (trace_options != NULL)
2149 mono_trace_set_assembly (assembly);
2151 if (mono_compile_aot || action == DO_EXEC) {
2154 //mono_set_rootdir ();
2156 error = mono_check_corlib_version ();
2158 fprintf (stderr, "Corlib not in sync with this runtime: %s\n", error);
2159 fprintf (stderr, "Loaded from: %s\n",
2160 mono_defaults.corlib? mono_image_get_filename (mono_defaults.corlib): "unknown");
2161 fprintf (stderr, "Download a newer corlib or a newer runtime at http://www.mono-project.com/download.\n");
2165 #if defined(HOST_WIN32) && G_HAVE_API_SUPPORT(HAVE_CLASSIC_WINAPI_SUPPORT)
2166 /* Detach console when executing IMAGE_SUBSYSTEM_WINDOWS_GUI on win32 */
2167 if (!enable_debugging && !mono_compile_aot && ((MonoCLIImageInfo*)(mono_assembly_get_image (assembly)->image_info))->cli_header.nt.pe_subsys_required == IMAGE_SUBSYSTEM_WINDOWS_GUI)
2171 main_args.domain = domain;
2172 main_args.file = aname;
2173 main_args.argc = argc - i;
2174 main_args.argv = argv + i;
2175 main_args.opts = opt;
2176 main_args.aot_options = aot_options;
2177 #if RUN_IN_SUBTHREAD
2178 mono_runtime_exec_managed_code (domain, main_thread_handler, &main_args);
2180 main_thread_handler (&main_args);
2181 mono_thread_manage ();
2184 mini_cleanup (domain);
2186 /* Look up return value from System.Environment.ExitCode */
2187 i = mono_environment_exitcode_get ();
2189 } else if (action == DO_COMPILE) {
2190 compile_all_methods (assembly, mini_verbose, opt, recompilation_times);
2191 mini_cleanup (domain);
2193 } else if (action == DO_DEBUGGER) {
2196 desc = mono_method_desc_new (mname, 0);
2198 g_print ("Invalid method name %s\n", mname);
2199 mini_cleanup (domain);
2202 method = mono_method_desc_search_in_image (desc, mono_assembly_get_image (assembly));
2204 g_print ("Cannot find method %s\n", mname);
2205 mini_cleanup (domain);
2210 if (action == DO_DRAW) {
2213 switch (mono_graph_options) {
2214 case MONO_GRAPH_DTREE:
2216 opt |= MONO_OPT_LOOP;
2218 case MONO_GRAPH_CFG_CODE:
2221 case MONO_GRAPH_CFG_SSA:
2224 case MONO_GRAPH_CFG_OPTCODE:
2231 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2232 (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL)) {
2234 nm = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2235 cfg = mini_method_compile (nm, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2238 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2239 if ((mono_graph_options & MONO_GRAPH_CFG_SSA) && !(cfg->comp_done & MONO_COMP_SSA)) {
2240 g_warning ("no SSA info available (use -O=deadce)");
2243 mono_draw_graph (cfg, mono_graph_options);
2244 mono_destroy_compile (cfg);
2246 } else if (action == DO_BENCH) {
2247 if (mini_stats_fd) {
2249 double no_opt_time = 0.0;
2250 GTimer *timer = g_timer_new ();
2251 fprintf (mini_stats_fd, "$stattitle = \'Compilations times for %s\';\n",
2252 mono_method_full_name (method, TRUE));
2253 fprintf (mini_stats_fd, "@data = (\n");
2254 fprintf (mini_stats_fd, "[");
2255 for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2257 n = mono_opt_descr (opt);
2260 fprintf (mini_stats_fd, "\"%s\",", n);
2262 fprintf (mini_stats_fd, "],\n[");
2264 for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2268 g_timer_start (timer);
2269 for (j = 0; j < count; ++j) {
2270 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2271 mono_destroy_compile (cfg);
2273 g_timer_stop (timer);
2274 elapsed = g_timer_elapsed (timer, NULL);
2276 no_opt_time = elapsed;
2277 fprintf (mini_stats_fd, "%f, ", elapsed);
2279 fprintf (mini_stats_fd, "]");
2280 if (no_opt_time > 0.0) {
2281 fprintf (mini_stats_fd, ", \n[");
2282 for (i = 0; i < G_N_ELEMENTS (opt_sets); i++)
2283 fprintf (mini_stats_fd, "%f,", no_opt_time);
2284 fprintf (mini_stats_fd, "]");
2286 fprintf (mini_stats_fd, ");\n");
2288 for (i = 0; i < count; ++i) {
2289 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2290 (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL))
2291 method = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2293 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2294 mono_destroy_compile (cfg);
2298 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2299 mono_destroy_compile (cfg);
2303 mini_cleanup (domain);
2308 mono_jit_init (const char *file)
2310 return mini_init (file, NULL);
2314 * mono_jit_init_version:
2315 * @domain_name: the name of the root domain
2316 * @runtime_version: the version of the runtime to load
2318 * Use this version when you want to force a particular runtime
2319 * version to be used. By default Mono will pick the runtime that is
2320 * referenced by the initial assembly (specified in @file), this
2321 * routine allows programmers to specify the actual runtime to be used
2322 * as the initial runtime is inherited by all future assemblies loaded
2323 * (since Mono does not support having more than one mscorlib runtime
2326 * The @runtime_version can be one of these strings: "v4.0.30319" for
2327 * desktop, "mobile" for mobile or "moonlight" for Silverlight compat.
2328 * If an unrecognized string is input, the vm will default to desktop.
2330 * Returns: the MonoDomain representing the domain where the assembly
2334 mono_jit_init_version (const char *domain_name, const char *runtime_version)
2336 return mini_init (domain_name, runtime_version);
2340 mono_jit_cleanup (MonoDomain *domain)
2342 mono_thread_manage ();
2344 mini_cleanup (domain);
2348 mono_jit_set_aot_only (gboolean val)
2350 mono_aot_only = val;
2354 mono_jit_set_aot_mode (MonoAotMode mode)
2356 /* we don't want to set mono_aot_mode twice */
2357 g_assert (mono_aot_mode == MONO_AOT_MODE_NONE);
2358 mono_aot_mode = mode;
2360 if (mono_aot_mode == MONO_AOT_MODE_LLVMONLY) {
2361 mono_aot_only = TRUE;
2362 mono_llvm_only = TRUE;
2364 if (mono_aot_mode == MONO_AOT_MODE_FULL) {
2365 mono_aot_only = TRUE;
2367 if (mono_aot_mode == MONO_AOT_MODE_HYBRID) {
2368 mono_set_generic_sharing_vt_supported (TRUE);
2369 mono_set_partial_sharing_supported (TRUE);
2374 * mono_jit_set_trace_options:
2375 * @options: string representing the trace options
2377 * Set the options of the tracing engine. This function can be called before initializing
2378 * the mono runtime. See the --trace mono(1) manpage for the options format.
2380 * Returns: #TRUE if the options where parsed and set correctly, #FALSE otherwise.
2383 mono_jit_set_trace_options (const char* options)
2385 MonoTraceSpec *trace_opt = mono_trace_parse_options (options);
2386 if (trace_opt == NULL)
2388 mono_jit_trace_calls = trace_opt;
2393 * mono_set_signal_chaining:
2395 * Enable/disable signal chaining. This should be called before mono_jit_init ().
2396 * If signal chaining is enabled, the runtime saves the original signal handlers before
2397 * installing its own handlers, and calls the original ones in the following cases:
2398 * - a SIGSEGV/SIGABRT signal received while executing native (i.e. not JITted) code.
2403 * Signal chaining only works on POSIX platforms.
2406 mono_set_signal_chaining (gboolean chain_signals)
2408 mono_do_signal_chaining = chain_signals;
2412 * mono_set_crash_chaining:
2414 * Enable/disable crash chaining due to signals. When a fatal signal is delivered and
2415 * Mono doesn't know how to handle it, it will invoke the crash handler. If chrash chaining
2416 * is enabled, it will first print its crash information and then try to chain with the native handler.
2419 mono_set_crash_chaining (gboolean chain_crashes)
2421 mono_do_crash_chaining = chain_crashes;
2425 * mono_parse_options_from:
2426 * @options: string containing strings
2427 * @ref_argc: pointer to the argc variable that might be updated
2428 * @ref_argv: pointer to the argv string vector variable that might be updated
2430 * This function parses the contents of the `MONO_ENV_OPTIONS`
2431 * environment variable as if they were parsed by a command shell
2432 * splitting the contents by spaces into different elements of the
2433 * @argv vector. This method supports quoting with both the " and '
2434 * characters. Inside quoting, spaces and tabs are significant,
2435 * otherwise, they are considered argument separators.
2437 * The \ character can be used to escape the next character which will
2438 * be added to the current element verbatim. Typically this is used
2439 * inside quotes. If the quotes are not balanced, this method
2441 * If the environment variable is empty, no changes are made
2442 * to the values pointed by @ref_argc and @ref_argv.
2444 * Otherwise the @ref_argv is modified to point to a new array that contains
2445 * all the previous elements contained in the vector, plus the values parsed.
2446 * The @argc is updated to match the new number of parameters.
2448 * Returns: The value NULL is returned on success, otherwise a g_strdup allocated
2449 * string is returned (this is an alias to malloc under normal circumstances) that
2450 * contains the error message that happened during parsing.
2453 mono_parse_options_from (const char *options, int *ref_argc, char **ref_argv [])
2455 int argc = *ref_argc;
2456 char **argv = *ref_argv;
2457 GPtrArray *array = g_ptr_array_new ();
2458 GString *buffer = g_string_new ("");
2461 gboolean in_quotes = FALSE;
2462 char quote_char = '\0';
2464 if (options == NULL)
2467 for (p = options; *p; p++){
2469 case ' ': case '\t':
2471 if (buffer->len != 0){
2472 g_ptr_array_add (array, g_strdup (buffer->str));
2473 g_string_truncate (buffer, 0);
2476 g_string_append_c (buffer, *p);
2481 g_string_append_c (buffer, p [1]);
2488 if (quote_char == *p)
2491 g_string_append_c (buffer, *p);
2498 g_string_append_c (buffer, *p);
2503 return g_strdup_printf ("Unmatched quotes in value: [%s]\n", options);
2505 if (buffer->len != 0)
2506 g_ptr_array_add (array, g_strdup (buffer->str));
2507 g_string_free (buffer, TRUE);
2509 if (array->len > 0){
2510 int new_argc = array->len + argc;
2511 char **new_argv = g_new (char *, new_argc + 1);
2514 new_argv [0] = argv [0];
2516 /* First the environment variable settings, to allow the command line options to override */
2517 for (i = 0; i < array->len; i++)
2518 new_argv [i+1] = (char *)g_ptr_array_index (array, i);
2520 for (j = 1; j < argc; j++)
2521 new_argv [i++] = argv [j];
2522 new_argv [i] = NULL;
2524 *ref_argc = new_argc;
2525 *ref_argv = new_argv;
2527 g_ptr_array_free (array, TRUE);
2532 * mono_parse_env_options:
2533 * @ref_argc: pointer to the argc variable that might be updated
2534 * @ref_argv: pointer to the argv string vector variable that might be updated
2536 * This function parses the contents of the `MONO_ENV_OPTIONS`
2537 * environment variable as if they were parsed by a command shell
2538 * splitting the contents by spaces into different elements of the
2539 * @argv vector. This method supports quoting with both the " and '
2540 * characters. Inside quoting, spaces and tabs are significant,
2541 * otherwise, they are considered argument separators.
2543 * The \ character can be used to escape the next character which will
2544 * be added to the current element verbatim. Typically this is used
2545 * inside quotes. If the quotes are not balanced, this method
2547 * If the environment variable is empty, no changes are made
2548 * to the values pointed by @ref_argc and @ref_argv.
2550 * Otherwise the @ref_argv is modified to point to a new array that contains
2551 * all the previous elements contained in the vector, plus the values parsed.
2552 * The @argc is updated to match the new number of parameters.
2554 * If there is an error parsing, this method will terminate the process by
2557 * An alternative to this method that allows an arbitrary string to be parsed
2558 * and does not exit on error is the `api:mono_parse_options_from`.
2561 mono_parse_env_options (int *ref_argc, char **ref_argv [])
2565 const char *env_options = g_getenv ("MONO_ENV_OPTIONS");
2566 if (env_options == NULL)
2568 ret = mono_parse_options_from (env_options, ref_argc, ref_argv);
2571 fprintf (stderr, "%s", ret);