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