mono/mini/driver.c

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