Merge pull request #5190 from alexrp/profiler-roots-deprecation
[mono.git] / mono / mini / driver.c
1 /**
2  * \file
3  * The new mono JIT compiler.
4  *
5  * Author:
6  *   Paolo Molaro (lupus@ximian.com)
7  *   Dietmar Maurer (dietmar@ximian.com)
8  *
9  * (C) 2002-2003 Ximian, Inc.
10  * (C) 2003-2006 Novell, Inc.
11  * Licensed under the MIT license. See LICENSE file in the project root for full license information.
12  */
13
14 #include <config.h>
15 #ifdef HAVE_SIGNAL_H
16 #include <signal.h>
17 #endif
18 #if HAVE_SCHED_SETAFFINITY
19 #include <sched.h>
20 #endif
21 #ifdef HAVE_UNISTD_H
22 #include <unistd.h>
23 #endif
24
25 #include <mono/metadata/assembly-internals.h>
26 #include <mono/metadata/loader.h>
27 #include <mono/metadata/tabledefs.h>
28 #include <mono/metadata/class.h>
29 #include <mono/metadata/object.h>
30 #include <mono/metadata/exception.h>
31 #include <mono/metadata/opcodes.h>
32 #include <mono/metadata/mono-endian.h>
33 #include <mono/metadata/tokentype.h>
34 #include <mono/metadata/tabledefs.h>
35 #include <mono/metadata/threads.h>
36 #include <mono/metadata/marshal.h>
37 #include <mono/metadata/appdomain.h>
38 #include <mono/metadata/debug-helpers.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"
55
56 #include "mini.h"
57 #include "jit.h"
58 #include "aot-compiler.h"
59 #include "interp/interp.h"
60
61 #include <string.h>
62 #include <ctype.h>
63 #include <locale.h>
64 #include "version.h"
65 #include "debugger-agent.h"
66 #if TARGET_OSX
67 #   include <sys/resource.h>
68 #endif
69
70 static FILE *mini_stats_fd;
71
72 static void mini_usage (void);
73
74 #ifdef HOST_WIN32
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 */
78 int _CRT_glob = 0;
79 #endif
80
81 typedef void (*OptFunc) (const char *p);
82
83 #undef OPTFLAG
84 #ifdef HAVE_ARRAY_ELEM_INIT
85 #define MSGSTRFIELD(line) MSGSTRFIELD1(line)
86 #define MSGSTRFIELD1(line) str##line
87
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"
91 #undef OPTFLAG
92 } opstr = {
93 #define OPTFLAG(id,shift,name,desc) name "\0" desc,
94 #include "optflags-def.h"
95 #undef OPTFLAG
96 };
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"
100 #undef OPTFLAG
101 };
102
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)))
105
106 #else /* !HAVE_ARRAY_ELEM_INIT */
107 typedef struct {
108         const char* name;
109         const char* desc;
110 } OptName;
111
112 #define OPTFLAG(id,shift,name,desc) {name,desc},
113 static const OptName 
114 opt_names [] = {
115 #include "optflags-def.h"
116         {NULL, NULL}
117 };
118 #define optflag_get_name(id) (opt_names [(id)].name)
119 #define optflag_get_desc(id) (opt_names [(id)].desc)
120
121 #endif
122
123 #define DEFAULT_OPTIMIZATIONS ( \
124         MONO_OPT_PEEPHOLE |     \
125         MONO_OPT_CFOLD |        \
126         MONO_OPT_INLINE |       \
127         MONO_OPT_CONSPROP |     \
128         MONO_OPT_COPYPROP |     \
129         MONO_OPT_DEADCE |       \
130         MONO_OPT_BRANCH |       \
131         MONO_OPT_LINEARS |      \
132         MONO_OPT_INTRINS |  \
133         MONO_OPT_LOOP |  \
134         MONO_OPT_EXCEPTION |  \
135     MONO_OPT_CMOV |  \
136         MONO_OPT_GSHARED |      \
137         MONO_OPT_SIMD | \
138         MONO_OPT_ALIAS_ANALYSIS | \
139         MONO_OPT_AOT)
140
141 #define EXCLUDED_FROM_ALL (MONO_OPT_SHARED | MONO_OPT_PRECOMP | MONO_OPT_UNSAFE | MONO_OPT_GSHAREDVT | MONO_OPT_FLOAT32)
142
143 static guint32
144 parse_optimizations (guint32 opt, const char* p, gboolean cpu_opts)
145 {
146         guint32 exclude = 0;
147         const char *n;
148         int i, invert;
149         char **parts, **ptr;
150
151         /* Initialize the hwcap module if necessary. */
152         mono_hwcap_init ();
153
154         /* call out to cpu detection code here that sets the defaults ... */
155         if (cpu_opts) {
156                 opt |= mono_arch_cpu_optimizations (&exclude);
157                 opt &= ~exclude;
158         }
159         if (!p)
160                 return opt;
161
162         parts = g_strsplit (p, ",", -1);
163         for (ptr = parts; ptr && *ptr; ptr ++) {
164                 char *arg = *ptr;
165                 char *p = arg;
166
167                 if (*p == '-') {
168                         p++;
169                         invert = TRUE;
170                 } else {
171                         invert = FALSE;
172                 }
173                 for (i = 0; i < G_N_ELEMENTS (opt_names) && optflag_get_name (i); ++i) {
174                         n = optflag_get_name (i);
175                         if (!strcmp (p, n)) {
176                                 if (invert)
177                                         opt &= ~ (1 << i);
178                                 else
179                                         opt |= 1 << i;
180                                 break;
181                         }
182                 }
183                 if (i == G_N_ELEMENTS (opt_names) || !optflag_get_name (i)) {
184                         if (strncmp (p, "all", 3) == 0) {
185                                 if (invert)
186                                         opt = 0;
187                                 else
188                                         opt = ~(EXCLUDED_FROM_ALL | exclude);
189                         } else {
190                                 fprintf (stderr, "Invalid optimization name `%s'\n", p);
191                                 exit (1);
192                         }
193                 }
194
195                 g_free (arg);
196         }
197         g_free (parts);
198
199         return opt;
200 }
201
202 static gboolean
203 parse_debug_options (const char* p)
204 {
205         MonoDebugOptions *opt = mini_get_debug_options ();
206
207         do {
208                 if (!*p) {
209                         fprintf (stderr, "Syntax error; expected debug option name\n");
210                         return FALSE;
211                 }
212
213                 if (!strncmp (p, "casts", 5)) {
214                         opt->better_cast_details = TRUE;
215                         p += 5;
216                 } else if (!strncmp (p, "mdb-optimizations", 17)) {
217                         opt->mdb_optimizations = TRUE;
218                         p += 17;
219                 } else if (!strncmp (p, "gdb", 3)) {
220                         opt->gdb = TRUE;
221                         p += 3;
222                 } else {
223                         fprintf (stderr, "Invalid debug option `%s', use --help-debug for details\n", p);
224                         return FALSE;
225                 }
226
227                 if (*p == ',') {
228                         p++;
229                         if (!*p) {
230                                 fprintf (stderr, "Syntax error; expected debug option name\n");
231                                 return FALSE;
232                         }
233                 }
234         } while (*p);
235
236         return TRUE;
237 }
238
239 typedef struct {
240         const char name [6];
241         const char desc [18];
242         MonoGraphOptions value;
243 } GraphName;
244
245 static const GraphName 
246 graph_names [] = {
247         {"cfg",      "Control Flow",                            MONO_GRAPH_CFG},
248         {"dtree",    "Dominator Tree",                          MONO_GRAPH_DTREE},
249         {"code",     "CFG showing code",                        MONO_GRAPH_CFG_CODE},
250         {"ssa",      "CFG after SSA",                           MONO_GRAPH_CFG_SSA},
251         {"optc",     "CFG after IR opts",                       MONO_GRAPH_CFG_OPTCODE}
252 };
253
254 static MonoGraphOptions
255 mono_parse_graph_options (const char* p)
256 {
257         const char *n;
258         int i, len;
259
260         for (i = 0; i < G_N_ELEMENTS (graph_names); ++i) {
261                 n = graph_names [i].name;
262                 len = strlen (n);
263                 if (strncmp (p, n, len) == 0)
264                         return graph_names [i].value;
265         }
266
267         fprintf (stderr, "Invalid graph name provided: %s\n", p);
268         exit (1);
269 }
270
271 /**
272  * mono_parse_default_optimizations:
273  */
274 int
275 mono_parse_default_optimizations (const char* p)
276 {
277         guint32 opt;
278
279         opt = parse_optimizations (DEFAULT_OPTIMIZATIONS, p, TRUE);
280         return opt;
281 }
282
283 char*
284 mono_opt_descr (guint32 flags) {
285         GString *str = g_string_new ("");
286         int i, need_comma;
287
288         need_comma = 0;
289         for (i = 0; i < G_N_ELEMENTS (opt_names); ++i) {
290                 if (flags & (1 << i) && optflag_get_name (i)) {
291                         if (need_comma)
292                                 g_string_append_c (str, ',');
293                         g_string_append (str, optflag_get_name (i));
294                         need_comma = 1;
295                 }
296         }
297         return g_string_free (str, FALSE);
298 }
299
300 static const guint32
301 opt_sets [] = {
302        0,
303        MONO_OPT_PEEPHOLE,
304        MONO_OPT_BRANCH,
305        MONO_OPT_CFOLD,
306        MONO_OPT_FCMOV,
307        MONO_OPT_ALIAS_ANALYSIS,
308 #ifdef MONO_ARCH_SIMD_INTRINSICS
309        MONO_OPT_SIMD,
310        MONO_OPT_SSE2,
311        MONO_OPT_SIMD | MONO_OPT_SSE2,
312 #endif
313        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_INTRINS,
314        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_INTRINS | MONO_OPT_ALIAS_ANALYSIS,
315        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS,
316        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP,
317        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_CFOLD,
318        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE,
319        MONO_OPT_BRANCH | MONO_OPT_PEEPHOLE | MONO_OPT_LINEARS | MONO_OPT_COPYPROP | MONO_OPT_CONSPROP | MONO_OPT_DEADCE | MONO_OPT_ALIAS_ANALYSIS,
320        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,
321        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,
322        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,
323        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,
324        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,
325        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,
326        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,
327        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,
328        DEFAULT_OPTIMIZATIONS, 
329 };
330
331 typedef int (*TestMethod) (void);
332
333 #if 0
334 static void
335 domain_dump_native_code (MonoDomain *domain) {
336         // need to poke into the domain, move to metadata/domain.c
337         // need to empty jit_info_table and code_mp
338 }
339 #endif
340
341 static void
342 mini_regression_step (MonoImage *image, int verbose, int *total_run, int *total,
343                 guint32 opt_flags,
344                 GTimer *timer, MonoDomain *domain)
345 {
346         int result, expected, failed, cfailed, run, code_size;
347         TestMethod func;
348         double elapsed, comp_time, start_time;
349         char *n;
350         int i;
351
352         mono_set_defaults (verbose, opt_flags);
353         n = mono_opt_descr (opt_flags);
354         g_print ("Test run: image=%s, opts=%s\n", mono_image_get_filename (image), n);
355         g_free (n);
356         cfailed = failed = run = code_size = 0;
357         comp_time = elapsed = 0.0;
358
359         /* fixme: ugly hack - delete all previously compiled methods */
360         if (domain_jit_info (domain)) {
361                 g_hash_table_destroy (domain_jit_info (domain)->jit_trampoline_hash);
362                 domain_jit_info (domain)->jit_trampoline_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
363                 mono_internal_hash_table_destroy (&(domain->jit_code_hash));
364                 mono_jit_code_hash_init (&(domain->jit_code_hash));
365         }
366
367         g_timer_start (timer);
368         if (mini_stats_fd)
369                 fprintf (mini_stats_fd, "[");
370         for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
371                 MonoError error;
372                 MonoMethod *method = mono_get_method_checked (image, MONO_TOKEN_METHOD_DEF | (i + 1), NULL, NULL, &error);
373                 if (!method) {
374                         mono_error_cleanup (&error); /* FIXME don't swallow the error */
375                         continue;
376                 }
377                 if (strncmp (method->name, "test_", 5) == 0) {
378                         MonoCompile *cfg;
379
380                         expected = atoi (method->name + 5);
381                         run++;
382                         start_time = g_timer_elapsed (timer, NULL);
383                         comp_time -= start_time;
384                         cfg = mini_method_compile (method, mono_get_optimizations_for_method (method, opt_flags), mono_get_root_domain (), JIT_FLAG_RUN_CCTORS, 0, -1);
385                         comp_time += g_timer_elapsed (timer, NULL);
386                         if (cfg->exception_type == MONO_EXCEPTION_NONE) {
387                                 if (verbose >= 2)
388                                         g_print ("Running '%s' ...\n", method->name);
389 #ifdef MONO_USE_AOT_COMPILER
390                                 MonoError error;
391                                 func = (TestMethod)mono_aot_get_method_checked (mono_get_root_domain (), method, &error);
392                                 mono_error_cleanup (&error);
393                                 if (!func)
394                                         func = (TestMethod)(gpointer)cfg->native_code;
395 #else
396                                         func = (TestMethod)(gpointer)cfg->native_code;
397 #endif
398                                 func = (TestMethod)mono_create_ftnptr (mono_get_root_domain (), func);
399                                 result = func ();
400                                 if (result != expected) {
401                                         failed++;
402                                         g_print ("Test '%s' failed result (got %d, expected %d).\n", method->name, result, expected);
403                                 }
404                                 code_size += cfg->code_len;
405                                 mono_destroy_compile (cfg);
406
407                         } else {
408                                 cfailed++;
409                                 g_print ("Test '%s' failed compilation.\n", method->name);
410                         }
411                         if (mini_stats_fd)
412                                 fprintf (mini_stats_fd, "%f, ",
413                                                 g_timer_elapsed (timer, NULL) - start_time);
414                 }
415         }
416         if (mini_stats_fd)
417                 fprintf (mini_stats_fd, "],\n");
418         g_timer_stop (timer);
419         elapsed = g_timer_elapsed (timer, NULL);
420         if (failed > 0 || cfailed > 0){
421                 g_print ("Results: total tests: %d, failed: %d, cfailed: %d (pass: %.2f%%)\n",
422                                 run, failed, cfailed, 100.0*(run-failed-cfailed)/run);
423         } else {
424                 g_print ("Results: total tests: %d, all pass \n",  run);
425         }
426
427         g_print ("Elapsed time: %f secs (%f, %f), Code size: %d\n\n", elapsed,
428                         elapsed - comp_time, comp_time, code_size);
429         *total += failed + cfailed;
430         *total_run += run;
431 }
432
433 static int
434 mini_regression (MonoImage *image, int verbose, int *total_run)
435 {
436         guint32 i, opt;
437         MonoMethod *method;
438         char *n;
439         GTimer *timer = g_timer_new ();
440         MonoDomain *domain = mono_domain_get ();
441         guint32 exclude = 0;
442         int total;
443
444         /* Note: mono_hwcap_init () called in mono_init () before we get here. */
445         mono_arch_cpu_optimizations (&exclude);
446
447         if (mini_stats_fd) {
448                 fprintf (mini_stats_fd, "$stattitle = \'Mono Benchmark Results (various optimizations)\';\n");
449
450                 fprintf (mini_stats_fd, "$graph->set_legend(qw(");
451                 for (opt = 0; opt < G_N_ELEMENTS (opt_sets); opt++) {
452                         guint32 opt_flags = opt_sets [opt];
453                         n = mono_opt_descr (opt_flags);
454                         if (!n [0])
455                                 n = (char *)"none";
456                         if (opt)
457                                 fprintf (mini_stats_fd, " ");
458                         fprintf (mini_stats_fd, "%s", n);
459                 
460
461                 }
462                 fprintf (mini_stats_fd, "));\n");
463
464                 fprintf (mini_stats_fd, "@data = (\n");
465                 fprintf (mini_stats_fd, "[");
466         }
467
468         /* load the metadata */
469         for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
470                 MonoError error;
471                 method = mono_get_method_checked (image, MONO_TOKEN_METHOD_DEF | (i + 1), NULL, NULL, &error);
472                 if (!method) {
473                         mono_error_cleanup (&error);
474                         continue;
475                 }
476                 mono_class_init (method->klass);
477
478                 if (!strncmp (method->name, "test_", 5) && mini_stats_fd) {
479                         fprintf (mini_stats_fd, "\"%s\",", method->name);
480                 }
481         }
482         if (mini_stats_fd)
483                 fprintf (mini_stats_fd, "],\n");
484
485
486         total = 0;
487         *total_run = 0;
488         if (mono_do_single_method_regression) {
489                 GSList *iter;
490
491                 mini_regression_step (image, verbose, total_run, &total,
492                                 0,
493                                 timer, domain);
494                 if (total)
495                         return total;
496                 g_print ("Single method regression: %d methods\n", g_slist_length (mono_single_method_list));
497
498                 for (iter = mono_single_method_list; iter; iter = g_slist_next (iter)) {
499                         char *method_name;
500
501                         mono_current_single_method = (MonoMethod *)iter->data;
502
503                         method_name = mono_method_full_name (mono_current_single_method, TRUE);
504                         g_print ("Current single method: %s\n", method_name);
505                         g_free (method_name);
506
507                         mini_regression_step (image, verbose, total_run, &total,
508                                         0,
509                                         timer, domain);
510                         if (total)
511                                 return total;
512                 }
513         } else {
514                 for (opt = 0; opt < G_N_ELEMENTS (opt_sets); ++opt) {
515                         mini_regression_step (image, verbose, total_run, &total,
516                                         opt_sets [opt] & ~exclude,
517                                         timer, domain);
518                 }
519         }
520
521         if (mini_stats_fd) {
522                 fprintf (mini_stats_fd, ");\n");
523                 fflush (mini_stats_fd);
524         }
525
526         g_timer_destroy (timer);
527         return total;
528 }
529
530 static int
531 mini_regression_list (int verbose, int count, char *images [])
532 {
533         int i, total, total_run, run;
534         MonoAssembly *ass;
535         
536         total_run =  total = 0;
537         for (i = 0; i < count; ++i) {
538                 ass = mono_assembly_open_predicate (images [i], FALSE, FALSE, NULL, NULL, NULL);
539                 if (!ass) {
540                         g_warning ("failed to load assembly: %s", images [i]);
541                         continue;
542                 }
543                 total += mini_regression (mono_assembly_get_image (ass), verbose, &run);
544                 total_run += run;
545         }
546         if (total > 0){
547                 g_print ("Overall results: tests: %d, failed: %d, opt combinations: %d (pass: %.2f%%)\n", 
548                          total_run, total, (int)G_N_ELEMENTS (opt_sets), 100.0*(total_run-total)/total_run);
549         } else {
550                 g_print ("Overall results: tests: %d, 100%% pass, opt combinations: %d\n", 
551                          total_run, (int)G_N_ELEMENTS (opt_sets));
552         }
553         
554         return total;
555 }
556
557 #ifdef MONO_JIT_INFO_TABLE_TEST
558 typedef struct _JitInfoData
559 {
560         guint start;
561         guint length;
562         MonoJitInfo *ji;
563         struct _JitInfoData *next;
564 } JitInfoData;
565
566 typedef struct
567 {
568         guint start;
569         guint length;
570         int num_datas;
571         JitInfoData *data;
572 } Region;
573
574 typedef struct
575 {
576         int num_datas;
577         int num_regions;
578         Region *regions;
579         int num_frees;
580         JitInfoData *frees;
581 } ThreadData;
582
583 static int num_threads;
584 static ThreadData *thread_datas;
585 static MonoDomain *test_domain;
586
587 static JitInfoData*
588 alloc_random_data (Region *region)
589 {
590         JitInfoData **data;
591         JitInfoData *prev;
592         guint prev_end;
593         guint next_start;
594         guint max_len;
595         JitInfoData *d;
596         int num_retries = 0;
597         int pos, i;
598
599  restart:
600         prev = NULL;
601         data = &region->data;
602         pos = random () % (region->num_datas + 1);
603         i = 0;
604         while (*data != NULL) {
605                 if (i++ == pos)
606                         break;
607                 prev = *data;
608                 data = &(*data)->next;
609         }
610
611         if (prev == NULL)
612                 g_assert (*data == region->data);
613         else
614                 g_assert (prev->next == *data);
615
616         if (prev == NULL)
617                 prev_end = region->start;
618         else
619                 prev_end = prev->start + prev->length;
620
621         if (*data == NULL)
622                 next_start = region->start + region->length;
623         else
624                 next_start = (*data)->start;
625
626         g_assert (prev_end <= next_start);
627
628         max_len = next_start - prev_end;
629         if (max_len < 128) {
630                 if (++num_retries >= 10)
631                         return NULL;
632                 goto restart;
633         }
634         if (max_len > 1024)
635                 max_len = 1024;
636
637         d = g_new0 (JitInfoData, 1);
638         d->start = prev_end + random () % (max_len / 2);
639         d->length = random () % MIN (max_len, next_start - d->start) + 1;
640
641         g_assert (d->start >= prev_end && d->start + d->length <= next_start);
642
643         d->ji = g_new0 (MonoJitInfo, 1);
644         d->ji->d.method = (MonoMethod*) 0xABadBabe;
645         d->ji->code_start = (gpointer)(gulong) d->start;
646         d->ji->code_size = d->length;
647         d->ji->cas_inited = 1;  /* marks an allocated jit info */
648
649         d->next = *data;
650         *data = d;
651
652         ++region->num_datas;
653
654         return d;
655 }
656
657 static JitInfoData**
658 choose_random_data (Region *region)
659 {
660         int n;
661         int i;
662         JitInfoData **d;
663
664         g_assert (region->num_datas > 0);
665
666         n = random () % region->num_datas;
667
668         for (d = &region->data, i = 0;
669              i < n;
670              d = &(*d)->next, ++i)
671                 ;
672
673         return d;
674 }
675
676 static Region*
677 choose_random_region (ThreadData *td)
678 {
679         return &td->regions [random () % td->num_regions];
680 }
681
682 static ThreadData*
683 choose_random_thread (void)
684 {
685         return &thread_datas [random () % num_threads];
686 }
687
688 static void
689 free_jit_info_data (ThreadData *td, JitInfoData *free)
690 {
691         free->next = td->frees;
692         td->frees = free;
693
694         if (++td->num_frees >= 1000) {
695                 int i;
696
697                 for (i = 0; i < 500; ++i)
698                         free = free->next;
699
700                 while (free->next != NULL) {
701                         JitInfoData *next = free->next->next;
702
703                         //g_free (free->next->ji);
704                         g_free (free->next);
705                         free->next = next;
706
707                         --td->num_frees;
708                 }
709         }
710 }
711
712 #define NUM_THREADS             8
713 #define REGIONS_PER_THREAD      10
714 #define REGION_SIZE             0x10000
715
716 #define MAX_ADDR                (REGION_SIZE * REGIONS_PER_THREAD * NUM_THREADS)
717
718 #define MODE_ALLOC      1
719 #define MODE_FREE       2
720
721 static void
722 test_thread_func (ThreadData *td)
723 {
724         int mode = MODE_ALLOC;
725         int i = 0;
726         gulong lookup_successes = 0, lookup_failures = 0;
727         MonoDomain *domain = test_domain;
728         int thread_num = (int)(td - thread_datas);
729         gboolean modify_thread = thread_num < NUM_THREADS / 2; /* only half of the threads modify the table */
730
731         for (;;) {
732                 int alloc;
733                 int lookup = 1;
734
735                 if (td->num_datas == 0) {
736                         lookup = 0;
737                         alloc = 1;
738                 } else if (modify_thread && random () % 1000 < 5) {
739                         lookup = 0;
740                         if (mode == MODE_ALLOC)
741                                 alloc = (random () % 100) < 70;
742                         else if (mode == MODE_FREE)
743                                 alloc = (random () % 100) < 30;
744                 }
745
746                 if (lookup) {
747                         /* modify threads sometimes look up their own jit infos */
748                         if (modify_thread && random () % 10 < 5) {
749                                 Region *region = choose_random_region (td);
750
751                                 if (region->num_datas > 0) {
752                                         JitInfoData **data = choose_random_data (region);
753                                         guint pos = (*data)->start + random () % (*data)->length;
754                                         MonoJitInfo *ji;
755
756                                         ji = mono_jit_info_table_find (domain, (char*)(gulong) pos);
757
758                                         g_assert (ji->cas_inited);
759                                         g_assert ((*data)->ji == ji);
760                                 }
761                         } else {
762                                 int pos = random () % MAX_ADDR;
763                                 char *addr = (char*)(gulong) pos;
764                                 MonoJitInfo *ji;
765
766                                 ji = mono_jit_info_table_find (domain, addr);
767
768                                 /*
769                                  * FIXME: We are actually not allowed
770                                  * to do this.  By the time we examine
771                                  * the ji another thread might already
772                                  * have removed it.
773                                  */
774                                 if (ji != NULL) {
775                                         g_assert (addr >= (char*)ji->code_start && addr < (char*)ji->code_start + ji->code_size);
776                                         ++lookup_successes;
777                                 } else
778                                         ++lookup_failures;
779                         }
780                 } else if (alloc) {
781                         JitInfoData *data = alloc_random_data (choose_random_region (td));
782
783                         if (data != NULL) {
784                                 mono_jit_info_table_add (domain, data->ji);
785
786                                 ++td->num_datas;
787                         }
788                 } else {
789                         Region *region = choose_random_region (td);
790
791                         if (region->num_datas > 0) {
792                                 JitInfoData **data = choose_random_data (region);
793                                 JitInfoData *free;
794
795                                 mono_jit_info_table_remove (domain, (*data)->ji);
796
797                                 //(*data)->ji->cas_inited = 0; /* marks a free jit info */
798
799                                 free = *data;
800                                 *data = (*data)->next;
801
802                                 free_jit_info_data (td, free);
803
804                                 --region->num_datas;
805                                 --td->num_datas;
806                         }
807                 }
808
809                 if (++i % 100000 == 0) {
810                         int j;
811                         g_print ("num datas %d (%ld - %ld): %d", (int)(td - thread_datas),
812                                  lookup_successes, lookup_failures, td->num_datas);
813                         for (j = 0; j < td->num_regions; ++j)
814                                 g_print ("  %d", td->regions [j].num_datas);
815                         g_print ("\n");
816                 }
817
818                 if (td->num_datas < 100)
819                         mode = MODE_ALLOC;
820                 else if (td->num_datas > 2000)
821                         mode = MODE_FREE;
822         }
823 }
824
825 /*
826 static void
827 small_id_thread_func (gpointer arg)
828 {
829         MonoThread *thread = mono_thread_current ();
830         MonoThreadHazardPointers *hp = mono_hazard_pointer_get ();
831
832         g_print ("my small id is %d\n", (int)thread->small_id);
833         mono_hazard_pointer_clear (hp, 1);
834         sleep (3);
835         g_print ("done %d\n", (int)thread->small_id);
836 }
837 */
838
839 static void
840 jit_info_table_test (MonoDomain *domain)
841 {
842         MonoError error;
843         int i;
844
845         g_print ("testing jit_info_table\n");
846
847         num_threads = NUM_THREADS;
848         thread_datas = g_new0 (ThreadData, num_threads);
849
850         for (i = 0; i < num_threads; ++i) {
851                 int j;
852
853                 thread_datas [i].num_regions = REGIONS_PER_THREAD;
854                 thread_datas [i].regions = g_new0 (Region, REGIONS_PER_THREAD);
855
856                 for (j = 0; j < REGIONS_PER_THREAD; ++j) {
857                         thread_datas [i].regions [j].start = (num_threads * j + i) * REGION_SIZE;
858                         thread_datas [i].regions [j].length = REGION_SIZE;
859                 }
860         }
861
862         test_domain = domain;
863
864         /*
865         for (i = 0; i < 72; ++i)
866                 mono_thread_create (domain, small_id_thread_func, NULL);
867
868         sleep (2);
869         */
870
871         for (i = 0; i < num_threads; ++i) {
872                 mono_thread_create_checked (domain, test_thread_func, &thread_datas [i], &error);
873                 mono_error_assert_ok (&error);
874         }
875 }
876 #endif
877
878 enum {
879         DO_BENCH,
880         DO_REGRESSION,
881         DO_SINGLE_METHOD_REGRESSION,
882         DO_COMPILE,
883         DO_EXEC,
884         DO_DRAW,
885         DO_DEBUGGER
886 };
887
888 typedef struct CompileAllThreadArgs {
889         MonoAssembly *ass;
890         int verbose;
891         guint32 opts;
892         guint32 recompilation_times;
893 } CompileAllThreadArgs;
894
895 static void
896 compile_all_methods_thread_main_inner (CompileAllThreadArgs *args)
897 {
898         MonoAssembly *ass = args->ass;
899         int verbose = args->verbose;
900         MonoImage *image = mono_assembly_get_image (ass);
901         MonoMethod *method;
902         MonoCompile *cfg;
903         int i, count = 0, fail_count = 0;
904
905         for (i = 0; i < mono_image_get_table_rows (image, MONO_TABLE_METHOD); ++i) {
906                 MonoError error;
907                 guint32 token = MONO_TOKEN_METHOD_DEF | (i + 1);
908                 MonoMethodSignature *sig;
909
910                 if (mono_metadata_has_generic_params (image, token))
911                         continue;
912
913                 method = mono_get_method_checked (image, token, NULL, NULL, &error);
914                 if (!method) {
915                         mono_error_cleanup (&error); /* FIXME don't swallow the error */
916                         continue;
917                 }
918                 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
919                     (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL) ||
920                     (method->iflags & METHOD_IMPL_ATTRIBUTE_RUNTIME) ||
921                     (method->flags & METHOD_ATTRIBUTE_ABSTRACT))
922                         continue;
923
924                 if (mono_class_is_gtd (method->klass))
925                         continue;
926                 sig = mono_method_signature (method);
927                 if (!sig) {
928                         char * desc = mono_method_full_name (method, TRUE);
929                         g_print ("Could not retrieve method signature for %s\n", desc);
930                         g_free (desc);
931                         fail_count ++;
932                         continue;
933                 }
934
935                 if (sig->has_type_parameters)
936                         continue;
937
938                 count++;
939                 if (verbose) {
940                         char * desc = mono_method_full_name (method, TRUE);
941                         g_print ("Compiling %d %s\n", count, desc);
942                         g_free (desc);
943                 }
944                 cfg = mini_method_compile (method, mono_get_optimizations_for_method (method, args->opts), mono_get_root_domain (), (JitFlags)JIT_FLAG_DISCARD_RESULTS, 0, -1);
945                 if (cfg->exception_type != MONO_EXCEPTION_NONE) {
946                         printf ("Compilation of %s failed with exception '%s':\n", mono_method_full_name (cfg->method, TRUE), cfg->exception_message);
947                         fail_count ++;
948                 }
949                 mono_destroy_compile (cfg);
950         }
951
952         if (fail_count)
953                 exit (1);
954 }
955
956 static void
957 compile_all_methods_thread_main (CompileAllThreadArgs *args)
958 {
959         guint32 i;
960         for (i = 0; i < args->recompilation_times; ++i)
961                 compile_all_methods_thread_main_inner (args);
962 }
963
964 static void
965 compile_all_methods (MonoAssembly *ass, int verbose, guint32 opts, guint32 recompilation_times)
966 {
967         MonoError error;
968         CompileAllThreadArgs args;
969
970         args.ass = ass;
971         args.verbose = verbose;
972         args.opts = opts;
973         args.recompilation_times = recompilation_times;
974
975         /* 
976          * Need to create a mono thread since compilation might trigger
977          * running of managed code.
978          */
979         mono_thread_create_checked (mono_domain_get (), compile_all_methods_thread_main, &args, &error);
980         mono_error_assert_ok (&error);
981
982         mono_thread_manage ();
983 }
984
985 /**
986  * mono_jit_exec:
987  * \param assembly reference to an assembly
988  * \param argc argument count
989  * \param argv argument vector
990  * Start execution of a program.
991  */
992 int 
993 mono_jit_exec (MonoDomain *domain, MonoAssembly *assembly, int argc, char *argv[])
994 {
995         MonoError error;
996         MonoImage *image = mono_assembly_get_image (assembly);
997         MonoMethod *method;
998         guint32 entry = mono_image_get_entry_point (image);
999
1000         if (!entry) {
1001                 g_print ("Assembly '%s' doesn't have an entry point.\n", mono_image_get_filename (image));
1002                 /* FIXME: remove this silly requirement. */
1003                 mono_environment_exitcode_set (1);
1004                 return 1;
1005         }
1006
1007         method = mono_get_method_checked (image, entry, NULL, NULL, &error);
1008         if (method == NULL){
1009                 g_print ("The entry point method could not be loaded due to %s\n", mono_error_get_message (&error));
1010                 mono_error_cleanup (&error);
1011                 mono_environment_exitcode_set (1);
1012                 return 1;
1013         }
1014         
1015         if (mono_llvm_only) {
1016                 MonoObject *exc = NULL;
1017                 int res;
1018
1019                 res = mono_runtime_try_run_main (method, argc, argv, &exc);
1020                 if (exc) {
1021                         mono_unhandled_exception (exc);
1022                         mono_invoke_unhandled_exception_hook (exc);
1023                         g_assert_not_reached ();
1024                 }
1025                 return res;
1026         } else {
1027                 int res = mono_runtime_run_main_checked (method, argc, argv, &error);
1028                 if (!is_ok (&error)) {
1029                         MonoException *ex = mono_error_convert_to_exception (&error);
1030                         if (ex) {
1031                                 mono_unhandled_exception (&ex->object);
1032                                 mono_invoke_unhandled_exception_hook (&ex->object);
1033                                 g_assert_not_reached ();
1034                         }
1035                 }
1036                 return res;
1037         }
1038 }
1039
1040 typedef struct 
1041 {
1042         MonoDomain *domain;
1043         const char *file;
1044         int argc;
1045         char **argv;
1046         guint32 opts;
1047         char *aot_options;
1048 } MainThreadArgs;
1049
1050 static void main_thread_handler (gpointer user_data)
1051 {
1052         MainThreadArgs *main_args = (MainThreadArgs *)user_data;
1053         MonoAssembly *assembly;
1054
1055         if (mono_compile_aot) {
1056                 int i, res;
1057
1058                 /* Treat the other arguments as assemblies to compile too */
1059                 for (i = 0; i < main_args->argc; ++i) {
1060                         assembly = mono_domain_assembly_open (main_args->domain, main_args->argv [i]);
1061                         if (!assembly) {
1062                                 fprintf (stderr, "Can not open image %s\n", main_args->argv [i]);
1063                                 exit (1);
1064                         }
1065                         /* Check that the assembly loaded matches the filename */
1066                         {
1067                                 MonoImageOpenStatus status;
1068                                 MonoImage *img;
1069
1070                                 img = mono_image_open (main_args->argv [i], &status);
1071                                 if (img && strcmp (img->name, assembly->image->name)) {
1072                                         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);
1073                                         exit (1);
1074                                 }
1075                         }
1076                         res = mono_compile_assembly (assembly, main_args->opts, main_args->aot_options);
1077                         if (res != 0) {
1078                                 fprintf (stderr, "AOT of image %s failed.\n", main_args->argv [i]);
1079                                 exit (1);
1080                         }
1081                 }
1082         } else {
1083                 assembly = mono_domain_assembly_open (main_args->domain, main_args->file);
1084                 if (!assembly){
1085                         fprintf (stderr, "Can not open image %s\n", main_args->file);
1086                         exit (1);
1087                 }
1088
1089                 /* 
1090                  * This must be done in a thread managed by mono since it can invoke
1091                  * managed code.
1092                  */
1093                 if (main_args->opts & MONO_OPT_PRECOMP)
1094                         mono_precompile_assemblies ();
1095
1096                 mono_jit_exec (main_args->domain, assembly, main_args->argc, main_args->argv);
1097         }
1098 }
1099
1100 static int
1101 load_agent (MonoDomain *domain, char *desc)
1102 {
1103         MonoError error;
1104         char* col = strchr (desc, ':'); 
1105         char *agent, *args;
1106         MonoAssembly *agent_assembly;
1107         MonoImage *image;
1108         MonoMethod *method;
1109         guint32 entry;
1110         MonoArray *main_args;
1111         gpointer pa [1];
1112         MonoImageOpenStatus open_status;
1113
1114         if (col) {
1115                 agent = (char *)g_memdup (desc, col - desc + 1);
1116                 agent [col - desc] = '\0';
1117                 args = col + 1;
1118         } else {
1119                 agent = g_strdup (desc);
1120                 args = NULL;
1121         }
1122
1123         agent_assembly = mono_assembly_open_predicate (agent, FALSE, FALSE, NULL, NULL, &open_status);
1124         if (!agent_assembly) {
1125                 fprintf (stderr, "Cannot open agent assembly '%s': %s.\n", agent, mono_image_strerror (open_status));
1126                 g_free (agent);
1127                 return 2;
1128         }
1129
1130         /* 
1131          * Can't use mono_jit_exec (), as it sets things which might confuse the
1132          * real Main method.
1133          */
1134         image = mono_assembly_get_image (agent_assembly);
1135         entry = mono_image_get_entry_point (image);
1136         if (!entry) {
1137                 g_print ("Assembly '%s' doesn't have an entry point.\n", mono_image_get_filename (image));
1138                 g_free (agent);
1139                 return 1;
1140         }
1141
1142         method = mono_get_method_checked (image, entry, NULL, NULL, &error);
1143         if (method == NULL){
1144                 g_print ("The entry point method of assembly '%s' could not be loaded due to %s\n", agent, mono_error_get_message (&error));
1145                 mono_error_cleanup (&error);
1146                 g_free (agent);
1147                 return 1;
1148         }
1149         
1150         mono_thread_set_main (mono_thread_current ());
1151
1152         if (args) {
1153                 main_args = (MonoArray*)mono_array_new_checked (domain, mono_defaults.string_class, 1, &error);
1154                 if (main_args) {
1155                         MonoString *str = mono_string_new_checked (domain, args, &error);
1156                         if (str)
1157                                 mono_array_set (main_args, MonoString*, 0, str);
1158                 }
1159         } else {
1160                 main_args = (MonoArray*)mono_array_new_checked (domain, mono_defaults.string_class, 0, &error);
1161         }
1162         if (!main_args) {
1163                 g_print ("Could not allocate array for main args of assembly '%s' due to %s\n", agent, mono_error_get_message (&error));
1164                 mono_error_cleanup (&error);
1165                 g_free (agent);
1166                 return 1;
1167         }
1168         
1169
1170         pa [0] = main_args;
1171         /* Pass NULL as 'exc' so unhandled exceptions abort the runtime */
1172         mono_runtime_invoke_checked (method, NULL, pa, &error);
1173         if (!is_ok (&error)) {
1174                 g_print ("The entry point method of assembly '%s' could not execute due to %s\n", agent, mono_error_get_message (&error));
1175                 mono_error_cleanup (&error);
1176                 g_free (agent);
1177                 return 1;
1178         }
1179
1180         g_free (agent);
1181         return 0;
1182 }
1183
1184 static void
1185 mini_usage_jitdeveloper (void)
1186 {
1187         int i;
1188         
1189         fprintf (stdout,
1190                  "Runtime and JIT debugging options:\n"
1191                  "    --apply-bindings=FILE  Apply assembly bindings from FILE (only for AOT)\n"
1192                  "    --breakonex            Inserts a breakpoint on exceptions\n"
1193                  "    --break METHOD         Inserts a breakpoint at METHOD entry\n"
1194                  "    --break-at-bb METHOD N Inserts a breakpoint in METHOD at BB N\n"
1195                  "    --compile METHOD       Just compile METHOD in assembly\n"
1196                  "    --compile-all=N        Compiles all the methods in the assembly multiple times (default: 1)\n"
1197                  "    --ncompile N           Number of times to compile METHOD (default: 1)\n"
1198                  "    --print-vtable         Print the vtable of all used classes\n"
1199                  "    --regression           Runs the regression test contained in the assembly\n"
1200                  "    --single-method=OPTS   Runs regressions with only one method optimized with OPTS at any time\n"
1201                  "    --statfile FILE        Sets the stat file to FILE\n"
1202                  "    --stats                Print statistics about the JIT operations\n"
1203                  "    --inject-async-exc METHOD OFFSET Inject an asynchronous exception at METHOD\n"
1204                  "    --verify-all           Run the verifier on all assemblies and methods\n"
1205                  "    --full-aot             Avoid JITting any code\n"
1206                  "    --llvmonly             Use LLVM compiled code only\n"
1207                  "    --agent=ASSEMBLY[:ARG] Loads the specific agent assembly and executes its Main method with the given argument before loading the main assembly.\n"
1208                  "    --no-x86-stack-align   Don't align stack on x86\n"
1209                  "\n"
1210                  "The options supported by MONO_DEBUG can also be passed on the command line.\n"
1211                  "\n"
1212                  "Other options:\n" 
1213                  "    --graph[=TYPE] METHOD  Draws a graph of the specified method:\n");
1214         
1215         for (i = 0; i < G_N_ELEMENTS (graph_names); ++i) {
1216                 fprintf (stdout, "                           %-10s %s\n", graph_names [i].name, graph_names [i].desc);
1217         }
1218 }
1219
1220 static void
1221 mini_usage_list_opt (void)
1222 {
1223         int i;
1224         
1225         for (i = 0; i < G_N_ELEMENTS (opt_names); ++i)
1226                 fprintf (stdout, "                           %-10s %s\n", optflag_get_name (i), optflag_get_desc (i));
1227 }
1228
1229 static void
1230 mini_usage (void)
1231 {
1232         fprintf (stdout,
1233                 "Usage is: mono [options] program [program-options]\n"
1234                 "\n"
1235                 "Development:\n"
1236                 "    --aot[=<options>]      Compiles the assembly to native code\n"
1237                 "    --debug[=<options>]    Enable debugging support, use --help-debug for details\n"
1238                 "    --debugger-agent=options Enable the debugger agent\n"
1239                 "    --profile[=profiler]   Runs in profiling mode with the specified profiler module\n"
1240                 "    --trace[=EXPR]         Enable tracing, use --help-trace for details\n"
1241                 "    --jitmap               Output a jit method map to /tmp/perf-PID.map\n"
1242                 "    --help-devel           Shows more options available to developers\n"
1243                 "\n"
1244                 "Runtime:\n"
1245                 "    --config FILE          Loads FILE as the Mono config\n"
1246                 "    --verbose, -v          Increases the verbosity level\n"
1247                 "    --help, -h             Show usage information\n"
1248                 "    --version, -V          Show version information\n"
1249                 "    --runtime=VERSION      Use the VERSION runtime, instead of autodetecting\n"
1250                 "    --optimize=OPT         Turns on or off a specific optimization\n"
1251                 "                           Use --list-opt to get a list of optimizations\n"
1252 #ifndef DISABLE_SECURITY
1253                 "    --security[=mode]      Turns on the unsupported security manager (off by default)\n"
1254                 "                           mode is one of cas, core-clr, verifiable or validil\n"
1255 #endif
1256                 "    --attach=OPTIONS       Pass OPTIONS to the attach agent in the runtime.\n"
1257                 "                           Currently the only supported option is 'disable'.\n"
1258                 "    --llvm, --nollvm       Controls whenever the runtime uses LLVM to compile code.\n"
1259                 "    --gc=[sgen,boehm]      Select SGen or Boehm GC (runs mono or mono-sgen)\n"
1260 #ifdef TARGET_OSX
1261                 "    --arch=[32,64]         Select architecture (runs mono32 or mono64)\n"
1262 #endif
1263 #ifdef HOST_WIN32
1264                 "    --mixed-mode           Enable mixed-mode image support.\n"
1265 #endif
1266                 "    --handlers             Install custom handlers, use --help-handlers for details.\n"
1267                 "    --aot-path=PATH        List of additional directories to search for AOT images.\n"
1268           );
1269 }
1270
1271 static void
1272 mini_trace_usage (void)
1273 {
1274         fprintf (stdout,
1275                  "Tracing options:\n"
1276                  "   --trace[=EXPR]        Trace every call, optional EXPR controls the scope\n"
1277                  "\n"
1278                  "EXPR is composed of:\n"
1279                  "    all                  All assemblies\n"
1280                  "    none                 No assemblies\n"
1281                  "    program              Entry point assembly\n"
1282                  "    assembly             Specifies an assembly\n"
1283                  "    wrapper              All wrappers bridging native and managed code\n"
1284                  "    M:Type:Method        Specifies a method\n"
1285                  "    N:Namespace          Specifies a namespace\n"
1286                  "    T:Type               Specifies a type\n"
1287                  "    E:Type               Specifies stack traces for an exception type\n"
1288                  "    EXPR                 Includes expression\n"
1289                  "    -EXPR                Excludes expression\n"
1290                  "    EXPR,EXPR            Multiple expressions\n"
1291                  "    disabled             Don't print any output until toggled via SIGUSR2\n");
1292 }
1293
1294 static void
1295 mini_debug_usage (void)
1296 {
1297         fprintf (stdout,
1298                  "Debugging options:\n"
1299                  "   --debug[=OPTIONS]     Enable debugging support, optional OPTIONS is a comma\n"
1300                  "                         separated list of options\n"
1301                  "\n"
1302                  "OPTIONS is composed of:\n"
1303                  "    casts                Enable more detailed InvalidCastException messages.\n"
1304                  "    mdb-optimizations    Disable some JIT optimizations which are normally\n"
1305                  "                         disabled when running inside the debugger.\n"
1306                  "                         This is useful if you plan to attach to the running\n"
1307                  "                         process with the debugger.\n");
1308 }
1309
1310 #if defined(MONO_ARCH_ARCHITECTURE)
1311 /* Redefine MONO_ARCHITECTURE to include more information */
1312 #undef MONO_ARCHITECTURE
1313 #define MONO_ARCHITECTURE MONO_ARCH_ARCHITECTURE
1314 #endif
1315
1316 static const char info[] =
1317 #ifdef HAVE_KW_THREAD
1318         "\tTLS:           __thread\n"
1319 #else
1320         "\tTLS:           normal\n"
1321 #endif /* HAVE_KW_THREAD */
1322 #ifdef MONO_ARCH_SIGSEGV_ON_ALTSTACK
1323     "\tSIGSEGV:       altstack\n"
1324 #else
1325     "\tSIGSEGV:       normal\n"
1326 #endif
1327 #ifdef HAVE_EPOLL
1328     "\tNotifications: epoll\n"
1329 #elif defined(HAVE_KQUEUE)
1330     "\tNotification:  kqueue\n"
1331 #else
1332     "\tNotification:  Thread + polling\n"
1333 #endif
1334         "\tArchitecture:  " MONO_ARCHITECTURE "\n"
1335         "\tDisabled:      " DISABLED_FEATURES "\n"
1336         "\tMisc:          "
1337 #ifdef MONO_SMALL_CONFIG
1338         "smallconfig "
1339 #endif
1340 #ifdef MONO_BIG_ARRAYS
1341         "bigarrays "
1342 #endif
1343 #if defined(MONO_ARCH_SOFT_DEBUG_SUPPORTED) && !defined(DISABLE_SOFT_DEBUG)
1344         "softdebug "
1345 #endif
1346                 "\n"
1347 #ifdef MONO_ARCH_LLVM_SUPPORTED
1348 #ifdef ENABLE_LLVM
1349         "\tLLVM:          yes(" LLVM_VERSION ")\n"
1350 #else
1351         "\tLLVM:          supported, not enabled.\n"
1352 #endif
1353 #endif
1354         "";
1355
1356 #ifndef MONO_ARCH_AOT_SUPPORTED
1357 #define error_if_aot_unsupported() do {fprintf (stderr, "AOT compilation is not supported on this platform.\n"); exit (1);} while (0)
1358 #else
1359 #define error_if_aot_unsupported()
1360 #endif
1361
1362 static gboolean enable_debugging;
1363
1364 /**
1365  * mono_jit_parse_options:
1366  *
1367  * Process the command line options in \p argv as done by the runtime executable.
1368  * This should be called before \c mono_jit_init.
1369  */
1370 void
1371 mono_jit_parse_options (int argc, char * argv[])
1372 {
1373         int i;
1374         char *trace_options = NULL;
1375         int mini_verbose = 0;
1376         guint32 opt;
1377
1378         /* 
1379          * Some options have no effect here, since they influence the behavior of 
1380          * mono_main ().
1381          */
1382
1383         opt = mono_parse_default_optimizations (NULL);
1384
1385         /* FIXME: Avoid code duplication */
1386         for (i = 0; i < argc; ++i) {
1387                 if (argv [i] [0] != '-')
1388                         break;
1389                 if (strncmp (argv [i], "--debugger-agent=", 17) == 0) {
1390                         MonoDebugOptions *opt = mini_get_debug_options ();
1391
1392                         mono_debugger_agent_parse_options (argv [i] + 17);
1393                         opt->mdb_optimizations = TRUE;
1394                         enable_debugging = TRUE;
1395                 } else if (!strcmp (argv [i], "--soft-breakpoints")) {
1396                         MonoDebugOptions *opt = mini_get_debug_options ();
1397
1398                         opt->soft_breakpoints = TRUE;
1399                         opt->explicit_null_checks = TRUE;
1400                 } else if (strncmp (argv [i], "--optimize=", 11) == 0) {
1401                         opt = parse_optimizations (opt, argv [i] + 11, TRUE);
1402                         mono_set_optimizations (opt);
1403                 } else if (strncmp (argv [i], "-O=", 3) == 0) {
1404                         opt = parse_optimizations (opt, argv [i] + 3, TRUE);
1405                         mono_set_optimizations (opt);
1406                 } else if (strcmp (argv [i], "--trace") == 0) {
1407                         trace_options = (char*)"";
1408                 } else if (strncmp (argv [i], "--trace=", 8) == 0) {
1409                         trace_options = &argv [i][8];
1410                 } else if (strcmp (argv [i], "--verbose") == 0 || strcmp (argv [i], "-v") == 0) {
1411                         mini_verbose++;
1412                 } else if (strcmp (argv [i], "--breakonex") == 0) {
1413                         MonoDebugOptions *opt = mini_get_debug_options ();
1414
1415                         opt->break_on_exc = TRUE;
1416                 } else if (strcmp (argv [i], "--stats") == 0) {
1417                         mono_counters_enable (-1);
1418                         mono_stats.enabled = TRUE;
1419                         mono_jit_stats.enabled = TRUE;
1420                 } else if (strcmp (argv [i], "--break") == 0) {
1421                         if (i+1 >= argc){
1422                                 fprintf (stderr, "Missing method name in --break command line option\n");
1423                                 exit (1);
1424                         }
1425                         
1426                         if (!mono_debugger_insert_breakpoint (argv [++i], FALSE))
1427                                 fprintf (stderr, "Error: invalid method name '%s'\n", argv [i]);
1428                 } else if (strncmp (argv[i], "--gc-params=", 12) == 0) {
1429                         mono_gc_params_set (argv[i] + 12);
1430                 } else if (strncmp (argv[i], "--gc-debug=", 11) == 0) {
1431                         mono_gc_debug_set (argv[i] + 11);
1432                 } else if (strcmp (argv [i], "--llvm") == 0) {
1433 #ifndef MONO_ARCH_LLVM_SUPPORTED
1434                         fprintf (stderr, "Mono Warning: --llvm not supported on this platform.\n");
1435 #elif !defined(ENABLE_LLVM)
1436                         fprintf (stderr, "Mono Warning: --llvm not enabled in this runtime.\n");
1437 #else
1438                         mono_use_llvm = TRUE;
1439 #endif
1440                 } else if (argv [i][0] == '-' && argv [i][1] == '-' && mini_parse_debug_option (argv [i] + 2)) {
1441                 } else {
1442                         fprintf (stderr, "Unsupported command line option: '%s'\n", argv [i]);
1443                         exit (1);
1444                 }
1445         }
1446
1447         if (trace_options != NULL) {
1448                 /* 
1449                  * Need to call this before mini_init () so we can trace methods 
1450                  * compiled there too.
1451                  */
1452                 mono_jit_trace_calls = mono_trace_parse_options (trace_options);
1453                 if (mono_jit_trace_calls == NULL)
1454                         exit (1);
1455         }
1456
1457         if (mini_verbose)
1458                 mono_set_verbose_level (mini_verbose);
1459 }
1460
1461 static void
1462 mono_set_use_smp (int use_smp)
1463 {
1464 #if HAVE_SCHED_SETAFFINITY
1465         if (!use_smp) {
1466                 unsigned long proc_mask = 1;
1467 #ifdef GLIBC_BEFORE_2_3_4_SCHED_SETAFFINITY
1468                 sched_setaffinity (getpid(), (gpointer)&proc_mask);
1469 #else
1470                 sched_setaffinity (getpid(), sizeof (unsigned long), (const cpu_set_t *)&proc_mask);
1471 #endif
1472         }
1473 #endif
1474 }
1475
1476 static void
1477 switch_gc (char* argv[], const char* target_gc)
1478 {
1479         GString *path;
1480
1481         if (!strcmp (mono_gc_get_gc_name (), target_gc)) {
1482                 return;
1483         }
1484
1485         path = g_string_new (argv [0]);
1486
1487         /*Running mono without any argument*/
1488         if (strstr (argv [0], "-sgen"))
1489                 g_string_truncate (path, path->len - 5);
1490         else if (strstr (argv [0], "-boehm"))
1491                 g_string_truncate (path, path->len - 6);
1492
1493         g_string_append_c (path, '-');
1494         g_string_append (path, target_gc);
1495
1496 #ifdef HAVE_EXECVP
1497         execvp (path->str, argv);
1498         fprintf (stderr, "Error: Failed to switch to %s gc. mono-%s is not installed.\n", target_gc, target_gc);
1499 #else
1500         fprintf (stderr, "Error: --gc=<NAME> option not supported on this platform.\n");
1501 #endif
1502 }
1503
1504 #ifdef TARGET_OSX
1505
1506 /*
1507  * tries to increase the minimum number of files, if the number is below 1024
1508  */
1509 static void
1510 darwin_change_default_file_handles ()
1511 {
1512         struct rlimit limit;
1513         
1514         if (getrlimit (RLIMIT_NOFILE, &limit) == 0){
1515                 if (limit.rlim_cur < 1024){
1516                         limit.rlim_cur = MAX(1024,limit.rlim_cur);
1517                         setrlimit (RLIMIT_NOFILE, &limit);
1518                 }
1519         }
1520 }
1521
1522 static void
1523 switch_arch (char* argv[], const char* target_arch)
1524 {
1525         GString *path;
1526         gsize arch_offset;
1527
1528         if ((strcmp (target_arch, "32") == 0 && strcmp (MONO_ARCHITECTURE, "x86") == 0) ||
1529                 (strcmp (target_arch, "64") == 0 && strcmp (MONO_ARCHITECTURE, "amd64") == 0)) {
1530                 return; /* matching arch loaded */
1531         }
1532
1533         path = g_string_new (argv [0]);
1534         arch_offset = path->len -2; /* last two characters */
1535
1536         /* Remove arch suffix if present */
1537         if (strstr (&path->str[arch_offset], "32") || strstr (&path->str[arch_offset], "64")) {
1538                 g_string_truncate (path, arch_offset);
1539         }
1540
1541         g_string_append (path, target_arch);
1542
1543         if (execvp (path->str, argv) < 0) {
1544                 fprintf (stderr, "Error: --arch=%s Failed to switch to '%s'.\n", target_arch, path->str);
1545                 exit (1);
1546         }
1547 }
1548
1549 #endif
1550
1551 #define MONO_HANDLERS_ARGUMENT "--handlers="
1552 #define MONO_HANDLERS_ARGUMENT_LEN G_N_ELEMENTS(MONO_HANDLERS_ARGUMENT)-1
1553
1554 static void
1555 apply_root_domain_configuration_file_bindings (MonoDomain *domain, char *root_domain_configuration_file)
1556 {
1557         g_assert (domain->setup == NULL || domain->setup->configuration_file == NULL);
1558         g_assert (!domain->assembly_bindings_parsed);
1559
1560         mono_domain_parse_assembly_bindings (domain, 0, 0, root_domain_configuration_file);
1561
1562 }
1563
1564 /**
1565  * mono_main:
1566  * \param argc number of arguments in the argv array
1567  * \param argv array of strings containing the startup arguments
1568  * Launches the Mono JIT engine and parses all the command line options
1569  * in the same way that the mono command line VM would.
1570  */
1571 int
1572 mono_main (int argc, char* argv[])
1573 {
1574         MainThreadArgs main_args;
1575         MonoAssembly *assembly;
1576         MonoMethodDesc *desc;
1577         MonoMethod *method;
1578         MonoCompile *cfg;
1579         MonoDomain *domain;
1580         MonoImageOpenStatus open_status;
1581         const char* aname, *mname = NULL;
1582         char *config_file = NULL;
1583         int i, count = 1;
1584         guint32 opt, action = DO_EXEC, recompilation_times = 1;
1585         MonoGraphOptions mono_graph_options = (MonoGraphOptions)0;
1586         int mini_verbose = 0;
1587         gboolean enable_profile = FALSE;
1588         char *trace_options = NULL;
1589         char *profile_options = NULL;
1590         char *aot_options = NULL;
1591         char *forced_version = NULL;
1592         GPtrArray *agents = NULL;
1593         char *attach_options = NULL;
1594         char *extra_bindings_config_file = NULL;
1595 #ifdef MONO_JIT_INFO_TABLE_TEST
1596         int test_jit_info_table = FALSE;
1597 #endif
1598 #ifdef HOST_WIN32
1599         int mixed_mode = FALSE;
1600 #endif
1601
1602 #ifdef MOONLIGHT
1603 #ifndef HOST_WIN32
1604         /* stdout defaults to block buffering if it's not writing to a terminal, which
1605          * happens with our test harness: we redirect stdout to capture it. Force line
1606          * buffering in all cases. */
1607         setlinebuf (stdout);
1608 #endif
1609 #endif
1610
1611         setlocale (LC_ALL, "");
1612
1613 #if TARGET_OSX
1614         darwin_change_default_file_handles ();
1615 #endif
1616
1617         if (g_hasenv ("MONO_NO_SMP"))
1618                 mono_set_use_smp (FALSE);
1619         
1620         g_log_set_always_fatal (G_LOG_LEVEL_ERROR);
1621         g_log_set_fatal_mask (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR);
1622
1623         opt = mono_parse_default_optimizations (NULL);
1624
1625         for (i = 1; i < argc; ++i) {
1626                 if (argv [i] [0] != '-')
1627                         break;
1628                 if (strcmp (argv [i], "--regression") == 0) {
1629                         action = DO_REGRESSION;
1630                 } else if (strncmp (argv [i], "--single-method=", 16) == 0) {
1631                         char *full_opts = g_strdup_printf ("-all,%s", argv [i] + 16);
1632                         action = DO_SINGLE_METHOD_REGRESSION;
1633                         mono_single_method_regression_opt = parse_optimizations (opt, full_opts, TRUE);
1634                         g_free (full_opts);
1635                 } else if (strcmp (argv [i], "--verbose") == 0 || strcmp (argv [i], "-v") == 0) {
1636                         mini_verbose++;
1637                 } else if (strcmp (argv [i], "--version") == 0 || strcmp (argv [i], "-V") == 0) {
1638                         char *build = mono_get_runtime_build_info ();
1639                         char *gc_descr;
1640
1641                         g_print ("Mono JIT compiler version %s\nCopyright (C) 2002-2014 Novell, Inc, Xamarin Inc and Contributors. www.mono-project.com\n", build);
1642                         g_free (build);
1643                         g_print (info);
1644                         gc_descr = mono_gc_get_description ();
1645                         g_print ("\tGC:            %s\n", gc_descr);
1646                         g_free (gc_descr);
1647                         return 0;
1648                 } else if (strcmp (argv [i], "--help") == 0 || strcmp (argv [i], "-h") == 0) {
1649                         mini_usage ();
1650                         return 0;
1651                 } else if (strcmp (argv [i], "--help-trace") == 0){
1652                         mini_trace_usage ();
1653                         return 0;
1654                 } else if (strcmp (argv [i], "--help-devel") == 0){
1655                         mini_usage_jitdeveloper ();
1656                         return 0;
1657                 } else if (strcmp (argv [i], "--help-debug") == 0){
1658                         mini_debug_usage ();
1659                         return 0;
1660                 } else if (strcmp (argv [i], "--list-opt") == 0){
1661                         mini_usage_list_opt ();
1662                         return 0;
1663                 } else if (strncmp (argv [i], "--statfile", 10) == 0) {
1664                         if (i + 1 >= argc){
1665                                 fprintf (stderr, "error: --statfile requires a filename argument\n");
1666                                 return 1;
1667                         }
1668                         mini_stats_fd = fopen (argv [++i], "w+");
1669                 } else if (strncmp (argv [i], "--optimize=", 11) == 0) {
1670                         opt = parse_optimizations (opt, argv [i] + 11, TRUE);
1671                 } else if (strncmp (argv [i], "-O=", 3) == 0) {
1672                         opt = parse_optimizations (opt, argv [i] + 3, TRUE);
1673                 } else if (strncmp (argv [i], "--bisect=", 9) == 0) {
1674                         char *param = argv [i] + 9;
1675                         char *sep = strchr (param, ':');
1676                         if (!sep) {
1677                                 fprintf (stderr, "Error: --bisect requires OPT:FILENAME\n");
1678                                 return 1;
1679                         }
1680                         char *opt_string = g_strndup (param, sep - param);
1681                         guint32 opt = parse_optimizations (0, opt_string, FALSE);
1682                         g_free (opt_string);
1683                         mono_set_bisect_methods (opt, sep + 1);
1684                 } else if (strcmp (argv [i], "--gc=sgen") == 0) {
1685                         switch_gc (argv, "sgen");
1686                 } else if (strcmp (argv [i], "--gc=boehm") == 0) {
1687                         switch_gc (argv, "boehm");
1688                 } else if (strncmp (argv[i], "--gc-params=", 12) == 0) {
1689                         mono_gc_params_set (argv[i] + 12);
1690                 } else if (strncmp (argv[i], "--gc-debug=", 11) == 0) {
1691                         mono_gc_debug_set (argv[i] + 11);
1692                 }
1693 #ifdef TARGET_OSX
1694                 else if (strcmp (argv [i], "--arch=32") == 0) {
1695                         switch_arch (argv, "32");
1696                 } else if (strcmp (argv [i], "--arch=64") == 0) {
1697                         switch_arch (argv, "64");
1698                 }
1699 #endif
1700                 else if (strcmp (argv [i], "--config") == 0) {
1701                         if (i +1 >= argc){
1702                                 fprintf (stderr, "error: --config requires a filename argument\n");
1703                                 return 1;
1704                         }
1705                         config_file = argv [++i];
1706 #ifdef HOST_WIN32
1707                 } else if (strcmp (argv [i], "--mixed-mode") == 0) {
1708                         mixed_mode = TRUE;
1709 #endif
1710                 } else if (strcmp (argv [i], "--ncompile") == 0) {
1711                         if (i + 1 >= argc){
1712                                 fprintf (stderr, "error: --ncompile requires an argument\n");
1713                                 return 1;
1714                         }
1715                         count = atoi (argv [++i]);
1716                         action = DO_BENCH;
1717                 } else if (strcmp (argv [i], "--trace") == 0) {
1718                         trace_options = (char*)"";
1719                 } else if (strncmp (argv [i], "--trace=", 8) == 0) {
1720                         trace_options = &argv [i][8];
1721                 } else if (strcmp (argv [i], "--breakonex") == 0) {
1722                         MonoDebugOptions *opt = mini_get_debug_options ();
1723
1724                         opt->break_on_exc = TRUE;
1725                 } else if (strcmp (argv [i], "--break") == 0) {
1726                         if (i+1 >= argc){
1727                                 fprintf (stderr, "Missing method name in --break command line option\n");
1728                                 return 1;
1729                         }
1730                         
1731                         if (!mono_debugger_insert_breakpoint (argv [++i], FALSE))
1732                                 fprintf (stderr, "Error: invalid method name '%s'\n", argv [i]);
1733                 } else if (strcmp (argv [i], "--break-at-bb") == 0) {
1734                         if (i + 2 >= argc) {
1735                                 fprintf (stderr, "Missing method name or bb num in --break-at-bb command line option.");
1736                                 return 1;
1737                         }
1738                         mono_break_at_bb_method = mono_method_desc_new (argv [++i], TRUE);
1739                         if (mono_break_at_bb_method == NULL) {
1740                                 fprintf (stderr, "Method name is in a bad format in --break-at-bb command line option.");
1741                                 return 1;
1742                         }
1743                         mono_break_at_bb_bb_num = atoi (argv [++i]);
1744                 } else if (strcmp (argv [i], "--inject-async-exc") == 0) {
1745                         if (i + 2 >= argc) {
1746                                 fprintf (stderr, "Missing method name or position in --inject-async-exc command line option\n");
1747                                 return 1;
1748                         }
1749                         mono_inject_async_exc_method = mono_method_desc_new (argv [++i], TRUE);
1750                         if (mono_inject_async_exc_method == NULL) {
1751                                 fprintf (stderr, "Method name is in a bad format in --inject-async-exc command line option\n");
1752                                 return 1;
1753                         }
1754                         mono_inject_async_exc_pos = atoi (argv [++i]);
1755                 } else if (strcmp (argv [i], "--verify-all") == 0) {
1756                         mono_verifier_enable_verify_all ();
1757                 } else if (strcmp (argv [i], "--full-aot") == 0) {
1758                         mono_jit_set_aot_mode (MONO_AOT_MODE_FULL);
1759                 } else if (strcmp (argv [i], "--llvmonly") == 0) {
1760                         mono_jit_set_aot_mode (MONO_AOT_MODE_LLVMONLY);
1761                 } else if (strcmp (argv [i], "--hybrid-aot") == 0) {
1762                         mono_jit_set_aot_mode (MONO_AOT_MODE_HYBRID);
1763                 } else if (strcmp (argv [i], "--print-vtable") == 0) {
1764                         mono_print_vtable = TRUE;
1765                 } else if (strcmp (argv [i], "--stats") == 0) {
1766                         mono_counters_enable (-1);
1767                         mono_stats.enabled = TRUE;
1768                         mono_jit_stats.enabled = TRUE;
1769 #ifndef DISABLE_AOT
1770                 } else if (strcmp (argv [i], "--aot") == 0) {
1771                         error_if_aot_unsupported ();
1772                         mono_compile_aot = TRUE;
1773                 } else if (strncmp (argv [i], "--aot=", 6) == 0) {
1774                         error_if_aot_unsupported ();
1775                         mono_compile_aot = TRUE;
1776                         aot_options = &argv [i][6];
1777 #endif
1778                 } else if (strncmp (argv [i], "--apply-bindings=", 17) == 0) {
1779                         extra_bindings_config_file = &argv[i][17];
1780                 } else if (strncmp (argv [i], "--aot-path=", 11) == 0) {
1781                         char **splitted;
1782
1783                         splitted = g_strsplit (argv [i] + 11, G_SEARCHPATH_SEPARATOR_S, 1000);
1784                         while (*splitted) {
1785                                 char *tmp = *splitted;
1786                                 mono_aot_paths = g_list_append (mono_aot_paths, g_strdup (tmp));
1787                                 g_free (tmp);
1788                                 splitted++;
1789                         }
1790                 } else if (strncmp (argv [i], "--compile-all=", 14) == 0) {
1791                         action = DO_COMPILE;
1792                         recompilation_times = atoi (argv [i] + 14);
1793                 } else if (strcmp (argv [i], "--compile-all") == 0) {
1794                         action = DO_COMPILE;
1795                 } else if (strncmp (argv [i], "--runtime=", 10) == 0) {
1796                         forced_version = &argv [i][10];
1797                 } else if (strcmp (argv [i], "--jitmap") == 0) {
1798                         mono_enable_jit_map ();
1799                 } else if (strcmp (argv [i], "--profile") == 0) {
1800                         enable_profile = TRUE;
1801                         profile_options = NULL;
1802                 } else if (strncmp (argv [i], "--profile=", 10) == 0) {
1803                         enable_profile = TRUE;
1804                         profile_options = argv [i] + 10;
1805                 } else if (strncmp (argv [i], "--agent=", 8) == 0) {
1806                         if (agents == NULL)
1807                                 agents = g_ptr_array_new ();
1808                         g_ptr_array_add (agents, argv [i] + 8);
1809                 } else if (strncmp (argv [i], "--attach=", 9) == 0) {
1810                         attach_options = argv [i] + 9;
1811                 } else if (strcmp (argv [i], "--compile") == 0) {
1812                         if (i + 1 >= argc){
1813                                 fprintf (stderr, "error: --compile option requires a method name argument\n");
1814                                 return 1;
1815                         }
1816                         
1817                         mname = argv [++i];
1818                         action = DO_BENCH;
1819                 } else if (strncmp (argv [i], "--graph=", 8) == 0) {
1820                         if (i + 1 >= argc){
1821                                 fprintf (stderr, "error: --graph option requires a method name argument\n");
1822                                 return 1;
1823                         }
1824                         
1825                         mono_graph_options = mono_parse_graph_options (argv [i] + 8);
1826                         mname = argv [++i];
1827                         action = DO_DRAW;
1828                 } else if (strcmp (argv [i], "--graph") == 0) {
1829                         if (i + 1 >= argc){
1830                                 fprintf (stderr, "error: --graph option requires a method name argument\n");
1831                                 return 1;
1832                         }
1833                         
1834                         mname = argv [++i];
1835                         mono_graph_options = MONO_GRAPH_CFG;
1836                         action = DO_DRAW;
1837                 } else if (strcmp (argv [i], "--debug") == 0) {
1838                         enable_debugging = TRUE;
1839                 } else if (strncmp (argv [i], "--debug=", 8) == 0) {
1840                         enable_debugging = TRUE;
1841                         if (!parse_debug_options (argv [i] + 8))
1842                                 return 1;
1843                 } else if (strncmp (argv [i], "--debugger-agent=", 17) == 0) {
1844                         MonoDebugOptions *opt = mini_get_debug_options ();
1845
1846                         mono_debugger_agent_parse_options (argv [i] + 17);
1847                         opt->mdb_optimizations = TRUE;
1848                         enable_debugging = TRUE;
1849                 } else if (strcmp (argv [i], "--security") == 0) {
1850 #ifndef DISABLE_SECURITY
1851                         mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1852 #else
1853                         fprintf (stderr, "error: --security: not compiled with security manager support");
1854                         return 1;
1855 #endif
1856                 } else if (strncmp (argv [i], "--security=", 11) == 0) {
1857                         /* Note: validil, and verifiable need to be
1858                            accepted even if DISABLE_SECURITY is defined. */
1859
1860                         if (strcmp (argv [i] + 11, "core-clr") == 0) {
1861 #ifndef DISABLE_SECURITY
1862                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1863                                 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1864 #else
1865                                 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1866                                 return 1;
1867 #endif
1868                         } else if (strcmp (argv [i] + 11, "core-clr-test") == 0) {
1869 #ifndef DISABLE_SECURITY
1870                                 /* fixme should we enable verifiable code here?*/
1871                                 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1872                                 mono_security_core_clr_test = TRUE;
1873 #else
1874                                 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1875                                 return 1;
1876 #endif
1877                         } else if (strcmp (argv [i] + 11, "cas") == 0) {
1878 #ifndef DISABLE_SECURITY
1879                                 fprintf (stderr, "warning: --security=cas not supported.");
1880 #else
1881                                 fprintf (stderr, "error: --security: not compiled with CAS support");
1882                                 return 1;
1883 #endif
1884                         } else if (strcmp (argv [i] + 11, "validil") == 0) {
1885                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VALID);
1886                         } else if (strcmp (argv [i] + 11, "verifiable") == 0) {
1887                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1888                         } else {
1889                                 fprintf (stderr, "error: --security= option has invalid argument (cas, core-clr, verifiable or validil)\n");
1890                                 return 1;
1891                         }
1892                 } else if (strcmp (argv [i], "--desktop") == 0) {
1893                         mono_gc_set_desktop_mode ();
1894                         /* Put more desktop-specific optimizations here */
1895                 } else if (strcmp (argv [i], "--server") == 0){
1896                         mono_config_set_server_mode (TRUE);
1897                         /* Put more server-specific optimizations here */
1898                 } else if (strcmp (argv [i], "--inside-mdb") == 0) {
1899                         action = DO_DEBUGGER;
1900                 } else if (strncmp (argv [i], "--wapi=", 7) == 0) {
1901                         fprintf (stderr, "--wapi= option no longer supported\n.");
1902                         return 1;
1903                 } else if (strcmp (argv [i], "--no-x86-stack-align") == 0) {
1904                         mono_do_x86_stack_align = FALSE;
1905 #ifdef MONO_JIT_INFO_TABLE_TEST
1906                 } else if (strcmp (argv [i], "--test-jit-info-table") == 0) {
1907                         test_jit_info_table = TRUE;
1908 #endif
1909                 } else if (strcmp (argv [i], "--llvm") == 0) {
1910 #ifndef MONO_ARCH_LLVM_SUPPORTED
1911                         fprintf (stderr, "Mono Warning: --llvm not supported on this platform.\n");
1912 #elif !defined(ENABLE_LLVM)
1913                         fprintf (stderr, "Mono Warning: --llvm not enabled in this runtime.\n");
1914 #else
1915                         mono_use_llvm = TRUE;
1916 #endif
1917                 } else if (strcmp (argv [i], "--nollvm") == 0){
1918                         mono_use_llvm = FALSE;
1919                 } else if ((strcmp (argv [i], "--interpreter") == 0) || !strcmp (argv [i], "--interp")) {
1920 #ifdef ENABLE_INTERPRETER
1921                         mono_use_interpreter = TRUE;
1922 #else
1923                         fprintf (stderr, "Mono Warning: --interpreter not enabled in this runtime.\n");
1924 #endif
1925                 } else if (strncmp (argv [i], "--interp=", 9) == 0) {
1926 #ifdef ENABLE_INTERPRETER
1927                         mono_use_interpreter = TRUE;
1928                         mono_interp_parse_options (argv [i] + 9);
1929 #else
1930                         fprintf (stderr, "Mono Warning: --interp= not enabled in this runtime.\n");
1931 #endif
1932                 } else if (strncmp (argv [i], "--assembly-loader=", strlen("--assembly-loader=")) == 0) {
1933                         gchar *arg = argv [i] + strlen ("--assembly-loader=");
1934                         if (strcmp (arg, "strict") == 0)
1935                                 mono_loader_set_strict_strong_names (TRUE);
1936                         else if (strcmp (arg, "legacy") == 0)
1937                                 mono_loader_set_strict_strong_names (FALSE);
1938                         else
1939                                 fprintf (stderr, "Warning: unknown argument to --assembly-loader. Should be \"strict\" or \"legacy\"\n");
1940                 } else if (strncmp (argv [i], MONO_HANDLERS_ARGUMENT, MONO_HANDLERS_ARGUMENT_LEN) == 0) {
1941                         //Install specific custom handlers.
1942                         if (!mono_runtime_install_custom_handlers (argv[i] + MONO_HANDLERS_ARGUMENT_LEN)) {
1943                                 fprintf (stderr, "error: " MONO_HANDLERS_ARGUMENT ", one or more unknown handlers: '%s'\n", argv [i]);
1944                                 return 1;
1945                         }
1946                 } else if (strcmp (argv [i], "--help-handlers") == 0) {
1947                         mono_runtime_install_custom_handlers_usage ();
1948                         return 0;
1949                 } else if (argv [i][0] == '-' && argv [i][1] == '-' && mini_parse_debug_option (argv [i] + 2)) {
1950                 } else {
1951                         fprintf (stderr, "Unknown command line option: '%s'\n", argv [i]);
1952                         return 1;
1953                 }
1954         }
1955
1956 #if defined(DISABLE_HW_TRAPS) || defined(MONO_ARCH_DISABLE_HW_TRAPS)
1957         // Signal handlers not available
1958         {
1959                 MonoDebugOptions *opt = mini_get_debug_options ();
1960                 opt->explicit_null_checks = TRUE;
1961         }
1962 #endif
1963
1964         if (!argv [i]) {
1965                 mini_usage ();
1966                 return 1;
1967         }
1968
1969 #if !defined(HOST_WIN32) && defined(HAVE_UNISTD_H)
1970         /*
1971          * If we are not embedded, use the mono runtime executable to run managed exe's.
1972          */
1973         {
1974                 char *runtime_path;
1975
1976                 runtime_path = mono_w32process_get_path (getpid ());
1977                 if (runtime_path) {
1978                         mono_w32process_set_cli_launcher (runtime_path);
1979                         g_free (runtime_path);
1980                 }
1981         }
1982 #endif
1983
1984         if (g_hasenv ("MONO_XDEBUG"))
1985                 enable_debugging = TRUE;
1986
1987 #ifdef MONO_CROSS_COMPILE
1988        if (!mono_compile_aot) {
1989                    fprintf (stderr, "This mono runtime is compiled for cross-compiling. Only the --aot option is supported.\n");
1990                    exit (1);
1991        }
1992 #if SIZEOF_VOID_P == 8 && (defined(TARGET_ARM) || defined(TARGET_X86))
1993        fprintf (stderr, "Can't cross-compile on 64-bit platforms to 32-bit architecture.\n");
1994        exit (1);
1995 #elif SIZEOF_VOID_P == 4 && (defined(TARGET_ARM64) || defined(TARGET_AMD64))
1996        fprintf (stderr, "Can't cross-compile on 32-bit platforms to 64-bit architecture.\n");
1997        exit (1);
1998 #endif
1999 #endif
2000
2001         if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
2002                 g_set_prgname (argv[i]);
2003         }
2004
2005         mono_counters_init ();
2006
2007 #ifndef HOST_WIN32
2008         mono_w32handle_init ();
2009 #endif
2010
2011         /* Set rootdir before loading config */
2012         mono_set_rootdir ();
2013
2014         if (enable_profile) {
2015                 mini_profiler_enable_with_options (profile_options);
2016         }
2017
2018         mono_attach_parse_options (attach_options);
2019
2020         if (trace_options != NULL){
2021                 /* 
2022                  * Need to call this before mini_init () so we can trace methods 
2023                  * compiled there too.
2024                  */
2025                 mono_jit_trace_calls = mono_trace_parse_options (trace_options);
2026                 if (mono_jit_trace_calls == NULL)
2027                         exit (1);
2028         }
2029
2030 #ifdef DISABLE_JIT
2031         if (!mono_aot_only) {
2032                 fprintf (stderr, "This runtime has been configured with --enable-minimal=jit, so the --full-aot command line option is required.\n");
2033                 exit (1);
2034         }
2035 #endif
2036
2037         if (action == DO_DEBUGGER) {
2038                 enable_debugging = TRUE;
2039                 g_print ("The Mono Debugger is no longer supported.\n");
2040                 return 1;
2041         } else if (enable_debugging)
2042                 mono_debug_init (MONO_DEBUG_FORMAT_MONO);
2043
2044 #ifdef HOST_WIN32
2045         if (mixed_mode)
2046                 mono_load_coree (argv [i]);
2047 #endif
2048
2049         /* Parse gac loading options before loading assemblies. */
2050         if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
2051                 mono_config_parse (config_file);
2052         }
2053
2054         mono_set_defaults (mini_verbose, opt);
2055         domain = mini_init (argv [i], forced_version);
2056
2057         mono_gc_set_stack_end (&domain);
2058
2059         if (agents) {
2060                 int i;
2061
2062                 for (i = 0; i < agents->len; ++i) {
2063                         int res = load_agent (domain, (char*)g_ptr_array_index (agents, i));
2064                         if (res) {
2065                                 g_ptr_array_free (agents, TRUE);
2066                                 mini_cleanup (domain);
2067                                 return 1;
2068                         }
2069                 }
2070
2071                 g_ptr_array_free (agents, TRUE);
2072         }
2073         
2074         switch (action) {
2075         case DO_SINGLE_METHOD_REGRESSION:
2076                 mono_do_single_method_regression = TRUE;
2077         case DO_REGRESSION:
2078 #ifdef ENABLE_INTERPRETER
2079                 if (mono_use_interpreter) {
2080                         if (mono_interp_regression_list (2, argc -i, argv + i)) {
2081                                 g_print ("Regression ERRORS!\n");
2082                                 // mini_cleanup (domain);
2083                                 return 1;
2084                         }
2085                         // mini_cleanup (domain);
2086                         return 0;
2087                 }
2088 #endif
2089                 if (mini_regression_list (mini_verbose, argc -i, argv + i)) {
2090                         g_print ("Regression ERRORS!\n");
2091                         mini_cleanup (domain);
2092                         return 1;
2093                 }
2094                 mini_cleanup (domain);
2095                 return 0;
2096         case DO_BENCH:
2097                 if (argc - i != 1 || mname == NULL) {
2098                         g_print ("Usage: mini --ncompile num --compile method assembly\n");
2099                         mini_cleanup (domain);
2100                         return 1;
2101                 }
2102                 aname = argv [i];
2103                 break;
2104         case DO_COMPILE:
2105                 if (argc - i != 1) {
2106                         mini_usage ();
2107                         mini_cleanup (domain);
2108                         return 1;
2109                 }
2110                 aname = argv [i];
2111                 break;
2112         case DO_DRAW:
2113                 if (argc - i != 1 || mname == NULL) {
2114                         mini_usage ();
2115                         mini_cleanup (domain);
2116                         return 1;
2117                 }
2118                 aname = argv [i];
2119                 break;
2120         default:
2121                 if (argc - i < 1) {
2122                         mini_usage ();
2123                         mini_cleanup (domain);
2124                         return 1;
2125                 }
2126                 aname = argv [i];
2127                 break;
2128         }
2129
2130 #ifdef MONO_JIT_INFO_TABLE_TEST
2131         if (test_jit_info_table)
2132                 jit_info_table_test (domain);
2133 #endif
2134
2135         if (mono_compile_aot && extra_bindings_config_file != NULL) {
2136                 apply_root_domain_configuration_file_bindings (domain, extra_bindings_config_file);
2137         }
2138
2139         assembly = mono_assembly_open_predicate (aname, FALSE, FALSE, NULL, NULL, &open_status);
2140         if (!assembly) {
2141                 fprintf (stderr, "Cannot open assembly '%s': %s.\n", aname, mono_image_strerror (open_status));
2142                 mini_cleanup (domain);
2143                 return 2;
2144         }
2145
2146         if (trace_options != NULL)
2147                 mono_trace_set_assembly (assembly);
2148
2149         if (mono_compile_aot || action == DO_EXEC) {
2150                 const char *error;
2151
2152                 //mono_set_rootdir ();
2153
2154                 error = mono_check_corlib_version ();
2155                 if (error) {
2156                         fprintf (stderr, "Corlib not in sync with this runtime: %s\n", error);
2157                         fprintf (stderr, "Loaded from: %s\n",
2158                                 mono_defaults.corlib? mono_image_get_filename (mono_defaults.corlib): "unknown");
2159                         fprintf (stderr, "Download a newer corlib or a newer runtime at http://www.mono-project.com/download.\n");
2160                         exit (1);
2161                 }
2162
2163 #if defined(HOST_WIN32) && G_HAVE_API_SUPPORT(HAVE_CLASSIC_WINAPI_SUPPORT)
2164                 /* Detach console when executing IMAGE_SUBSYSTEM_WINDOWS_GUI on win32 */
2165                 if (!enable_debugging && !mono_compile_aot && ((MonoCLIImageInfo*)(mono_assembly_get_image (assembly)->image_info))->cli_header.nt.pe_subsys_required == IMAGE_SUBSYSTEM_WINDOWS_GUI)
2166                         FreeConsole ();
2167 #endif
2168
2169                 main_args.domain = domain;
2170                 main_args.file = aname;         
2171                 main_args.argc = argc - i;
2172                 main_args.argv = argv + i;
2173                 main_args.opts = opt;
2174                 main_args.aot_options = aot_options;
2175 #if RUN_IN_SUBTHREAD
2176                 mono_runtime_exec_managed_code (domain, main_thread_handler, &main_args);
2177 #else
2178                 main_thread_handler (&main_args);
2179                 mono_thread_manage ();
2180 #endif
2181
2182                 mini_cleanup (domain);
2183
2184                 /* Look up return value from System.Environment.ExitCode */
2185                 i = mono_environment_exitcode_get ();
2186                 return i;
2187         } else if (action == DO_COMPILE) {
2188                 compile_all_methods (assembly, mini_verbose, opt, recompilation_times);
2189                 mini_cleanup (domain);
2190                 return 0;
2191         } else if (action == DO_DEBUGGER) {
2192                 return 1;
2193         }
2194         desc = mono_method_desc_new (mname, 0);
2195         if (!desc) {
2196                 g_print ("Invalid method name %s\n", mname);
2197                 mini_cleanup (domain);
2198                 return 3;
2199         }
2200         method = mono_method_desc_search_in_image (desc, mono_assembly_get_image (assembly));
2201         if (!method) {
2202                 g_print ("Cannot find method %s\n", mname);
2203                 mini_cleanup (domain);
2204                 return 3;
2205         }
2206
2207 #ifndef DISABLE_JIT
2208         if (action == DO_DRAW) {
2209                 int part = 0;
2210
2211                 switch (mono_graph_options) {
2212                 case MONO_GRAPH_DTREE:
2213                         part = 1;
2214                         opt |= MONO_OPT_LOOP;
2215                         break;
2216                 case MONO_GRAPH_CFG_CODE:
2217                         part = 1;
2218                         break;
2219                 case MONO_GRAPH_CFG_SSA:
2220                         part = 2;
2221                         break;
2222                 case MONO_GRAPH_CFG_OPTCODE:
2223                         part = 3;
2224                         break;
2225                 default:
2226                         break;
2227                 }
2228
2229                 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2230                         (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL)) {
2231                         MonoMethod *nm;
2232                         nm = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2233                         cfg = mini_method_compile (nm, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2234                 }
2235                 else
2236                         cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2237                 if ((mono_graph_options & MONO_GRAPH_CFG_SSA) && !(cfg->comp_done & MONO_COMP_SSA)) {
2238                         g_warning ("no SSA info available (use -O=deadce)");
2239                         return 1;
2240                 }
2241                 mono_draw_graph (cfg, mono_graph_options);
2242                 mono_destroy_compile (cfg);
2243
2244         } else if (action == DO_BENCH) {
2245                 if (mini_stats_fd) {
2246                         const char *n;
2247                         double no_opt_time = 0.0;
2248                         GTimer *timer = g_timer_new ();
2249                         fprintf (mini_stats_fd, "$stattitle = \'Compilations times for %s\';\n", 
2250                                  mono_method_full_name (method, TRUE));
2251                         fprintf (mini_stats_fd, "@data = (\n");
2252                         fprintf (mini_stats_fd, "[");
2253                         for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2254                                 opt = opt_sets [i];
2255                                 n = mono_opt_descr (opt);
2256                                 if (!n [0])
2257                                         n = "none";
2258                                 fprintf (mini_stats_fd, "\"%s\",", n);
2259                         }
2260                         fprintf (mini_stats_fd, "],\n[");
2261
2262                         for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2263                                 int j;
2264                                 double elapsed;
2265                                 opt = opt_sets [i];
2266                                 g_timer_start (timer);
2267                                 for (j = 0; j < count; ++j) {
2268                                         cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2269                                         mono_destroy_compile (cfg);
2270                                 }
2271                                 g_timer_stop (timer);
2272                                 elapsed = g_timer_elapsed (timer, NULL);
2273                                 if (!opt)
2274                                         no_opt_time = elapsed;
2275                                 fprintf (mini_stats_fd, "%f, ", elapsed);
2276                         }
2277                         fprintf (mini_stats_fd, "]");
2278                         if (no_opt_time > 0.0) {
2279                                 fprintf (mini_stats_fd, ", \n[");
2280                                 for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) 
2281                                         fprintf (mini_stats_fd, "%f,", no_opt_time);
2282                                 fprintf (mini_stats_fd, "]");
2283                         }
2284                         fprintf (mini_stats_fd, ");\n");
2285                 } else {
2286                         for (i = 0; i < count; ++i) {
2287                                 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2288                                         (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL))
2289                                         method = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2290
2291                                 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2292                                 mono_destroy_compile (cfg);
2293                         }
2294                 }
2295         } else {
2296                 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2297                 mono_destroy_compile (cfg);
2298         }
2299 #endif
2300
2301         mini_cleanup (domain);
2302         return 0;
2303 }
2304
2305 /**
2306  * mono_jit_init:
2307  */
2308 MonoDomain * 
2309 mono_jit_init (const char *file)
2310 {
2311         return mini_init (file, NULL);
2312 }
2313
2314 /**
2315  * mono_jit_init_version:
2316  * \param domain_name the name of the root domain
2317  * \param runtime_version the version of the runtime to load
2318  *
2319  * Use this version when you want to force a particular runtime
2320  * version to be used.  By default Mono will pick the runtime that is
2321  * referenced by the initial assembly (specified in \p file), this
2322  * routine allows programmers to specify the actual runtime to be used
2323  * as the initial runtime is inherited by all future assemblies loaded
2324  * (since Mono does not support having more than one mscorlib runtime
2325  * loaded at once).
2326  *
2327  * The \p runtime_version can be one of these strings: "v4.0.30319" for
2328  * desktop, "mobile" for mobile or "moonlight" for Silverlight compat.
2329  * If an unrecognized string is input, the vm will default to desktop.
2330  *
2331  * \returns the \c MonoDomain representing the domain where the assembly
2332  * was loaded.
2333  */
2334 MonoDomain * 
2335 mono_jit_init_version (const char *domain_name, const char *runtime_version)
2336 {
2337         return mini_init (domain_name, runtime_version);
2338 }
2339
2340 /**
2341  * mono_jit_cleanup:
2342  */
2343 void        
2344 mono_jit_cleanup (MonoDomain *domain)
2345 {
2346         mono_thread_manage ();
2347
2348         mini_cleanup (domain);
2349 }
2350
2351 void
2352 mono_jit_set_aot_only (gboolean val)
2353 {
2354         mono_aot_only = val;
2355 }
2356
2357 /**
2358  * mono_jit_set_aot_mode:
2359  */
2360 void
2361 mono_jit_set_aot_mode (MonoAotMode mode)
2362 {
2363         /* we don't want to set mono_aot_mode twice */
2364         g_assert (mono_aot_mode == MONO_AOT_MODE_NONE);
2365         mono_aot_mode = mode;
2366
2367         if (mono_aot_mode == MONO_AOT_MODE_LLVMONLY) {
2368                 mono_aot_only = TRUE;
2369                 mono_llvm_only = TRUE;
2370         }
2371         if (mono_aot_mode == MONO_AOT_MODE_FULL) {
2372                 mono_aot_only = TRUE;
2373         }
2374         if (mono_aot_mode == MONO_AOT_MODE_HYBRID) {
2375                 mono_set_generic_sharing_vt_supported (TRUE);
2376                 mono_set_partial_sharing_supported (TRUE);
2377         }
2378         if (mono_aot_mode == MONO_AOT_MODE_INTERP) {
2379                 mono_aot_only = TRUE;
2380                 mono_use_interpreter = TRUE;
2381         }
2382 }
2383
2384 /**
2385  * mono_jit_set_trace_options:
2386  * \param options string representing the trace options
2387  * Set the options of the tracing engine. This function can be called before initializing
2388  * the mono runtime. See the --trace mono(1) manpage for the options format.
2389  *
2390  * \returns TRUE if the options were parsed and set correctly, FALSE otherwise.
2391  */
2392 gboolean
2393 mono_jit_set_trace_options (const char* options)
2394 {
2395         MonoTraceSpec *trace_opt = mono_trace_parse_options (options);
2396         if (trace_opt == NULL)
2397                 return FALSE;
2398         mono_jit_trace_calls = trace_opt;
2399         return TRUE;
2400 }
2401
2402 /**
2403  * mono_set_signal_chaining:
2404  *
2405  * Enable/disable signal chaining. This should be called before \c mono_jit_init.
2406  * If signal chaining is enabled, the runtime saves the original signal handlers before
2407  * installing its own handlers, and calls the original ones in the following cases:
2408  * - a \c SIGSEGV / \c SIGABRT signal received while executing native (i.e. not JITted) code.
2409  * - \c SIGPROF
2410  * - \c SIGFPE
2411  * - \c SIGQUIT
2412  * - \c SIGUSR2
2413  * Signal chaining only works on POSIX platforms.
2414  */
2415 void
2416 mono_set_signal_chaining (gboolean chain_signals)
2417 {
2418         mono_do_signal_chaining = chain_signals;
2419 }
2420
2421 /**
2422  * mono_set_crash_chaining:
2423  *
2424  * Enable/disable crash chaining due to signals. When a fatal signal is delivered and
2425  * Mono doesn't know how to handle it, it will invoke the crash handler. If chrash chaining
2426  * is enabled, it will first print its crash information and then try to chain with the native handler.
2427  */
2428 void
2429 mono_set_crash_chaining (gboolean chain_crashes)
2430 {
2431         mono_do_crash_chaining = chain_crashes;
2432 }
2433
2434 /**
2435  * mono_parse_options_from:
2436  * \param options string containing strings 
2437  * \param ref_argc pointer to the \c argc variable that might be updated 
2438  * \param ref_argv pointer to the \c argv string vector variable that might be updated
2439  *
2440  * This function parses the contents of the \c MONO_ENV_OPTIONS
2441  * environment variable as if they were parsed by a command shell
2442  * splitting the contents by spaces into different elements of the
2443  * \p argv vector.  This method supports quoting with both the " and '
2444  * characters.  Inside quoting, spaces and tabs are significant,
2445  * otherwise, they are considered argument separators.
2446  *
2447  * The \ character can be used to escape the next character which will
2448  * be added to the current element verbatim.  Typically this is used
2449  * inside quotes.   If the quotes are not balanced, this method 
2450  *
2451  * If the environment variable is empty, no changes are made
2452  * to the values pointed by \p ref_argc and \p ref_argv.
2453  *
2454  * Otherwise the \p ref_argv is modified to point to a new array that contains
2455  * all the previous elements contained in the vector, plus the values parsed.
2456  * The \p argc is updated to match the new number of parameters.
2457  *
2458  * \returns The value NULL is returned on success, otherwise a \c g_strdup allocated
2459  * string is returned (this is an alias to \c malloc under normal circumstances) that
2460  * contains the error message that happened during parsing.
2461  */
2462 char *
2463 mono_parse_options_from (const char *options, int *ref_argc, char **ref_argv [])
2464 {
2465         int argc = *ref_argc;
2466         char **argv = *ref_argv;
2467         GPtrArray *array = g_ptr_array_new ();
2468         GString *buffer = g_string_new ("");
2469         const char *p;
2470         unsigned i;
2471         gboolean in_quotes = FALSE;
2472         char quote_char = '\0';
2473
2474         if (options == NULL)
2475                 return NULL;
2476         
2477         for (p = options; *p; p++){
2478                 switch (*p){
2479                 case ' ': case '\t':
2480                         if (!in_quotes) {
2481                                 if (buffer->len != 0){
2482                                         g_ptr_array_add (array, g_strdup (buffer->str));
2483                                         g_string_truncate (buffer, 0);
2484                                 }
2485                         } else {
2486                                 g_string_append_c (buffer, *p);
2487                         }
2488                         break;
2489                 case '\\':
2490                         if (p [1]){
2491                                 g_string_append_c (buffer, p [1]);
2492                                 p++;
2493                         }
2494                         break;
2495                 case '\'':
2496                 case '"':
2497                         if (in_quotes) {
2498                                 if (quote_char == *p)
2499                                         in_quotes = FALSE;
2500                                 else
2501                                         g_string_append_c (buffer, *p);
2502                         } else {
2503                                 in_quotes = TRUE;
2504                                 quote_char = *p;
2505                         }
2506                         break;
2507                 default:
2508                         g_string_append_c (buffer, *p);
2509                         break;
2510                 }
2511         }
2512         if (in_quotes) 
2513                 return g_strdup_printf ("Unmatched quotes in value: [%s]\n", options);
2514                 
2515         if (buffer->len != 0)
2516                 g_ptr_array_add (array, g_strdup (buffer->str));
2517         g_string_free (buffer, TRUE);
2518
2519         if (array->len > 0){
2520                 int new_argc = array->len + argc;
2521                 char **new_argv = g_new (char *, new_argc + 1);
2522                 int j;
2523
2524                 new_argv [0] = argv [0];
2525                 
2526                 /* First the environment variable settings, to allow the command line options to override */
2527                 for (i = 0; i < array->len; i++)
2528                         new_argv [i+1] = (char *)g_ptr_array_index (array, i);
2529                 i++;
2530                 for (j = 1; j < argc; j++)
2531                         new_argv [i++] = argv [j];
2532                 new_argv [i] = NULL;
2533
2534                 *ref_argc = new_argc;
2535                 *ref_argv = new_argv;
2536         }
2537         g_ptr_array_free (array, TRUE);
2538         return NULL;
2539 }
2540
2541 /**
2542  * mono_parse_env_options:
2543  * \param ref_argc pointer to the \c argc variable that might be updated 
2544  * \param ref_argv pointer to the \c argv string vector variable that might be updated
2545  *
2546  * This function parses the contents of the \c MONO_ENV_OPTIONS
2547  * environment variable as if they were parsed by a command shell
2548  * splitting the contents by spaces into different elements of the
2549  * \p argv vector.  This method supports quoting with both the " and '
2550  * characters.  Inside quoting, spaces and tabs are significant,
2551  * otherwise, they are considered argument separators.
2552  *
2553  * The \ character can be used to escape the next character which will
2554  * be added to the current element verbatim.  Typically this is used
2555  * inside quotes.   If the quotes are not balanced, this method 
2556  *
2557  * If the environment variable is empty, no changes are made
2558  * to the values pointed by \p ref_argc and \p ref_argv.
2559  *
2560  * Otherwise the \p ref_argv is modified to point to a new array that contains
2561  * all the previous elements contained in the vector, plus the values parsed.
2562  * The \p argc is updated to match the new number of parameters.
2563  *
2564  * If there is an error parsing, this method will terminate the process by
2565  * calling exit(1).
2566  *
2567  * An alternative to this method that allows an arbitrary string to be parsed
2568  * and does not exit on error is the `api:mono_parse_options_from`.
2569  */
2570 void
2571 mono_parse_env_options (int *ref_argc, char **ref_argv [])
2572 {
2573         char *ret;
2574         
2575         char *env_options = g_getenv ("MONO_ENV_OPTIONS");
2576         if (env_options == NULL)
2577                 return;
2578         ret = mono_parse_options_from (env_options, ref_argc, ref_argv);
2579         g_free (env_options);
2580         if (ret == NULL)
2581                 return;
2582         fprintf (stderr, "%s", ret);
2583         exit (1);
2584 }
2585