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