mono/mini/driver.c

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