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