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