mono/mini/driver.c

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