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 #else
1504         fprintf (stderr, "Error: --gc=<NAME> option not supported on this platform.\n");
1505 #endif
1506 }
1507
1508 #ifdef TARGET_OSX
1509
1510 /*
1511  * tries to increase the minimum number of files, if the number is below 1024
1512  */
1513 static void
1514 darwin_change_default_file_handles ()
1515 {
1516         struct rlimit limit;
1517
1518         if (getrlimit (RLIMIT_NOFILE, &limit) == 0){
1519                 if (limit.rlim_cur < 1024){
1520                         limit.rlim_cur = MAX(1024,limit.rlim_cur);
1521                         setrlimit (RLIMIT_NOFILE, &limit);
1522                 }
1523         }
1524 }
1525
1526 static void
1527 switch_arch (char* argv[], const char* target_arch)
1528 {
1529         GString *path;
1530         gsize arch_offset;
1531
1532         if ((strcmp (target_arch, "32") == 0 && strcmp (MONO_ARCHITECTURE, "x86") == 0) ||
1533                 (strcmp (target_arch, "64") == 0 && strcmp (MONO_ARCHITECTURE, "amd64") == 0)) {
1534                 return; /* matching arch loaded */
1535         }
1536
1537         path = g_string_new (argv [0]);
1538         arch_offset = path->len -2; /* last two characters */
1539
1540         /* Remove arch suffix if present */
1541         if (strstr (&path->str[arch_offset], "32") || strstr (&path->str[arch_offset], "64")) {
1542                 g_string_truncate (path, arch_offset);
1543         }
1544
1545         g_string_append (path, target_arch);
1546
1547         if (execvp (path->str, argv) < 0) {
1548                 fprintf (stderr, "Error: --arch=%s Failed to switch to '%s'.\n", target_arch, path->str);
1549                 exit (1);
1550         }
1551 }
1552
1553 #endif
1554 /**
1555  * mono_main:
1556  * @argc: number of arguments in the argv array
1557  * @argv: array of strings containing the startup arguments
1558  *
1559  * Launches the Mono JIT engine and parses all the command line options
1560  * in the same way that the mono command line VM would.
1561  */
1562 int
1563 mono_main (int argc, char* argv[])
1564 {
1565         MainThreadArgs main_args;
1566         MonoAssembly *assembly;
1567         MonoMethodDesc *desc;
1568         MonoMethod *method;
1569         MonoCompile *cfg;
1570         MonoDomain *domain;
1571         MonoImageOpenStatus open_status;
1572         const char* aname, *mname = NULL;
1573         char *config_file = NULL;
1574         int i, count = 1;
1575         guint32 opt, action = DO_EXEC, recompilation_times = 1;
1576         MonoGraphOptions mono_graph_options = (MonoGraphOptions)0;
1577         int mini_verbose = 0;
1578         gboolean enable_profile = FALSE;
1579         char *trace_options = NULL;
1580         char *profile_options = NULL;
1581         char *aot_options = NULL;
1582         char *forced_version = NULL;
1583         GPtrArray *agents = NULL;
1584         char *attach_options = NULL;
1585 #ifdef MONO_JIT_INFO_TABLE_TEST
1586         int test_jit_info_table = FALSE;
1587 #endif
1588 #ifdef HOST_WIN32
1589         int mixed_mode = FALSE;
1590 #endif
1591 #ifdef __native_client__
1592         gboolean nacl_null_checks_off = FALSE;
1593 #endif
1594
1595 #ifdef MOONLIGHT
1596 #ifndef HOST_WIN32
1597         /* stdout defaults to block buffering if it's not writing to a terminal, which
1598          * happens with our test harness: we redirect stdout to capture it. Force line
1599          * buffering in all cases. */
1600         setlinebuf (stdout);
1601 #endif
1602 #endif
1603
1604         setlocale (LC_ALL, "");
1605
1606 #if TARGET_OSX
1607         darwin_change_default_file_handles ();
1608 #endif
1609
1610         if (g_getenv ("MONO_NO_SMP"))
1611                 mono_set_use_smp (FALSE);
1612
1613         g_log_set_always_fatal (G_LOG_LEVEL_ERROR);
1614         g_log_set_fatal_mask (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR);
1615
1616         opt = mono_parse_default_optimizations (NULL);
1617
1618         for (i = 1; i < argc; ++i) {
1619                 if (argv [i] [0] != '-')
1620                         break;
1621                 if (strcmp (argv [i], "--regression") == 0) {
1622                         action = DO_REGRESSION;
1623                 } else if (strncmp (argv [i], "--single-method=", 16) == 0) {
1624                         char *full_opts = g_strdup_printf ("-all,%s", argv [i] + 16);
1625                         action = DO_SINGLE_METHOD_REGRESSION;
1626                         mono_single_method_regression_opt = parse_optimizations (opt, full_opts, TRUE);
1627                         g_free (full_opts);
1628                 } else if (strcmp (argv [i], "--verbose") == 0 || strcmp (argv [i], "-v") == 0) {
1629                         mini_verbose++;
1630                 } else if (strcmp (argv [i], "--version") == 0 || strcmp (argv [i], "-V") == 0) {
1631                         char *build = mono_get_runtime_build_info ();
1632                         char *gc_descr;
1633
1634                         g_print ("Mono JIT compiler version %s\nCopyright (C) 2002-2014 Novell, Inc, Xamarin Inc and Contributors. www.mono-project.com\n", build);
1635                         g_free (build);
1636                         g_print (info);
1637                         gc_descr = mono_gc_get_description ();
1638                         g_print ("\tGC:            %s\n", gc_descr);
1639                         g_free (gc_descr);
1640                         return 0;
1641                 } else if (strcmp (argv [i], "--help") == 0 || strcmp (argv [i], "-h") == 0) {
1642                         mini_usage ();
1643                         return 0;
1644                 } else if (strcmp (argv [i], "--help-trace") == 0){
1645                         mini_trace_usage ();
1646                         return 0;
1647                 } else if (strcmp (argv [i], "--help-devel") == 0){
1648                         mini_usage_jitdeveloper ();
1649                         return 0;
1650                 } else if (strcmp (argv [i], "--help-debug") == 0){
1651                         mini_debug_usage ();
1652                         return 0;
1653                 } else if (strcmp (argv [i], "--list-opt") == 0){
1654                         mini_usage_list_opt ();
1655                         return 0;
1656                 } else if (strncmp (argv [i], "--statfile", 10) == 0) {
1657                         if (i + 1 >= argc){
1658                                 fprintf (stderr, "error: --statfile requires a filename argument\n");
1659                                 return 1;
1660                         }
1661                         mini_stats_fd = fopen (argv [++i], "w+");
1662                 } else if (strncmp (argv [i], "--optimize=", 11) == 0) {
1663                         opt = parse_optimizations (opt, argv [i] + 11, TRUE);
1664                 } else if (strncmp (argv [i], "-O=", 3) == 0) {
1665                         opt = parse_optimizations (opt, argv [i] + 3, TRUE);
1666                 } else if (strncmp (argv [i], "--bisect=", 9) == 0) {
1667                         char *param = argv [i] + 9;
1668                         char *sep = strchr (param, ':');
1669                         if (!sep) {
1670                                 fprintf (stderr, "Error: --bisect requires OPT:FILENAME\n");
1671                                 return 1;
1672                         }
1673                         char *opt_string = g_strndup (param, sep - param);
1674                         guint32 opt = parse_optimizations (0, opt_string, FALSE);
1675                         g_free (opt_string);
1676                         mono_set_bisect_methods (opt, sep + 1);
1677                 } else if (strcmp (argv [i], "--gc=sgen") == 0) {
1678                         switch_gc (argv, "sgen");
1679                 } else if (strcmp (argv [i], "--gc=boehm") == 0) {
1680                         switch_gc (argv, "boehm");
1681                 }
1682 #ifdef TARGET_OSX
1683                 else if (strcmp (argv [i], "--arch=32") == 0) {
1684                         switch_arch (argv, "32");
1685                 } else if (strcmp (argv [i], "--arch=64") == 0) {
1686                         switch_arch (argv, "64");
1687                 }
1688 #endif
1689                 else if (strcmp (argv [i], "--config") == 0) {
1690                         if (i +1 >= argc){
1691                                 fprintf (stderr, "error: --config requires a filename argument\n");
1692                                 return 1;
1693                         }
1694                         config_file = argv [++i];
1695 #ifdef HOST_WIN32
1696                 } else if (strcmp (argv [i], "--mixed-mode") == 0) {
1697                         mixed_mode = TRUE;
1698 #endif
1699                 } else if (strcmp (argv [i], "--ncompile") == 0) {
1700                         if (i + 1 >= argc){
1701                                 fprintf (stderr, "error: --ncompile requires an argument\n");
1702                                 return 1;
1703                         }
1704                         count = atoi (argv [++i]);
1705                         action = DO_BENCH;
1706                 } else if (strcmp (argv [i], "--trace") == 0) {
1707                         trace_options = (char*)"";
1708                 } else if (strncmp (argv [i], "--trace=", 8) == 0) {
1709                         trace_options = &argv [i][8];
1710                 } else if (strcmp (argv [i], "--breakonex") == 0) {
1711                         MonoDebugOptions *opt = mini_get_debug_options ();
1712
1713                         opt->break_on_exc = TRUE;
1714                 } else if (strcmp (argv [i], "--break") == 0) {
1715                         if (i+1 >= argc){
1716                                 fprintf (stderr, "Missing method name in --break command line option\n");
1717                                 return 1;
1718                         }
1719
1720                         if (!mono_debugger_insert_breakpoint (argv [++i], FALSE))
1721                                 fprintf (stderr, "Error: invalid method name '%s'\n", argv [i]);
1722                 } else if (strcmp (argv [i], "--break-at-bb") == 0) {
1723                         if (i + 2 >= argc) {
1724                                 fprintf (stderr, "Missing method name or bb num in --break-at-bb command line option.");
1725                                 return 1;
1726                         }
1727                         mono_break_at_bb_method = mono_method_desc_new (argv [++i], TRUE);
1728                         if (mono_break_at_bb_method == NULL) {
1729                                 fprintf (stderr, "Method name is in a bad format in --break-at-bb command line option.");
1730                                 return 1;
1731                         }
1732                         mono_break_at_bb_bb_num = atoi (argv [++i]);
1733                 } else if (strcmp (argv [i], "--inject-async-exc") == 0) {
1734                         if (i + 2 >= argc) {
1735                                 fprintf (stderr, "Missing method name or position in --inject-async-exc command line option\n");
1736                                 return 1;
1737                         }
1738                         mono_inject_async_exc_method = mono_method_desc_new (argv [++i], TRUE);
1739                         if (mono_inject_async_exc_method == NULL) {
1740                                 fprintf (stderr, "Method name is in a bad format in --inject-async-exc command line option\n");
1741                                 return 1;
1742                         }
1743                         mono_inject_async_exc_pos = atoi (argv [++i]);
1744                 } else if (strcmp (argv [i], "--verify-all") == 0) {
1745                         mono_verifier_enable_verify_all ();
1746                 } else if (strcmp (argv [i], "--full-aot") == 0) {
1747                         mono_aot_only = TRUE;
1748                 } else if (strcmp (argv [i], "--llvmonly") == 0) {
1749                         mono_aot_only = TRUE;
1750                         mono_llvm_only = TRUE;
1751                 } else if (strcmp (argv [i], "--hybrid-aot") == 0) {
1752                 } else if (strcmp (argv [i], "--print-vtable") == 0) {
1753                         mono_print_vtable = TRUE;
1754                 } else if (strcmp (argv [i], "--stats") == 0) {
1755                         mono_counters_enable (-1);
1756                         mono_stats.enabled = TRUE;
1757                         mono_jit_stats.enabled = TRUE;
1758 #ifndef DISABLE_AOT
1759                 } else if (strcmp (argv [i], "--aot") == 0) {
1760                         error_if_aot_unsupported ();
1761                         mono_compile_aot = TRUE;
1762                 } else if (strncmp (argv [i], "--aot=", 6) == 0) {
1763                         error_if_aot_unsupported ();
1764                         mono_compile_aot = TRUE;
1765                         aot_options = &argv [i][6];
1766 #endif
1767                 } else if (strncmp (argv [i], "--compile-all=", 14) == 0) {
1768                         action = DO_COMPILE;
1769                         recompilation_times = atoi (argv [i] + 14);
1770                 } else if (strcmp (argv [i], "--compile-all") == 0) {
1771                         action = DO_COMPILE;
1772                 } else if (strncmp (argv [i], "--runtime=", 10) == 0) {
1773                         forced_version = &argv [i][10];
1774                 } else if (strcmp (argv [i], "--jitmap") == 0) {
1775                         mono_enable_jit_map ();
1776                 } else if (strcmp (argv [i], "--profile") == 0) {
1777                         enable_profile = TRUE;
1778                         profile_options = NULL;
1779                 } else if (strncmp (argv [i], "--profile=", 10) == 0) {
1780                         enable_profile = TRUE;
1781                         profile_options = argv [i] + 10;
1782                 } else if (strncmp (argv [i], "--agent=", 8) == 0) {
1783                         if (agents == NULL)
1784                                 agents = g_ptr_array_new ();
1785                         g_ptr_array_add (agents, argv [i] + 8);
1786                 } else if (strncmp (argv [i], "--attach=", 9) == 0) {
1787                         attach_options = argv [i] + 9;
1788                 } else if (strcmp (argv [i], "--compile") == 0) {
1789                         if (i + 1 >= argc){
1790                                 fprintf (stderr, "error: --compile option requires a method name argument\n");
1791                                 return 1;
1792                         }
1793
1794                         mname = argv [++i];
1795                         action = DO_BENCH;
1796                 } else if (strncmp (argv [i], "--graph=", 8) == 0) {
1797                         if (i + 1 >= argc){
1798                                 fprintf (stderr, "error: --graph option requires a method name argument\n");
1799                                 return 1;
1800                         }
1801
1802                         mono_graph_options = mono_parse_graph_options (argv [i] + 8);
1803                         mname = argv [++i];
1804                         action = DO_DRAW;
1805                 } else if (strcmp (argv [i], "--graph") == 0) {
1806                         if (i + 1 >= argc){
1807                                 fprintf (stderr, "error: --graph option requires a method name argument\n");
1808                                 return 1;
1809                         }
1810
1811                         mname = argv [++i];
1812                         mono_graph_options = MONO_GRAPH_CFG;
1813                         action = DO_DRAW;
1814                 } else if (strcmp (argv [i], "--debug") == 0) {
1815                         enable_debugging = TRUE;
1816                 } else if (strncmp (argv [i], "--debug=", 8) == 0) {
1817                         enable_debugging = TRUE;
1818                         if (!parse_debug_options (argv [i] + 8))
1819                                 return 1;
1820                 } else if (strncmp (argv [i], "--debugger-agent=", 17) == 0) {
1821                         MonoDebugOptions *opt = mini_get_debug_options ();
1822
1823                         mono_debugger_agent_parse_options (argv [i] + 17);
1824                         opt->mdb_optimizations = TRUE;
1825                         enable_debugging = TRUE;
1826                 } else if (strcmp (argv [i], "--security") == 0) {
1827 #ifndef DISABLE_SECURITY
1828                         mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1829 #else
1830                         fprintf (stderr, "error: --security: not compiled with security manager support");
1831                         return 1;
1832 #endif
1833                 } else if (strncmp (argv [i], "--security=", 11) == 0) {
1834                         /* Note: validil, and verifiable need to be
1835                            accepted even if DISABLE_SECURITY is defined. */
1836
1837                         if (strcmp (argv [i] + 11, "core-clr") == 0) {
1838 #ifndef DISABLE_SECURITY
1839                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1840                                 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1841 #else
1842                                 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1843                                 return 1;
1844 #endif
1845                         } else if (strcmp (argv [i] + 11, "core-clr-test") == 0) {
1846 #ifndef DISABLE_SECURITY
1847                                 /* fixme should we enable verifiable code here?*/
1848                                 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1849                                 mono_security_core_clr_test = TRUE;
1850 #else
1851                                 fprintf (stderr, "error: --security: not compiled with CoreCLR support");
1852                                 return 1;
1853 #endif
1854                         } else if (strcmp (argv [i] + 11, "cas") == 0) {
1855 #ifndef DISABLE_SECURITY
1856                                 fprintf (stderr, "warning: --security=cas not supported.");
1857 #else
1858                                 fprintf (stderr, "error: --security: not compiled with CAS support");
1859                                 return 1;
1860 #endif
1861                         } else if (strcmp (argv [i] + 11, "validil") == 0) {
1862                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VALID);
1863                         } else if (strcmp (argv [i] + 11, "verifiable") == 0) {
1864                                 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1865                         } else {
1866                                 fprintf (stderr, "error: --security= option has invalid argument (cas, core-clr, verifiable or validil)\n");
1867                                 return 1;
1868                         }
1869                 } else if (strcmp (argv [i], "--desktop") == 0) {
1870                         mono_gc_set_desktop_mode ();
1871                         /* Put more desktop-specific optimizations here */
1872                 } else if (strcmp (argv [i], "--server") == 0){
1873                         mono_config_set_server_mode (TRUE);
1874                         /* Put more server-specific optimizations here */
1875                 } else if (strcmp (argv [i], "--inside-mdb") == 0) {
1876                         action = DO_DEBUGGER;
1877                 } else if (strncmp (argv [i], "--wapi=", 7) == 0) {
1878                         fprintf (stderr, "--wapi= option no longer supported\n.");
1879                         return 1;
1880                 } else if (strcmp (argv [i], "--no-x86-stack-align") == 0) {
1881                         mono_do_x86_stack_align = FALSE;
1882 #ifdef MONO_JIT_INFO_TABLE_TEST
1883                 } else if (strcmp (argv [i], "--test-jit-info-table") == 0) {
1884                         test_jit_info_table = TRUE;
1885 #endif
1886                 } else if (strcmp (argv [i], "--llvm") == 0) {
1887 #ifndef MONO_ARCH_LLVM_SUPPORTED
1888                         fprintf (stderr, "Mono Warning: --llvm not supported on this platform.\n");
1889 #elif !defined(ENABLE_LLVM)
1890                         fprintf (stderr, "Mono Warning: --llvm not enabled in this runtime.\n");
1891 #else
1892                         mono_use_llvm = TRUE;
1893 #endif
1894                 } else if (strcmp (argv [i], "--nollvm") == 0){
1895                         mono_use_llvm = FALSE;
1896 #ifdef __native_client__
1897                 } else if (strcmp (argv [i], "--nacl-mono-path") == 0){
1898                         nacl_mono_path = g_strdup(argv[++i]);
1899                 } else if (strcmp (argv [i], "--nacl-null-checks-off") == 0){
1900                         nacl_null_checks_off = TRUE;
1901 #endif
1902                 } else if (argv [i][0] == '-' && argv [i][1] == '-' && mini_parse_debug_option (argv [i] + 2)) {
1903                 } else {
1904                         fprintf (stderr, "Unknown command line option: '%s'\n", argv [i]);
1905                         return 1;
1906                 }
1907         }
1908
1909 #ifdef __native_client_codegen__
1910         if (!nacl_null_checks_off) {
1911                 MonoDebugOptions *opt = mini_get_debug_options ();
1912                 opt->explicit_null_checks = TRUE;
1913         }
1914 #endif
1915
1916 #if defined(DISABLE_HW_TRAPS) || defined(MONO_ARCH_DISABLE_HW_TRAPS)
1917         // Signal handlers not available
1918         {
1919                 MonoDebugOptions *opt = mini_get_debug_options ();
1920                 opt->explicit_null_checks = TRUE;
1921         }
1922 #endif
1923
1924         if (!argv [i]) {
1925                 mini_usage ();
1926                 return 1;
1927         }
1928
1929 #if !defined(HOST_WIN32) && defined(HAVE_UNISTD_H)
1930         /*
1931          * If we are not embedded, use the mono runtime executable to run managed exe's.
1932          */
1933         {
1934                 char *runtime_path;
1935
1936                 runtime_path = wapi_process_get_path (getpid ());
1937                 if (runtime_path) {
1938                         wapi_process_set_cli_launcher (runtime_path);
1939                         g_free (runtime_path);
1940                 }
1941         }
1942 #endif
1943
1944         if (g_getenv ("MONO_XDEBUG"))
1945                 enable_debugging = TRUE;
1946
1947 #ifdef MONO_CROSS_COMPILE
1948        if (!mono_compile_aot) {
1949                    fprintf (stderr, "This mono runtime is compiled for cross-compiling. Only the --aot option is supported.\n");
1950                    exit (1);
1951        }
1952 #if SIZEOF_VOID_P == 8 && (defined(TARGET_ARM) || defined(TARGET_X86))
1953        fprintf (stderr, "Can't cross-compile on 64-bit platforms to 32-bit architecture.\n");
1954        exit (1);
1955 #elif SIZEOF_VOID_P == 4 && (defined(TARGET_ARM64) || defined(TARGET_AMD64))
1956        fprintf (stderr, "Can't cross-compile on 32-bit platforms to 64-bit architecture.\n");
1957        exit (1);
1958 #endif
1959 #endif
1960
1961         if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
1962                 g_set_prgname (argv[i]);
1963         }
1964
1965         mono_counters_init ();
1966
1967 #ifndef HOST_WIN32
1968         mono_w32handle_init ();
1969 #endif
1970
1971         /* Set rootdir before loading config */
1972         mono_set_rootdir ();
1973
1974         /*
1975          * We only set the native name of the thread since MS.NET leaves the
1976          * managed thread name for the main thread as null.
1977          */
1978         mono_native_thread_set_name (mono_native_thread_id_get (), "Main");
1979
1980         if (enable_profile) {
1981                 mono_profiler_load (profile_options);
1982                 mono_profiler_thread_name (MONO_NATIVE_THREAD_ID_TO_UINT (mono_native_thread_id_get ()), "Main");
1983         }
1984
1985         mono_attach_parse_options (attach_options);
1986
1987         if (trace_options != NULL){
1988                 /*
1989                  * Need to call this before mini_init () so we can trace methods
1990                  * compiled there too.
1991                  */
1992                 mono_jit_trace_calls = mono_trace_parse_options (trace_options);
1993                 if (mono_jit_trace_calls == NULL)
1994                         exit (1);
1995         }
1996
1997 #ifdef DISABLE_JIT
1998         if (!mono_aot_only) {
1999                 fprintf (stderr, "This runtime has been configured with --enable-minimal=jit, so the --full-aot command line option is required.\n");
2000                 exit (1);
2001         }
2002 #endif
2003
2004         if (action == DO_DEBUGGER) {
2005                 enable_debugging = TRUE;
2006                 g_print ("The Mono Debugger is no longer supported.\n");
2007                 return 1;
2008         } else if (enable_debugging)
2009                 mono_debug_init (MONO_DEBUG_FORMAT_MONO);
2010
2011 #ifdef HOST_WIN32
2012         if (mixed_mode)
2013                 mono_load_coree (argv [i]);
2014 #endif
2015
2016         /* Parse gac loading options before loading assemblies. */
2017         if (mono_compile_aot || action == DO_EXEC || action == DO_DEBUGGER) {
2018                 mono_config_parse (config_file);
2019         }
2020
2021         mono_set_defaults (mini_verbose, opt);
2022         domain = mini_init (argv [i], forced_version);
2023
2024         mono_gc_set_stack_end (&domain);
2025
2026         if (agents) {
2027                 int i;
2028
2029                 for (i = 0; i < agents->len; ++i) {
2030                         int res = load_agent (domain, (char*)g_ptr_array_index (agents, i));
2031                         if (res) {
2032                                 g_ptr_array_free (agents, TRUE);
2033                                 mini_cleanup (domain);
2034                                 return 1;
2035                         }
2036                 }
2037
2038                 g_ptr_array_free (agents, TRUE);
2039         }
2040
2041         switch (action) {
2042         case DO_SINGLE_METHOD_REGRESSION:
2043                 mono_do_single_method_regression = TRUE;
2044         case DO_REGRESSION:
2045                 if (mini_regression_list (mini_verbose, argc -i, argv + i)) {
2046                         g_print ("Regression ERRORS!\n");
2047                         mini_cleanup (domain);
2048                         return 1;
2049                 }
2050                 mini_cleanup (domain);
2051                 return 0;
2052         case DO_BENCH:
2053                 if (argc - i != 1 || mname == NULL) {
2054                         g_print ("Usage: mini --ncompile num --compile method assembly\n");
2055                         mini_cleanup (domain);
2056                         return 1;
2057                 }
2058                 aname = argv [i];
2059                 break;
2060         case DO_COMPILE:
2061                 if (argc - i != 1) {
2062                         mini_usage ();
2063                         mini_cleanup (domain);
2064                         return 1;
2065                 }
2066                 aname = argv [i];
2067                 break;
2068         case DO_DRAW:
2069                 if (argc - i != 1 || mname == NULL) {
2070                         mini_usage ();
2071                         mini_cleanup (domain);
2072                         return 1;
2073                 }
2074                 aname = argv [i];
2075                 break;
2076         default:
2077                 if (argc - i < 1) {
2078                         mini_usage ();
2079                         mini_cleanup (domain);
2080                         return 1;
2081                 }
2082                 aname = argv [i];
2083                 break;
2084         }
2085
2086 #ifdef MONO_JIT_INFO_TABLE_TEST
2087         if (test_jit_info_table)
2088                 jit_info_table_test (domain);
2089 #endif
2090
2091         assembly = mono_assembly_open (aname, &open_status);
2092         if (!assembly) {
2093                 fprintf (stderr, "Cannot open assembly '%s': %s.\n", aname, mono_image_strerror (open_status));
2094                 mini_cleanup (domain);
2095                 return 2;
2096         }
2097
2098         if (trace_options != NULL)
2099                 mono_trace_set_assembly (assembly);
2100
2101         if (mono_compile_aot || action == DO_EXEC) {
2102                 const char *error;
2103
2104                 //mono_set_rootdir ();
2105
2106                 error = mono_check_corlib_version ();
2107                 if (error) {
2108                         fprintf (stderr, "Corlib not in sync with this runtime: %s\n", error);
2109                         fprintf (stderr, "Loaded from: %s\n",
2110                                 mono_defaults.corlib? mono_image_get_filename (mono_defaults.corlib): "unknown");
2111                         fprintf (stderr, "Download a newer corlib or a newer runtime at http://www.mono-project.com/download.\n");
2112                         exit (1);
2113                 }
2114
2115 #ifdef HOST_WIN32
2116                 /* Detach console when executing IMAGE_SUBSYSTEM_WINDOWS_GUI on win32 */
2117                 if (!enable_debugging && !mono_compile_aot && ((MonoCLIImageInfo*)(mono_assembly_get_image (assembly)->image_info))->cli_header.nt.pe_subsys_required == IMAGE_SUBSYSTEM_WINDOWS_GUI)
2118                         FreeConsole ();
2119 #endif
2120
2121                 main_args.domain = domain;
2122                 main_args.file = aname;
2123                 main_args.argc = argc - i;
2124                 main_args.argv = argv + i;
2125                 main_args.opts = opt;
2126                 main_args.aot_options = aot_options;
2127 #if RUN_IN_SUBTHREAD
2128                 mono_runtime_exec_managed_code (domain, main_thread_handler, &main_args);
2129 #else
2130                 main_thread_handler (&main_args);
2131                 mono_thread_manage ();
2132 #endif
2133
2134                 mini_cleanup (domain);
2135
2136                 /* Look up return value from System.Environment.ExitCode */
2137                 i = mono_environment_exitcode_get ();
2138                 return i;
2139         } else if (action == DO_COMPILE) {
2140                 compile_all_methods (assembly, mini_verbose, opt, recompilation_times);
2141                 mini_cleanup (domain);
2142                 return 0;
2143         } else if (action == DO_DEBUGGER) {
2144                 return 1;
2145         }
2146         desc = mono_method_desc_new (mname, 0);
2147         if (!desc) {
2148                 g_print ("Invalid method name %s\n", mname);
2149                 mini_cleanup (domain);
2150                 return 3;
2151         }
2152         method = mono_method_desc_search_in_image (desc, mono_assembly_get_image (assembly));
2153         if (!method) {
2154                 g_print ("Cannot find method %s\n", mname);
2155                 mini_cleanup (domain);
2156                 return 3;
2157         }
2158
2159 #ifndef DISABLE_JIT
2160         if (action == DO_DRAW) {
2161                 int part = 0;
2162
2163                 switch (mono_graph_options) {
2164                 case MONO_GRAPH_DTREE:
2165                         part = 1;
2166                         opt |= MONO_OPT_LOOP;
2167                         break;
2168                 case MONO_GRAPH_CFG_CODE:
2169                         part = 1;
2170                         break;
2171                 case MONO_GRAPH_CFG_SSA:
2172                         part = 2;
2173                         break;
2174                 case MONO_GRAPH_CFG_OPTCODE:
2175                         part = 3;
2176                         break;
2177                 default:
2178                         break;
2179                 }
2180
2181                 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2182                         (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL)) {
2183                         MonoMethod *nm;
2184                         nm = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2185                         cfg = mini_method_compile (nm, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2186                 }
2187                 else
2188                         cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, part, -1);
2189                 if ((mono_graph_options & MONO_GRAPH_CFG_SSA) && !(cfg->comp_done & MONO_COMP_SSA)) {
2190                         g_warning ("no SSA info available (use -O=deadce)");
2191                         return 1;
2192                 }
2193                 mono_draw_graph (cfg, mono_graph_options);
2194                 mono_destroy_compile (cfg);
2195
2196         } else if (action == DO_BENCH) {
2197                 if (mini_stats_fd) {
2198                         const char *n;
2199                         double no_opt_time = 0.0;
2200                         GTimer *timer = g_timer_new ();
2201                         fprintf (mini_stats_fd, "$stattitle = \'Compilations times for %s\';\n",
2202                                  mono_method_full_name (method, TRUE));
2203                         fprintf (mini_stats_fd, "@data = (\n");
2204                         fprintf (mini_stats_fd, "[");
2205                         for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2206                                 opt = opt_sets [i];
2207                                 n = mono_opt_descr (opt);
2208                                 if (!n [0])
2209                                         n = "none";
2210                                 fprintf (mini_stats_fd, "\"%s\",", n);
2211                         }
2212                         fprintf (mini_stats_fd, "],\n[");
2213
2214                         for (i = 0; i < G_N_ELEMENTS (opt_sets); i++) {
2215                                 int j;
2216                                 double elapsed;
2217                                 opt = opt_sets [i];
2218                                 g_timer_start (timer);
2219                                 for (j = 0; j < count; ++j) {
2220                                         cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2221                                         mono_destroy_compile (cfg);
2222                                 }
2223                                 g_timer_stop (timer);
2224                                 elapsed = g_timer_elapsed (timer, NULL);
2225                                 if (!opt)
2226                                         no_opt_time = elapsed;
2227                                 fprintf (mini_stats_fd, "%f, ", elapsed);
2228                         }
2229                         fprintf (mini_stats_fd, "]");
2230                         if (no_opt_time > 0.0) {
2231                                 fprintf (mini_stats_fd, ", \n[");
2232                                 for (i = 0; i < G_N_ELEMENTS (opt_sets); i++)
2233                                         fprintf (mini_stats_fd, "%f,", no_opt_time);
2234                                 fprintf (mini_stats_fd, "]");
2235                         }
2236                         fprintf (mini_stats_fd, ");\n");
2237                 } else {
2238                         for (i = 0; i < count; ++i) {
2239                                 if ((method->iflags & METHOD_IMPL_ATTRIBUTE_INTERNAL_CALL) ||
2240                                         (method->flags & METHOD_ATTRIBUTE_PINVOKE_IMPL))
2241                                         method = mono_marshal_get_native_wrapper (method, TRUE, FALSE);
2242
2243                                 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2244                                 mono_destroy_compile (cfg);
2245                         }
2246                 }
2247         } else {
2248                 cfg = mini_method_compile (method, opt, mono_get_root_domain (), (JitFlags)0, 0, -1);
2249                 mono_destroy_compile (cfg);
2250         }
2251 #endif
2252
2253         mini_cleanup (domain);
2254         return 0;
2255 }
2256
2257 MonoDomain *
2258 mono_jit_init (const char *file)
2259 {
2260         return mini_init (file, NULL);
2261 }
2262
2263 /**
2264  * mono_jit_init_version:
2265  * @domain_name: the name of the root domain
2266  * @runtime_version: the version of the runtime to load
2267  *
2268  * Use this version when you want to force a particular runtime
2269  * version to be used.  By default Mono will pick the runtime that is
2270  * referenced by the initial assembly (specified in @file), this
2271  * routine allows programmers to specify the actual runtime to be used
2272  * as the initial runtime is inherited by all future assemblies loaded
2273  * (since Mono does not support having more than one mscorlib runtime
2274  * loaded at once).
2275  *
2276  * The @runtime_version can be one of these strings: "v4.0.30319" for
2277  * desktop, "mobile" for mobile or "moonlight" for Silverlight compat.
2278  * If an unrecognized string is input, the vm will default to desktop.
2279  *
2280  * Returns: the MonoDomain representing the domain where the assembly
2281  * was loaded.
2282  */
2283 MonoDomain *
2284 mono_jit_init_version (const char *domain_name, const char *runtime_version)
2285 {
2286         return mini_init (domain_name, runtime_version);
2287 }
2288
2289 void
2290 mono_jit_cleanup (MonoDomain *domain)
2291 {
2292         mono_thread_manage ();
2293
2294         mini_cleanup (domain);
2295 }
2296
2297 void
2298 mono_jit_set_aot_only (gboolean val)
2299 {
2300         mono_aot_only = val;
2301 }
2302
2303 void
2304 mono_jit_set_aot_mode (MonoAotMode mode)
2305 {
2306         mono_aot_mode = mode;
2307         if (mono_aot_mode == MONO_AOT_MODE_LLVMONLY) {
2308                 mono_aot_only = TRUE;
2309                 mono_llvm_only = TRUE;
2310         }
2311 }
2312
2313 /**
2314  * mono_jit_set_trace_options:
2315  * @options: string representing the trace options
2316  *
2317  * Set the options of the tracing engine. This function can be called before initializing
2318  * the mono runtime. See the --trace mono(1) manpage for the options format.
2319  *
2320  * Returns: #TRUE if the options where parsed and set correctly, #FALSE otherwise.
2321  */
2322 gboolean
2323 mono_jit_set_trace_options (const char* options)
2324 {
2325         MonoTraceSpec *trace_opt = mono_trace_parse_options (options);
2326         if (trace_opt == NULL)
2327                 return FALSE;
2328         mono_jit_trace_calls = trace_opt;
2329         return TRUE;
2330 }
2331
2332 /**
2333  * mono_set_signal_chaining:
2334  *
2335  *   Enable/disable signal chaining. This should be called before mono_jit_init ().
2336  * If signal chaining is enabled, the runtime saves the original signal handlers before
2337  * installing its own handlers, and calls the original ones in the following cases:
2338  * - a SIGSEGV/SIGABRT signal received while executing native (i.e. not JITted) code.
2339  * - SIGPROF
2340  * - SIGFPE
2341  * - SIGQUIT
2342  * - SIGUSR2
2343  * Signal chaining only works on POSIX platforms.
2344  */
2345 void
2346 mono_set_signal_chaining (gboolean chain_signals)
2347 {
2348         mono_do_signal_chaining = chain_signals;
2349 }
2350
2351 /**
2352  * mono_set_crash_chaining:
2353  *
2354  * Enable/disable crash chaining due to signals. When a fatal signal is delivered and
2355  * Mono doesn't know how to handle it, it will invoke the crash handler. If chrash chaining
2356  * is enabled, it will first print its crash information and then try to chain with the native handler.
2357  */
2358 void
2359 mono_set_crash_chaining (gboolean chain_crashes)
2360 {
2361         mono_do_crash_chaining = chain_crashes;
2362 }
2363
2364 /**
2365  * mono_parse_options_from:
2366  * @options: string containing strings
2367  * @ref_argc: pointer to the argc variable that might be updated
2368  * @ref_argv: pointer to the argv string vector variable that might be updated
2369  *
2370  * This function parses the contents of the `MONO_ENV_OPTIONS`
2371  * environment variable as if they were parsed by a command shell
2372  * splitting the contents by spaces into different elements of the
2373  * @argv vector.  This method supports quoting with both the " and '
2374  * characters.  Inside quoting, spaces and tabs are significant,
2375  * otherwise, they are considered argument separators.
2376  *
2377  * The \ character can be used to escape the next character which will
2378  * be added to the current element verbatim.  Typically this is used
2379  * inside quotes.   If the quotes are not balanced, this method
2380  *
2381  * If the environment variable is empty, no changes are made
2382  * to the values pointed by @ref_argc and @ref_argv.
2383  *
2384  * Otherwise the @ref_argv is modified to point to a new array that contains
2385  * all the previous elements contained in the vector, plus the values parsed.
2386  * The @argc is updated to match the new number of parameters.
2387  *
2388  * Returns: The value NULL is returned on success, otherwise a g_strdup allocated
2389  * string is returned (this is an alias to malloc under normal circumstances) that
2390  * contains the error message that happened during parsing.
2391  */
2392 char *
2393 mono_parse_options_from (const char *options, int *ref_argc, char **ref_argv [])
2394 {
2395         int argc = *ref_argc;
2396         char **argv = *ref_argv;
2397         GPtrArray *array = g_ptr_array_new ();
2398         GString *buffer = g_string_new ("");
2399         const char *p;
2400         unsigned i;
2401         gboolean in_quotes = FALSE;
2402         char quote_char = '\0';
2403
2404         if (options == NULL)
2405                 return NULL;
2406
2407         for (p = options; *p; p++){
2408                 switch (*p){
2409                 case ' ': case '\t':
2410                         if (!in_quotes) {
2411                                 if (buffer->len != 0){
2412                                         g_ptr_array_add (array, g_strdup (buffer->str));
2413                                         g_string_truncate (buffer, 0);
2414                                 }
2415                         } else {
2416                                 g_string_append_c (buffer, *p);
2417                         }
2418                         break;
2419                 case '\\':
2420                         if (p [1]){
2421                                 g_string_append_c (buffer, p [1]);
2422                                 p++;
2423                         }
2424                         break;
2425                 case '\'':
2426                 case '"':
2427                         if (in_quotes) {
2428                                 if (quote_char == *p)
2429                                         in_quotes = FALSE;
2430                                 else
2431                                         g_string_append_c (buffer, *p);
2432                         } else {
2433                                 in_quotes = TRUE;
2434                                 quote_char = *p;
2435                         }
2436                         break;
2437                 default:
2438                         g_string_append_c (buffer, *p);
2439                         break;
2440                 }
2441         }
2442         if (in_quotes)
2443                 return g_strdup_printf ("Unmatched quotes in value: [%s]\n", options);
2444
2445         if (buffer->len != 0)
2446                 g_ptr_array_add (array, g_strdup (buffer->str));
2447         g_string_free (buffer, TRUE);
2448
2449         if (array->len > 0){
2450                 int new_argc = array->len + argc;
2451                 char **new_argv = g_new (char *, new_argc + 1);
2452                 int j;
2453
2454                 new_argv [0] = argv [0];
2455
2456                 /* First the environment variable settings, to allow the command line options to override */
2457                 for (i = 0; i < array->len; i++)
2458                         new_argv [i+1] = (char *)g_ptr_array_index (array, i);
2459                 i++;
2460                 for (j = 1; j < argc; j++)
2461                         new_argv [i++] = argv [j];
2462                 new_argv [i] = NULL;
2463
2464                 *ref_argc = new_argc;
2465                 *ref_argv = new_argv;
2466         }
2467         g_ptr_array_free (array, TRUE);
2468         return NULL;
2469 }
2470
2471 /**
2472  * mono_parse_env_options:
2473  * @ref_argc: pointer to the argc variable that might be updated
2474  * @ref_argv: pointer to the argv string vector variable that might be updated
2475  *
2476  * This function parses the contents of the `MONO_ENV_OPTIONS`
2477  * environment variable as if they were parsed by a command shell
2478  * splitting the contents by spaces into different elements of the
2479  * @argv vector.  This method supports quoting with both the " and '
2480  * characters.  Inside quoting, spaces and tabs are significant,
2481  * otherwise, they are considered argument separators.
2482  *
2483  * The \ character can be used to escape the next character which will
2484  * be added to the current element verbatim.  Typically this is used
2485  * inside quotes.   If the quotes are not balanced, this method
2486  *
2487  * If the environment variable is empty, no changes are made
2488  * to the values pointed by @ref_argc and @ref_argv.
2489  *
2490  * Otherwise the @ref_argv is modified to point to a new array that contains
2491  * all the previous elements contained in the vector, plus the values parsed.
2492  * The @argc is updated to match the new number of parameters.
2493  *
2494  * If there is an error parsing, this method will terminate the process by
2495  * calling exit(1).
2496  *
2497  * An alternative to this method that allows an arbitrary string to be parsed
2498  * and does not exit on error is the `api:mono_parse_options_from`.
2499  */
2500 void
2501 mono_parse_env_options (int *ref_argc, char **ref_argv [])
2502 {
2503         char *ret;
2504
2505         const char *env_options = g_getenv ("MONO_ENV_OPTIONS");
2506         if (env_options == NULL)
2507                 return;
2508         ret = mono_parse_options_from (env_options, ref_argc, ref_argv);
2509         if (ret == NULL)
2510                 return;
2511         fprintf (stderr, "%s", ret);
2512         exit (1);
2513 }
2514