2 * domain.c: MonoDomain functions
5 * Dietmar Maurer (dietmar@ximian.com)
8 * Copyright 2001-2003 Ximian, Inc (http://www.ximian.com)
9 * Copyright 2004-2009 Novell, Inc (http://www.novell.com)
10 * Copyright 2011-2012 Xamarin, Inc (http://www.xamarin.com)
11 * Licensed under the MIT license. See LICENSE file in the project root for full license information.
19 #include <mono/metadata/gc-internals.h>
21 #include <mono/utils/atomic.h>
22 #include <mono/utils/mono-compiler.h>
23 #include <mono/utils/mono-logger-internals.h>
24 #include <mono/utils/mono-membar.h>
25 #include <mono/utils/mono-counters.h>
26 #include <mono/utils/hazard-pointer.h>
27 #include <mono/utils/mono-tls.h>
28 #include <mono/utils/mono-mmap.h>
29 #include <mono/utils/mono-threads.h>
30 #include <mono/metadata/object.h>
31 #include <mono/metadata/object-internals.h>
32 #include <mono/metadata/domain-internals.h>
33 #include <mono/metadata/class-internals.h>
34 #include <mono/metadata/assembly.h>
35 #include <mono/metadata/exception.h>
36 #include <mono/metadata/metadata-internals.h>
37 #include <mono/metadata/gc-internals.h>
38 #include <mono/metadata/appdomain.h>
39 #include <mono/metadata/mono-debug-debugger.h>
40 #include <mono/metadata/mono-config.h>
41 #include <mono/metadata/threads-types.h>
42 #include <mono/metadata/runtime.h>
43 #include <mono/metadata/w32mutex.h>
44 #include <mono/metadata/w32semaphore.h>
45 #include <mono/metadata/w32event.h>
46 #include <mono/metadata/w32process.h>
47 #include <metadata/threads.h>
48 #include <metadata/profiler-private.h>
49 #include <mono/metadata/coree.h>
51 //#define DEBUG_DOMAIN_UNLOAD 1
53 /* we need to use both the Tls* functions and __thread because
54 * some archs may generate faster jit code with one meachanism
55 * or the other (we used to do it because tls slots were GC-tracked,
56 * but we can't depend on this).
58 static MonoNativeTlsKey appdomain_thread_id;
60 #ifdef MONO_HAVE_FAST_TLS
62 MONO_FAST_TLS_DECLARE(tls_appdomain);
64 #define GET_APPDOMAIN() ((MonoDomain*)MONO_FAST_TLS_GET(tls_appdomain))
66 #define SET_APPDOMAIN(x) do { \
67 MonoThreadInfo *info; \
68 MONO_FAST_TLS_SET (tls_appdomain,x); \
69 mono_native_tls_set_value (appdomain_thread_id, x); \
70 info = mono_thread_info_current (); \
72 mono_thread_info_tls_set (info, TLS_KEY_DOMAIN, (x)); \
75 #else /* !MONO_HAVE_FAST_TLS */
77 #define GET_APPDOMAIN() ((MonoDomain *)mono_native_tls_get_value (appdomain_thread_id))
78 #define SET_APPDOMAIN(x) do { \
79 MonoThreadInfo *info; \
80 mono_native_tls_set_value (appdomain_thread_id, x); \
81 info = mono_thread_info_current (); \
83 mono_thread_info_tls_set (info, TLS_KEY_DOMAIN, (x)); \
88 #define GET_APPCONTEXT() (mono_thread_internal_current ()->current_appcontext)
89 #define SET_APPCONTEXT(x) MONO_OBJECT_SETREF (mono_thread_internal_current (), current_appcontext, (x))
91 static guint16 appdomain_list_size = 0;
92 static guint16 appdomain_next = 0;
93 static MonoDomain **appdomains_list = NULL;
94 static MonoImage *exe_image;
95 static gboolean debug_domain_unload;
97 gboolean mono_dont_free_domains;
99 #define mono_appdomains_lock() mono_coop_mutex_lock (&appdomains_mutex)
100 #define mono_appdomains_unlock() mono_coop_mutex_unlock (&appdomains_mutex)
101 static MonoCoopMutex appdomains_mutex;
103 static MonoDomain *mono_root_domain = NULL;
105 /* some statistics */
106 static int max_domain_code_size = 0;
107 static int max_domain_code_alloc = 0;
108 static int total_domain_code_alloc = 0;
110 /* AppConfigInfo: Information about runtime versions supported by an
114 GSList *supported_runtimes;
115 char *required_runtime;
116 int configuration_count;
120 static const MonoRuntimeInfo *current_runtime = NULL;
122 /* This is the list of runtime versions supported by this JIT.
124 static const MonoRuntimeInfo supported_runtimes[] = {
125 {"v4.0.30319","4.5", { {4,0,0,0}, {10,0,0,0}, {4,0,0,0}, {4,0,0,0} } },
126 {"mobile", "2.1", { {2,0,5,0}, {10,0,0,0}, {2,0,5,0}, {2,0,5,0} } },
127 {"moonlight", "2.1", { {2,0,5,0}, { 9,0,0,0}, {3,5,0,0}, {3,0,0,0} } },
131 /* The stable runtime version */
132 #define DEFAULT_RUNTIME_VERSION "v4.0.30319"
134 /* Callbacks installed by the JIT */
135 static MonoCreateDomainFunc create_domain_hook;
136 static MonoFreeDomainFunc free_domain_hook;
138 /* AOT cache configuration */
139 static MonoAotCacheConfig aot_cache_config;
142 get_runtimes_from_exe (const char *exe_file, MonoImage **exe_image, const MonoRuntimeInfo** runtimes);
144 static const MonoRuntimeInfo*
145 get_runtime_by_version (const char *version);
148 mono_domain_get_tls_key (void)
150 return appdomain_thread_id;
154 mono_domain_get_tls_offset (void)
159 if (appdomain_thread_id)
160 offset = appdomain_thread_id;
162 MONO_THREAD_VAR_OFFSET (tls_appdomain, offset);
167 #define ALIGN_TO(val,align) ((((guint64)val) + ((align) - 1)) & ~((align) - 1))
168 #define ALIGN_PTR_TO(ptr,align) (gpointer)((((gssize)(ptr)) + (align - 1)) & (~(align - 1)))
170 static LockFreeMempool*
171 lock_free_mempool_new (void)
173 return g_new0 (LockFreeMempool, 1);
177 lock_free_mempool_free (LockFreeMempool *mp)
179 LockFreeMempoolChunk *chunk, *next;
183 next = (LockFreeMempoolChunk *)chunk->prev;
184 mono_vfree (chunk, mono_pagesize (), MONO_MEM_ACCOUNT_DOMAIN);
193 static LockFreeMempoolChunk*
194 lock_free_mempool_chunk_new (LockFreeMempool *mp, int len)
196 LockFreeMempoolChunk *chunk, *prev;
199 size = mono_pagesize ();
200 while (size - sizeof (LockFreeMempoolChunk) < len)
201 size += mono_pagesize ();
202 chunk = (LockFreeMempoolChunk *)mono_valloc (0, size, MONO_MMAP_READ|MONO_MMAP_WRITE, MONO_MEM_ACCOUNT_DOMAIN);
204 chunk->mem = (guint8 *)ALIGN_PTR_TO ((char*)chunk + sizeof (LockFreeMempoolChunk), 16);
205 chunk->size = ((char*)chunk + size) - (char*)chunk->mem;
208 /* Add to list of chunks lock-free */
211 if (InterlockedCompareExchangePointer ((volatile gpointer*)&mp->chunks, chunk, prev) == prev)
223 lock_free_mempool_alloc0 (LockFreeMempool *mp, guint size)
225 LockFreeMempoolChunk *chunk;
229 // FIXME: Free the allocator
231 size = ALIGN_TO (size, 8);
234 chunk = lock_free_mempool_chunk_new (mp, size);
235 mono_memory_barrier ();
240 /* The code below is lock-free, 'chunk' is shared state */
241 oldpos = InterlockedExchangeAdd (&chunk->pos, size);
242 if (oldpos + size > chunk->size) {
243 chunk = lock_free_mempool_chunk_new (mp, size);
244 g_assert (chunk->pos + size <= chunk->size);
247 mono_memory_barrier ();
250 res = (char*)chunk->mem + oldpos;
257 mono_install_create_domain_hook (MonoCreateDomainFunc func)
259 create_domain_hook = func;
263 mono_install_free_domain_hook (MonoFreeDomainFunc func)
265 free_domain_hook = func;
270 * @s1: First string to compare
271 * @s2: Second string to compare
273 * Compares two `MonoString*` instances ordinally for equality.
275 * Returns FALSE if the strings differ.
278 mono_string_equal (MonoString *s1, MonoString *s2)
280 int l1 = mono_string_length (s1);
281 int l2 = mono_string_length (s2);
288 return memcmp (mono_string_chars (s1), mono_string_chars (s2), l1 * 2) == 0;
293 * @s: the string to hash
295 * Compute the hash for a `MonoString*`
296 * Returns the hash for the string.
299 mono_string_hash (MonoString *s)
301 const guint16 *p = mono_string_chars (s);
302 int i, len = mono_string_length (s);
305 for (i = 0; i < len; i++) {
306 h = (h << 5) - h + *p;
314 mono_ptrarray_equal (gpointer *s1, gpointer *s2)
316 int len = GPOINTER_TO_INT (s1 [0]);
317 if (len != GPOINTER_TO_INT (s2 [0]))
320 return memcmp (s1 + 1, s2 + 1, len * sizeof(gpointer)) == 0;
324 mono_ptrarray_hash (gpointer *s)
327 int len = GPOINTER_TO_INT (s [0]);
330 for (i = 1; i < len; i++)
331 hash += GPOINTER_TO_UINT (s [i]);
337 * Allocate an id for domain and set domain->domain_id.
338 * LOCKING: must be called while holding appdomains_mutex.
339 * We try to assign low numbers to the domain, so it can be used
340 * as an index in data tables to lookup domain-specific info
341 * with minimal memory overhead. We also try not to reuse the
342 * same id too quickly (to help debugging).
345 domain_id_alloc (MonoDomain *domain)
348 if (!appdomains_list) {
349 appdomain_list_size = 2;
350 appdomains_list = (MonoDomain **)mono_gc_alloc_fixed (appdomain_list_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "domains list");
352 for (i = appdomain_next; i < appdomain_list_size; ++i) {
353 if (!appdomains_list [i]) {
359 for (i = 0; i < appdomain_next; ++i) {
360 if (!appdomains_list [i]) {
367 MonoDomain **new_list;
368 int new_size = appdomain_list_size * 2;
369 if (new_size >= (1 << 16))
370 g_assert_not_reached ();
371 id = appdomain_list_size;
372 new_list = (MonoDomain **)mono_gc_alloc_fixed (new_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "domains list");
373 memcpy (new_list, appdomains_list, appdomain_list_size * sizeof (void*));
374 mono_gc_free_fixed (appdomains_list);
375 appdomains_list = new_list;
376 appdomain_list_size = new_size;
378 domain->domain_id = id;
379 appdomains_list [id] = domain;
381 if (appdomain_next > appdomain_list_size)
386 static gsize domain_gc_bitmap [sizeof(MonoDomain)/4/32 + 1];
387 static MonoGCDescriptor domain_gc_desc = MONO_GC_DESCRIPTOR_NULL;
388 static guint32 domain_shadow_serial = 0L;
391 * mono_domain_create:
393 * Creates a new application domain, the unmanaged representation
394 * of the actual domain. Usually you will want to create the
396 * Application domains provide an isolation facilty for assemblies. You
397 * can load assemblies and execute code in them that will not be visible
398 * to other application domains. This is a runtime-based virtualization
401 * It is possible to unload domains, which unloads the assemblies and
402 * data that was allocated in that domain.
404 * When a domain is created a mempool is allocated for domain-specific
405 * structures, along a dedicated code manager to hold code that is
406 * associated with the domain.
408 * Returns: New initialized MonoDomain, with no configuration or assemblies
412 mono_domain_create (void)
415 guint32 shadow_serial;
417 mono_appdomains_lock ();
418 shadow_serial = domain_shadow_serial++;
420 if (!domain_gc_desc) {
421 unsigned int i, bit = 0;
422 for (i = G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_FIRST_OBJECT); i < G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_FIRST_GC_TRACKED); i += sizeof (gpointer)) {
423 bit = i / sizeof (gpointer);
424 domain_gc_bitmap [bit / 32] |= (gsize) 1 << (bit % 32);
426 domain_gc_desc = mono_gc_make_descr_from_bitmap ((gsize*)domain_gc_bitmap, bit + 1);
428 mono_appdomains_unlock ();
432 * Boehm doesn't like roots inside GC allocated objects, and alloc_fixed returns
433 * a GC_MALLOC-ed object, contrary to the api docs. This causes random crashes when
434 * running the corlib test suite.
435 * To solve this, we pass a NULL descriptor, and don't register roots.
437 domain = (MonoDomain *)mono_gc_alloc_fixed (sizeof (MonoDomain), NULL, MONO_ROOT_SOURCE_DOMAIN, "domain object");
439 domain = (MonoDomain *)mono_gc_alloc_fixed (sizeof (MonoDomain), domain_gc_desc, MONO_ROOT_SOURCE_DOMAIN, "domain object");
440 mono_gc_register_root ((char*)&(domain->MONO_DOMAIN_FIRST_GC_TRACKED), G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_LAST_GC_TRACKED) - G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_FIRST_GC_TRACKED), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "misc domain fields");
442 domain->shadow_serial = shadow_serial;
443 domain->domain = NULL;
444 domain->setup = NULL;
445 domain->friendly_name = NULL;
446 domain->search_path = NULL;
448 mono_profiler_appdomain_event (domain, MONO_PROFILE_START_LOAD);
450 domain->mp = mono_mempool_new ();
451 domain->code_mp = mono_code_manager_new ();
452 domain->lock_free_mp = lock_free_mempool_new ();
453 domain->env = mono_g_hash_table_new_type ((GHashFunc)mono_string_hash, (GCompareFunc)mono_string_equal, MONO_HASH_KEY_VALUE_GC, MONO_ROOT_SOURCE_DOMAIN, "domain environment variables table");
454 domain->domain_assemblies = NULL;
455 domain->assembly_bindings = NULL;
456 domain->assembly_bindings_parsed = FALSE;
457 domain->class_vtable_array = g_ptr_array_new ();
458 domain->proxy_vtable_hash = g_hash_table_new ((GHashFunc)mono_ptrarray_hash, (GCompareFunc)mono_ptrarray_equal);
459 domain->static_data_array = NULL;
460 mono_jit_code_hash_init (&domain->jit_code_hash);
461 domain->ldstr_table = mono_g_hash_table_new_type ((GHashFunc)mono_string_hash, (GCompareFunc)mono_string_equal, MONO_HASH_KEY_VALUE_GC, MONO_ROOT_SOURCE_DOMAIN, "domain string constants table");
462 domain->num_jit_info_tables = 1;
463 domain->jit_info_table = mono_jit_info_table_new (domain);
464 domain->jit_info_free_queue = NULL;
465 domain->finalizable_objects_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
466 domain->ftnptrs_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
468 mono_coop_mutex_init_recursive (&domain->lock);
470 mono_os_mutex_init_recursive (&domain->assemblies_lock);
471 mono_os_mutex_init_recursive (&domain->jit_code_hash_lock);
472 mono_os_mutex_init_recursive (&domain->finalizable_objects_hash_lock);
474 domain->method_rgctx_hash = NULL;
476 mono_appdomains_lock ();
477 domain_id_alloc (domain);
478 mono_appdomains_unlock ();
480 #ifndef DISABLE_PERFCOUNTERS
481 mono_perfcounters->loader_appdomains++;
482 mono_perfcounters->loader_total_appdomains++;
485 mono_debug_domain_create (domain);
487 if (create_domain_hook)
488 create_domain_hook (domain);
490 mono_profiler_appdomain_loaded (domain, MONO_PROFILE_OK);
496 * mono_init_internal:
498 * Creates the initial application domain and initializes the mono_defaults
500 * This function is guaranteed to not run any IL code.
501 * If exe_filename is not NULL, the method will determine the required runtime
502 * from the exe configuration file or the version PE field.
503 * If runtime_version is not NULL, that runtime version will be used.
504 * Either exe_filename or runtime_version must be provided.
506 * Returns: the initial domain.
509 mono_init_internal (const char *filename, const char *exe_filename, const char *runtime_version)
511 static MonoDomain *domain = NULL;
512 MonoAssembly *ass = NULL;
513 MonoImageOpenStatus status = MONO_IMAGE_OK;
514 const MonoRuntimeInfo* runtimes [G_N_ELEMENTS (supported_runtimes) + 1] = { NULL };
517 #ifdef DEBUG_DOMAIN_UNLOAD
518 debug_domain_unload = TRUE;
522 g_assert_not_reached ();
524 #if defined(HOST_WIN32) && G_HAVE_API_SUPPORT(HAVE_CLASSIC_WINAPI_SUPPORT)
525 /* Avoid system error message boxes. */
526 SetErrorMode (SEM_FAILCRITICALERRORS | SEM_NOOPENFILEERRORBOX);
530 mono_w32handle_init ();
531 mono_w32handle_namespace_init ();
535 mono_w32mutex_init ();
536 mono_w32semaphore_init ();
537 mono_w32event_init ();
538 mono_w32process_init ();
540 #ifndef DISABLE_PERFCOUNTERS
541 mono_perfcounters_init ();
543 mono_counters_init ();
545 mono_counters_register ("Max native code in a domain", MONO_COUNTER_INT|MONO_COUNTER_JIT, &max_domain_code_size);
546 mono_counters_register ("Max code space allocated in a domain", MONO_COUNTER_INT|MONO_COUNTER_JIT, &max_domain_code_alloc);
547 mono_counters_register ("Total code space allocated", MONO_COUNTER_INT|MONO_COUNTER_JIT, &total_domain_code_alloc);
549 mono_gc_base_init ();
550 mono_thread_info_attach (&dummy);
552 MONO_FAST_TLS_INIT (tls_appdomain);
553 mono_native_tls_alloc (&appdomain_thread_id, NULL);
555 mono_coop_mutex_init_recursive (&appdomains_mutex);
557 mono_metadata_init ();
559 mono_assemblies_init ();
560 mono_classes_init ();
562 mono_reflection_init ();
563 mono_runtime_init_tls ();
565 /* FIXME: When should we release this memory? */
566 MONO_GC_REGISTER_ROOT_FIXED (appdomains_list, MONO_ROOT_SOURCE_DOMAIN, "domains list");
568 domain = mono_domain_create ();
569 mono_root_domain = domain;
571 SET_APPDOMAIN (domain);
573 /* Get a list of runtimes supported by the exe */
574 if (exe_filename != NULL) {
576 * This function will load the exe file as a MonoImage. We need to close it, but
577 * that would mean it would be reloaded later. So instead, we save it to
578 * exe_image, and close it during shutdown.
580 get_runtimes_from_exe (exe_filename, &exe_image, runtimes);
583 exe_image = mono_assembly_open_from_bundle (exe_filename, NULL, FALSE);
585 exe_image = mono_image_open (exe_filename, NULL);
587 mono_fixup_exe_image (exe_image);
589 } else if (runtime_version != NULL) {
590 runtimes [0] = get_runtime_by_version (runtime_version);
594 if (runtimes [0] == NULL) {
595 const MonoRuntimeInfo *default_runtime = get_runtime_by_version (DEFAULT_RUNTIME_VERSION);
596 runtimes [0] = default_runtime;
598 g_print ("WARNING: The runtime version supported by this application is unavailable.\n");
599 g_print ("Using default runtime: %s\n", default_runtime->runtime_version);
602 /* The selected runtime will be the first one for which there is a mscrolib.dll */
603 for (n = 0; runtimes [n] != NULL && ass == NULL; n++) {
604 current_runtime = runtimes [n];
605 ass = mono_assembly_load_corlib (current_runtime, &status);
606 if (status != MONO_IMAGE_OK && status != MONO_IMAGE_ERROR_ERRNO)
611 if ((status != MONO_IMAGE_OK) || (ass == NULL)) {
613 case MONO_IMAGE_ERROR_ERRNO: {
614 char *corlib_file = g_build_filename (mono_assembly_getrootdir (), "mono", current_runtime->framework_version, "mscorlib.dll", NULL);
615 g_print ("The assembly mscorlib.dll was not found or could not be loaded.\n");
616 g_print ("It should have been installed in the `%s' directory.\n", corlib_file);
617 g_free (corlib_file);
620 case MONO_IMAGE_IMAGE_INVALID:
621 g_print ("The file %s/mscorlib.dll is an invalid CIL image\n",
622 mono_assembly_getrootdir ());
624 case MONO_IMAGE_MISSING_ASSEMBLYREF:
625 g_print ("Missing assembly reference in %s/mscorlib.dll\n",
626 mono_assembly_getrootdir ());
629 /* to suppress compiler warning */
635 mono_defaults.corlib = mono_assembly_get_image (ass);
637 mono_defaults.object_class = mono_class_load_from_name (
638 mono_defaults.corlib, "System", "Object");
640 mono_defaults.void_class = mono_class_load_from_name (
641 mono_defaults.corlib, "System", "Void");
643 mono_defaults.boolean_class = mono_class_load_from_name (
644 mono_defaults.corlib, "System", "Boolean");
646 mono_defaults.byte_class = mono_class_load_from_name (
647 mono_defaults.corlib, "System", "Byte");
649 mono_defaults.sbyte_class = mono_class_load_from_name (
650 mono_defaults.corlib, "System", "SByte");
652 mono_defaults.int16_class = mono_class_load_from_name (
653 mono_defaults.corlib, "System", "Int16");
655 mono_defaults.uint16_class = mono_class_load_from_name (
656 mono_defaults.corlib, "System", "UInt16");
658 mono_defaults.int32_class = mono_class_load_from_name (
659 mono_defaults.corlib, "System", "Int32");
661 mono_defaults.uint32_class = mono_class_load_from_name (
662 mono_defaults.corlib, "System", "UInt32");
664 mono_defaults.uint_class = mono_class_load_from_name (
665 mono_defaults.corlib, "System", "UIntPtr");
667 mono_defaults.int_class = mono_class_load_from_name (
668 mono_defaults.corlib, "System", "IntPtr");
670 mono_defaults.int64_class = mono_class_load_from_name (
671 mono_defaults.corlib, "System", "Int64");
673 mono_defaults.uint64_class = mono_class_load_from_name (
674 mono_defaults.corlib, "System", "UInt64");
676 mono_defaults.single_class = mono_class_load_from_name (
677 mono_defaults.corlib, "System", "Single");
679 mono_defaults.double_class = mono_class_load_from_name (
680 mono_defaults.corlib, "System", "Double");
682 mono_defaults.char_class = mono_class_load_from_name (
683 mono_defaults.corlib, "System", "Char");
685 mono_defaults.string_class = mono_class_load_from_name (
686 mono_defaults.corlib, "System", "String");
688 mono_defaults.enum_class = mono_class_load_from_name (
689 mono_defaults.corlib, "System", "Enum");
691 mono_defaults.array_class = mono_class_load_from_name (
692 mono_defaults.corlib, "System", "Array");
694 mono_defaults.delegate_class = mono_class_load_from_name (
695 mono_defaults.corlib, "System", "Delegate");
697 mono_defaults.multicastdelegate_class = mono_class_load_from_name (
698 mono_defaults.corlib, "System", "MulticastDelegate");
700 mono_defaults.asyncresult_class = mono_class_load_from_name (
701 mono_defaults.corlib, "System.Runtime.Remoting.Messaging",
704 mono_defaults.manualresetevent_class = mono_class_load_from_name (
705 mono_defaults.corlib, "System.Threading", "ManualResetEvent");
707 mono_defaults.typehandle_class = mono_class_load_from_name (
708 mono_defaults.corlib, "System", "RuntimeTypeHandle");
710 mono_defaults.methodhandle_class = mono_class_load_from_name (
711 mono_defaults.corlib, "System", "RuntimeMethodHandle");
713 mono_defaults.fieldhandle_class = mono_class_load_from_name (
714 mono_defaults.corlib, "System", "RuntimeFieldHandle");
716 mono_defaults.systemtype_class = mono_class_load_from_name (
717 mono_defaults.corlib, "System", "Type");
719 mono_defaults.runtimetype_class = mono_class_load_from_name (
720 mono_defaults.corlib, "System", "RuntimeType");
722 mono_defaults.exception_class = mono_class_load_from_name (
723 mono_defaults.corlib, "System", "Exception");
725 mono_defaults.threadabortexception_class = mono_class_load_from_name (
726 mono_defaults.corlib, "System.Threading", "ThreadAbortException");
728 mono_defaults.thread_class = mono_class_load_from_name (
729 mono_defaults.corlib, "System.Threading", "Thread");
731 mono_defaults.internal_thread_class = mono_class_load_from_name (
732 mono_defaults.corlib, "System.Threading", "InternalThread");
734 mono_defaults.appdomain_class = mono_class_load_from_name (
735 mono_defaults.corlib, "System", "AppDomain");
737 #ifndef DISABLE_REMOTING
738 mono_defaults.transparent_proxy_class = mono_class_load_from_name (
739 mono_defaults.corlib, "System.Runtime.Remoting.Proxies", "TransparentProxy");
741 mono_defaults.real_proxy_class = mono_class_load_from_name (
742 mono_defaults.corlib, "System.Runtime.Remoting.Proxies", "RealProxy");
744 mono_defaults.marshalbyrefobject_class = mono_class_load_from_name (
745 mono_defaults.corlib, "System", "MarshalByRefObject");
747 mono_defaults.iremotingtypeinfo_class = mono_class_load_from_name (
748 mono_defaults.corlib, "System.Runtime.Remoting", "IRemotingTypeInfo");
752 mono_defaults.mono_method_message_class = mono_class_load_from_name (
753 mono_defaults.corlib, "System.Runtime.Remoting.Messaging", "MonoMethodMessage");
755 mono_defaults.field_info_class = mono_class_load_from_name (
756 mono_defaults.corlib, "System.Reflection", "FieldInfo");
758 mono_defaults.method_info_class = mono_class_load_from_name (
759 mono_defaults.corlib, "System.Reflection", "MethodInfo");
761 mono_defaults.stringbuilder_class = mono_class_load_from_name (
762 mono_defaults.corlib, "System.Text", "StringBuilder");
764 mono_defaults.math_class = mono_class_load_from_name (
765 mono_defaults.corlib, "System", "Math");
767 mono_defaults.stack_frame_class = mono_class_load_from_name (
768 mono_defaults.corlib, "System.Diagnostics", "StackFrame");
770 mono_defaults.stack_trace_class = mono_class_load_from_name (
771 mono_defaults.corlib, "System.Diagnostics", "StackTrace");
773 mono_defaults.marshal_class = mono_class_load_from_name (
774 mono_defaults.corlib, "System.Runtime.InteropServices", "Marshal");
776 mono_defaults.typed_reference_class = mono_class_load_from_name (
777 mono_defaults.corlib, "System", "TypedReference");
779 mono_defaults.argumenthandle_class = mono_class_load_from_name (
780 mono_defaults.corlib, "System", "RuntimeArgumentHandle");
782 mono_defaults.monitor_class = mono_class_load_from_name (
783 mono_defaults.corlib, "System.Threading", "Monitor");
785 Not using GENERATE_TRY_GET_CLASS_WITH_CACHE_DECL as this type is heavily checked by sgen when computing finalization.
787 mono_defaults.critical_finalizer_object = mono_class_try_load_from_name (mono_defaults.corlib,
788 "System.Runtime.ConstrainedExecution", "CriticalFinalizerObject");
790 mono_assembly_load_friends (ass);
792 mono_defaults.handleref_class = mono_class_try_load_from_name (
793 mono_defaults.corlib, "System.Runtime.InteropServices", "HandleRef");
795 mono_defaults.attribute_class = mono_class_load_from_name (
796 mono_defaults.corlib, "System", "Attribute");
798 mono_defaults.customattribute_data_class = mono_class_load_from_name (
799 mono_defaults.corlib, "System.Reflection", "CustomAttributeData");
801 mono_class_init (mono_defaults.array_class);
802 mono_defaults.generic_nullable_class = mono_class_load_from_name (
803 mono_defaults.corlib, "System", "Nullable`1");
804 mono_defaults.generic_ilist_class = mono_class_load_from_name (
805 mono_defaults.corlib, "System.Collections.Generic", "IList`1");
806 mono_defaults.generic_ireadonlylist_class = mono_class_load_from_name (
807 mono_defaults.corlib, "System.Collections.Generic", "IReadOnlyList`1");
809 mono_defaults.threadpool_wait_callback_class = mono_class_load_from_name (
810 mono_defaults.corlib, "System.Threading", "_ThreadPoolWaitCallback");
812 mono_defaults.threadpool_perform_wait_callback_method = mono_class_get_method_from_name (
813 mono_defaults.threadpool_wait_callback_class, "PerformWaitCallback", 0);
815 domain->friendly_name = g_path_get_basename (filename);
817 mono_profiler_appdomain_name (domain, domain->friendly_name);
825 * Creates the initial application domain and initializes the mono_defaults
828 * This function is guaranteed to not run any IL code.
829 * The runtime is initialized using the default runtime version.
831 * Returns: the initial domain.
834 mono_init (const char *domain_name)
836 return mono_init_internal (domain_name, NULL, DEFAULT_RUNTIME_VERSION);
840 * mono_init_from_assembly:
841 * @domain_name: name to give to the initial domain
842 * @filename: filename to load on startup
844 * Used by the runtime, users should use mono_jit_init instead.
846 * Creates the initial application domain and initializes the mono_defaults
848 * This function is guaranteed to not run any IL code.
849 * The runtime is initialized using the runtime version required by the
850 * provided executable. The version is determined by looking at the exe
851 * configuration file and the version PE field)
853 * Returns: the initial domain.
856 mono_init_from_assembly (const char *domain_name, const char *filename)
858 return mono_init_internal (domain_name, filename, NULL);
864 * Used by the runtime, users should use mono_jit_init instead.
866 * Creates the initial application domain and initializes the mono_defaults
869 * This function is guaranteed to not run any IL code.
870 * The runtime is initialized using the provided rutime version.
872 * Returns: the initial domain.
875 mono_init_version (const char *domain_name, const char *version)
877 return mono_init_internal (domain_name, NULL, version);
883 * Cleans up all metadata modules.
888 mono_close_exe_image ();
890 mono_defaults.corlib = NULL;
892 mono_config_cleanup ();
893 mono_loader_cleanup ();
894 mono_classes_cleanup ();
895 mono_assemblies_cleanup ();
896 mono_debug_cleanup ();
897 mono_images_cleanup ();
898 mono_metadata_cleanup ();
900 mono_native_tls_free (appdomain_thread_id);
901 mono_coop_mutex_destroy (&appdomains_mutex);
903 mono_w32process_cleanup ();
911 mono_close_exe_image (void)
914 mono_image_close (exe_image);
918 * mono_get_root_domain:
920 * The root AppDomain is the initial domain created by the runtime when it is
921 * initialized. Programs execute on this AppDomain, but can create new ones
922 * later. Currently there is no unmanaged API to create new AppDomains, this
923 * must be done from managed code.
925 * Returns: the root appdomain, to obtain the current domain, use mono_domain_get ()
928 mono_get_root_domain (void)
930 return mono_root_domain;
936 * This method returns the value of the current MonoDomain that this thread
937 * and code are running under. To obtain the root domain use
938 * mono_get_root_domain() API.
940 * Returns: the current domain
945 return GET_APPDOMAIN ();
949 mono_domain_unset (void)
951 SET_APPDOMAIN (NULL);
955 mono_domain_set_internal_with_options (MonoDomain *domain, gboolean migrate_exception)
957 MonoInternalThread *thread;
959 if (mono_domain_get () == domain)
962 SET_APPDOMAIN (domain);
963 SET_APPCONTEXT (domain->default_context);
965 if (migrate_exception) {
966 thread = mono_thread_internal_current ();
967 if (!thread->abort_exc)
970 g_assert (thread->abort_exc->object.vtable->domain != domain);
971 MONO_OBJECT_SETREF (thread, abort_exc, mono_get_exception_thread_abort ());
972 g_assert (thread->abort_exc->object.vtable->domain == domain);
977 * mono_domain_set_internal:
978 * @domain: the new domain
980 * Sets the current domain to @domain.
983 mono_domain_set_internal (MonoDomain *domain)
985 mono_domain_set_internal_with_options (domain, TRUE);
989 * mono_domain_foreach:
990 * @func: function to invoke with the domain data
991 * @user_data: user-defined pointer that is passed to the supplied @func fo reach domain
993 * Use this method to safely iterate over all the loaded application
994 * domains in the current runtime. The provided @func is invoked with a
995 * pointer to the MonoDomain and is given the value of the @user_data
996 * parameter which can be used to pass state to your called routine.
999 mono_domain_foreach (MonoDomainFunc func, gpointer user_data)
1005 * Create a copy of the data to avoid calling the user callback
1006 * inside the lock because that could lead to deadlocks.
1007 * We can do this because this function is not perf. critical.
1009 mono_appdomains_lock ();
1010 size = appdomain_list_size;
1011 copy = (MonoDomain **)mono_gc_alloc_fixed (appdomain_list_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "temporary domains list");
1012 memcpy (copy, appdomains_list, appdomain_list_size * sizeof (void*));
1013 mono_appdomains_unlock ();
1015 for (i = 0; i < size; ++i) {
1017 func (copy [i], user_data);
1020 mono_gc_free_fixed (copy);
1024 * mono_domain_assembly_open:
1025 * @domain: the application domain
1026 * @name: file name of the assembly
1028 * fixme: maybe we should integrate this with mono_assembly_open ??
1031 mono_domain_assembly_open (MonoDomain *domain, const char *name)
1033 MonoDomain *current;
1037 mono_domain_assemblies_lock (domain);
1038 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1039 ass = (MonoAssembly *)tmp->data;
1040 if (strcmp (name, ass->aname.name) == 0) {
1041 mono_domain_assemblies_unlock (domain);
1045 mono_domain_assemblies_unlock (domain);
1047 if (domain != mono_domain_get ()) {
1048 current = mono_domain_get ();
1050 mono_domain_set (domain, FALSE);
1051 ass = mono_assembly_open (name, NULL);
1052 mono_domain_set (current, FALSE);
1054 ass = mono_assembly_open (name, NULL);
1061 unregister_vtable_reflection_type (MonoVTable *vtable)
1063 MonoObject *type = (MonoObject *)vtable->type;
1065 if (type->vtable->klass != mono_defaults.runtimetype_class)
1066 MONO_GC_UNREGISTER_ROOT_IF_MOVING (vtable->type);
1071 * @domain: the domain to release
1072 * @force: if true, it allows the root domain to be released (used at shutdown only).
1074 * This releases the resources associated with the specific domain.
1075 * This is a low-level function that is invoked by the AppDomain infrastructure
1079 mono_domain_free (MonoDomain *domain, gboolean force)
1081 int code_size, code_alloc;
1085 if ((domain == mono_root_domain) && !force) {
1086 g_warning ("cant unload root domain");
1090 if (mono_dont_free_domains)
1093 mono_profiler_appdomain_event (domain, MONO_PROFILE_START_UNLOAD);
1095 mono_debug_domain_unload (domain);
1097 mono_appdomains_lock ();
1098 appdomains_list [domain->domain_id] = NULL;
1099 mono_appdomains_unlock ();
1101 /* must do this early as it accesses fields and types */
1102 if (domain->special_static_fields) {
1103 mono_alloc_special_static_data_free (domain->special_static_fields);
1104 g_hash_table_destroy (domain->special_static_fields);
1105 domain->special_static_fields = NULL;
1109 * We must destroy all these hash tables here because they
1110 * contain references to managed objects belonging to the
1111 * domain. Once we let the GC clear the domain there must be
1112 * no more such references, or we'll crash if a collection
1115 mono_g_hash_table_destroy (domain->ldstr_table);
1116 domain->ldstr_table = NULL;
1118 mono_g_hash_table_destroy (domain->env);
1121 mono_reflection_cleanup_domain (domain);
1123 /* This must be done before type_hash is freed */
1124 if (domain->class_vtable_array) {
1126 for (i = 0; i < domain->class_vtable_array->len; ++i)
1127 unregister_vtable_reflection_type ((MonoVTable *)g_ptr_array_index (domain->class_vtable_array, i));
1130 if (domain->type_hash) {
1131 mono_g_hash_table_destroy (domain->type_hash);
1132 domain->type_hash = NULL;
1134 if (domain->type_init_exception_hash) {
1135 mono_g_hash_table_destroy (domain->type_init_exception_hash);
1136 domain->type_init_exception_hash = NULL;
1139 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1140 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1141 mono_assembly_release_gc_roots (ass);
1144 /* Have to zero out reference fields since they will be invalidated by the clear_domain () call below */
1145 for (p = (gpointer*)&domain->MONO_DOMAIN_FIRST_OBJECT; p < (gpointer*)&domain->MONO_DOMAIN_FIRST_GC_TRACKED; ++p)
1148 /* This needs to be done before closing assemblies */
1149 mono_gc_clear_domain (domain);
1151 /* Close dynamic assemblies first, since they have no ref count */
1152 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1153 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1154 if (!ass->image || !image_is_dynamic (ass->image))
1156 mono_trace (G_LOG_LEVEL_INFO, MONO_TRACE_ASSEMBLY, "Unloading domain %s[%p], assembly %s[%p], ref_count=%d", domain->friendly_name, domain, ass->aname.name, ass, ass->ref_count);
1157 if (!mono_assembly_close_except_image_pools (ass))
1161 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1162 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1165 if (!ass->image || image_is_dynamic (ass->image))
1167 mono_trace (G_LOG_LEVEL_INFO, MONO_TRACE_ASSEMBLY, "Unloading domain %s[%p], assembly %s[%p], ref_count=%d", domain->friendly_name, domain, ass->aname.name, ass, ass->ref_count);
1168 if (!mono_assembly_close_except_image_pools (ass))
1172 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1173 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1175 mono_assembly_close_finish (ass);
1177 g_slist_free (domain->domain_assemblies);
1178 domain->domain_assemblies = NULL;
1181 * Send this after the assemblies have been unloaded and the domain is still in a
1184 mono_profiler_appdomain_event (domain, MONO_PROFILE_END_UNLOAD);
1186 if (free_domain_hook)
1187 free_domain_hook (domain);
1189 /* FIXME: free delegate_hash_table when it's used */
1190 if (domain->search_path) {
1191 g_strfreev (domain->search_path);
1192 domain->search_path = NULL;
1194 domain->create_proxy_for_type_method = NULL;
1195 domain->private_invoke_method = NULL;
1196 domain->default_context = NULL;
1197 domain->out_of_memory_ex = NULL;
1198 domain->null_reference_ex = NULL;
1199 domain->stack_overflow_ex = NULL;
1200 domain->ephemeron_tombstone = NULL;
1201 domain->entry_assembly = NULL;
1203 g_free (domain->friendly_name);
1204 domain->friendly_name = NULL;
1205 g_ptr_array_free (domain->class_vtable_array, TRUE);
1206 domain->class_vtable_array = NULL;
1207 g_hash_table_destroy (domain->proxy_vtable_hash);
1208 domain->proxy_vtable_hash = NULL;
1209 if (domain->static_data_array) {
1210 mono_gc_free_fixed (domain->static_data_array);
1211 domain->static_data_array = NULL;
1213 mono_internal_hash_table_destroy (&domain->jit_code_hash);
1216 * There might still be jit info tables of this domain which
1217 * are not freed. Since the domain cannot be in use anymore,
1218 * this will free them.
1220 mono_thread_hazardous_try_free_all ();
1221 if (domain->aot_modules)
1222 mono_jit_info_table_free (domain->aot_modules);
1223 g_assert (domain->num_jit_info_tables == 1);
1224 mono_jit_info_table_free (domain->jit_info_table);
1225 domain->jit_info_table = NULL;
1226 g_assert (!domain->jit_info_free_queue);
1228 /* collect statistics */
1229 code_alloc = mono_code_manager_size (domain->code_mp, &code_size);
1230 total_domain_code_alloc += code_alloc;
1231 max_domain_code_alloc = MAX (max_domain_code_alloc, code_alloc);
1232 max_domain_code_size = MAX (max_domain_code_size, code_size);
1234 if (debug_domain_unload) {
1235 mono_mempool_invalidate (domain->mp);
1236 mono_code_manager_invalidate (domain->code_mp);
1238 #ifndef DISABLE_PERFCOUNTERS
1239 mono_perfcounters->loader_bytes -= mono_mempool_get_allocated (domain->mp);
1241 mono_mempool_destroy (domain->mp);
1243 mono_code_manager_destroy (domain->code_mp);
1244 domain->code_mp = NULL;
1246 lock_free_mempool_free (domain->lock_free_mp);
1247 domain->lock_free_mp = NULL;
1249 g_hash_table_destroy (domain->finalizable_objects_hash);
1250 domain->finalizable_objects_hash = NULL;
1251 if (domain->method_rgctx_hash) {
1252 g_hash_table_destroy (domain->method_rgctx_hash);
1253 domain->method_rgctx_hash = NULL;
1255 if (domain->generic_virtual_cases) {
1256 g_hash_table_destroy (domain->generic_virtual_cases);
1257 domain->generic_virtual_cases = NULL;
1259 if (domain->ftnptrs_hash) {
1260 g_hash_table_destroy (domain->ftnptrs_hash);
1261 domain->ftnptrs_hash = NULL;
1263 if (domain->method_to_dyn_method) {
1264 g_hash_table_destroy (domain->method_to_dyn_method);
1265 domain->method_to_dyn_method = NULL;
1268 mono_os_mutex_destroy (&domain->finalizable_objects_hash_lock);
1269 mono_os_mutex_destroy (&domain->assemblies_lock);
1270 mono_os_mutex_destroy (&domain->jit_code_hash_lock);
1272 mono_coop_mutex_destroy (&domain->lock);
1274 domain->setup = NULL;
1276 mono_gc_deregister_root ((char*)&(domain->MONO_DOMAIN_FIRST_GC_TRACKED));
1278 /* FIXME: anything else required ? */
1280 mono_gc_free_fixed (domain);
1282 #ifndef DISABLE_PERFCOUNTERS
1283 mono_perfcounters->loader_appdomains--;
1286 if (domain == mono_root_domain)
1287 mono_root_domain = NULL;
1291 * mono_domain_get_by_id:
1294 * Returns: the domain for a specific domain id.
1297 mono_domain_get_by_id (gint32 domainid)
1299 MonoDomain * domain;
1301 mono_appdomains_lock ();
1302 if (domainid < appdomain_list_size)
1303 domain = appdomains_list [domainid];
1306 mono_appdomains_unlock ();
1312 * mono_domain_get_id:
1314 * A domain ID is guaranteed to be unique for as long as the domain
1315 * using it is alive. It may be reused later once the domain has been
1318 * Returns: The unique ID for @domain.
1321 mono_domain_get_id (MonoDomain *domain)
1323 return domain->domain_id;
1327 * mono_domain_get_friendly_name:
1329 * The returned string's lifetime is the same as @domain's. Consider
1330 * copying it if you need to store it somewhere.
1332 * Returns: The friendly name of @domain. Can be NULL if not yet set.
1335 mono_domain_get_friendly_name (MonoDomain *domain)
1337 return domain->friendly_name;
1341 * mono_domain_alloc:
1343 * LOCKING: Acquires the domain lock.
1346 mono_domain_alloc (MonoDomain *domain, guint size)
1350 mono_domain_lock (domain);
1351 #ifndef DISABLE_PERFCOUNTERS
1352 mono_perfcounters->loader_bytes += size;
1354 res = mono_mempool_alloc (domain->mp, size);
1355 mono_domain_unlock (domain);
1361 * mono_domain_alloc0:
1363 * LOCKING: Acquires the domain lock.
1366 mono_domain_alloc0 (MonoDomain *domain, guint size)
1370 mono_domain_lock (domain);
1371 #ifndef DISABLE_PERFCOUNTERS
1372 mono_perfcounters->loader_bytes += size;
1374 res = mono_mempool_alloc0 (domain->mp, size);
1375 mono_domain_unlock (domain);
1381 mono_domain_alloc0_lock_free (MonoDomain *domain, guint size)
1383 return lock_free_mempool_alloc0 (domain->lock_free_mp, size);
1387 * mono_domain_code_reserve:
1389 * LOCKING: Acquires the domain lock.
1392 mono_domain_code_reserve (MonoDomain *domain, int size)
1396 mono_domain_lock (domain);
1397 res = mono_code_manager_reserve (domain->code_mp, size);
1398 mono_domain_unlock (domain);
1404 * mono_domain_code_reserve_align:
1406 * LOCKING: Acquires the domain lock.
1409 mono_domain_code_reserve_align (MonoDomain *domain, int size, int alignment)
1413 mono_domain_lock (domain);
1414 res = mono_code_manager_reserve_align (domain->code_mp, size, alignment);
1415 mono_domain_unlock (domain);
1421 * mono_domain_code_commit:
1423 * LOCKING: Acquires the domain lock.
1426 mono_domain_code_commit (MonoDomain *domain, void *data, int size, int newsize)
1428 mono_domain_lock (domain);
1429 mono_code_manager_commit (domain->code_mp, data, size, newsize);
1430 mono_domain_unlock (domain);
1434 * mono_domain_code_foreach:
1435 * Iterate over the code thunks of the code manager of @domain.
1437 * The @func callback MUST not take any locks. If it really needs to, it must respect
1438 * the locking rules of the runtime: http://www.mono-project.com/Mono:Runtime:Documentation:ThreadSafety
1439 * LOCKING: Acquires the domain lock.
1443 mono_domain_code_foreach (MonoDomain *domain, MonoCodeManagerFunc func, void *user_data)
1445 mono_domain_lock (domain);
1446 mono_code_manager_foreach (domain->code_mp, func, user_data);
1447 mono_domain_unlock (domain);
1452 mono_context_set (MonoAppContext * new_context)
1454 SET_APPCONTEXT (new_context);
1460 * Returns: the current Mono Application Context.
1463 mono_context_get (void)
1465 return GET_APPCONTEXT ();
1469 * mono_context_get_id:
1470 * @context: the context to operate on.
1472 * Context IDs are guaranteed to be unique for the duration of a Mono
1473 * process; they are never reused.
1475 * Returns: The unique ID for @context.
1478 mono_context_get_id (MonoAppContext *context)
1480 return context->context_id;
1484 * mono_context_get_domain_id:
1485 * @context: the context to operate on.
1487 * Returns: The ID of the domain that @context was created in.
1490 mono_context_get_domain_id (MonoAppContext *context)
1492 return context->domain_id;
1495 /* LOCKING: the caller holds the lock for this domain */
1497 mono_domain_add_class_static_data (MonoDomain *domain, MonoClass *klass, gpointer data, guint32 *bitmap)
1499 /* Note [Domain Static Data Array]:
1501 * Entry 0 in the array is the index of the next free slot.
1502 * Entry 1 is the total size of the array.
1505 if (domain->static_data_array) {
1506 int size = GPOINTER_TO_INT (domain->static_data_array [1]);
1507 next = GPOINTER_TO_INT (domain->static_data_array [0]);
1509 /* 'data' is allocated by alloc_fixed */
1510 gpointer *new_array = (gpointer *)mono_gc_alloc_fixed (sizeof (gpointer) * (size * 2), MONO_GC_ROOT_DESCR_FOR_FIXED (size * 2), MONO_ROOT_SOURCE_DOMAIN, "static field list");
1511 mono_gc_memmove_aligned (new_array, domain->static_data_array, sizeof (gpointer) * size);
1513 new_array [1] = GINT_TO_POINTER (size);
1514 mono_gc_free_fixed (domain->static_data_array);
1515 domain->static_data_array = new_array;
1519 gpointer *new_array = (gpointer *)mono_gc_alloc_fixed (sizeof (gpointer) * size, MONO_GC_ROOT_DESCR_FOR_FIXED (size), MONO_ROOT_SOURCE_DOMAIN, "static field list");
1521 new_array [0] = GINT_TO_POINTER (next);
1522 new_array [1] = GINT_TO_POINTER (size);
1523 domain->static_data_array = new_array;
1525 domain->static_data_array [next++] = data;
1526 domain->static_data_array [0] = GINT_TO_POINTER (next);
1532 * Use this function to get the `MonoImage*` for the mscorlib.dll assembly
1534 * Returns: The MonoImage for mscorlib.dll
1537 mono_get_corlib (void)
1539 return mono_defaults.corlib;
1543 * mono_get_object_class:
1545 * Use this function to get the `MonoClass*` that the runtime is using for `System.Object`.
1547 * Returns: The `MonoClass*` for the `System.Object` type.
1550 mono_get_object_class (void)
1552 return mono_defaults.object_class;
1556 * mono_get_byte_class:
1558 * Use this function to get the `MonoClass*` that the runtime is using for `System.Byte`.
1560 * Returns: The `MonoClass*` for the `System.Byte` type.
1563 mono_get_byte_class (void)
1565 return mono_defaults.byte_class;
1569 * mono_get_void_class:
1571 * Use this function to get the `MonoClass*` that the runtime is using for `System.Void`.
1573 * Returns: The `MonoClass*` for the `System.Void` type.
1576 mono_get_void_class (void)
1578 return mono_defaults.void_class;
1582 * mono_get_boolean_class:
1584 * Use this function to get the `MonoClass*` that the runtime is using for `System.Boolean`.
1586 * Returns: The `MonoClass*` for the `System.Boolean` type.
1589 mono_get_boolean_class (void)
1591 return mono_defaults.boolean_class;
1595 * mono_get_sbyte_class:
1597 * Use this function to get the `MonoClass*` that the runtime is using for `System.SByte`.
1599 * Returns: The `MonoClass*` for the `System.SByte` type.
1602 mono_get_sbyte_class (void)
1604 return mono_defaults.sbyte_class;
1608 * mono_get_int16_class:
1610 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int16`.
1612 * Returns: The `MonoClass*` for the `System.Int16` type.
1615 mono_get_int16_class (void)
1617 return mono_defaults.int16_class;
1621 * mono_get_uint16_class:
1623 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt16`.
1625 * Returns: The `MonoClass*` for the `System.UInt16` type.
1628 mono_get_uint16_class (void)
1630 return mono_defaults.uint16_class;
1634 * mono_get_int32_class:
1636 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int32`.
1638 * Returns: The `MonoClass*` for the `System.Int32` type.
1641 mono_get_int32_class (void)
1643 return mono_defaults.int32_class;
1647 * mono_get_uint32_class:
1649 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt32`.
1651 * Returns: The `MonoClass*` for the `System.UInt32` type.
1654 mono_get_uint32_class (void)
1656 return mono_defaults.uint32_class;
1660 * mono_get_intptr_class:
1662 * Use this function to get the `MonoClass*` that the runtime is using for `System.IntPtr`.
1664 * Returns: The `MonoClass*` for the `System.IntPtr` type.
1667 mono_get_intptr_class (void)
1669 return mono_defaults.int_class;
1673 * mono_get_uintptr_class:
1675 * Use this function to get the `MonoClass*` that the runtime is using for `System.UIntPtr`.
1677 * Returns: The `MonoClass*` for the `System.UIntPtr` type.
1680 mono_get_uintptr_class (void)
1682 return mono_defaults.uint_class;
1686 * mono_get_int64_class:
1688 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int64`.
1690 * Returns: The `MonoClass*` for the `System.Int64` type.
1693 mono_get_int64_class (void)
1695 return mono_defaults.int64_class;
1699 * mono_get_uint64_class:
1701 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt64`.
1703 * Returns: The `MonoClass*` for the `System.UInt64` type.
1706 mono_get_uint64_class (void)
1708 return mono_defaults.uint64_class;
1712 * mono_get_single_class:
1714 * Use this function to get the `MonoClass*` that the runtime is using for `System.Single` (32-bit floating points).
1716 * Returns: The `MonoClass*` for the `System.Single` type.
1719 mono_get_single_class (void)
1721 return mono_defaults.single_class;
1725 * mono_get_double_class:
1727 * Use this function to get the `MonoClass*` that the runtime is using for `System.Double` (64-bit floating points).
1729 * Returns: The `MonoClass*` for the `System.Double` type.
1732 mono_get_double_class (void)
1734 return mono_defaults.double_class;
1738 * mono_get_char_class:
1740 * Use this function to get the `MonoClass*` that the runtime is using for `System.Char`.
1742 * Returns: The `MonoClass*` for the `System.Char` type.
1745 mono_get_char_class (void)
1747 return mono_defaults.char_class;
1751 * mono_get_string_class:
1753 * Use this function to get the `MonoClass*` that the runtime is using for `System.String`.
1755 * Returns: The `MonoClass*` for the `System.String` type.
1758 mono_get_string_class (void)
1760 return mono_defaults.string_class;
1764 * mono_get_enum_class:
1766 * Use this function to get the `MonoClass*` that the runtime is using for `System.Enum`.
1768 * Returns: The `MonoClass*` for the `System.Enum` type.
1771 mono_get_enum_class (void)
1773 return mono_defaults.enum_class;
1777 * mono_get_array_class:
1779 * Use this function to get the `MonoClass*` that the runtime is using for `System.Array`.
1781 * Returns: The `MonoClass*` for the `System.Array` type.
1784 mono_get_array_class (void)
1786 return mono_defaults.array_class;
1790 * mono_get_thread_class:
1792 * Use this function to get the `MonoClass*` that the runtime is using for `System.Threading.Thread`.
1794 * Returns: The `MonoClass*` for the `System.Threading.Thread` type.
1797 mono_get_thread_class (void)
1799 return mono_defaults.thread_class;
1803 * mono_get_exception_class:
1805 * Use this function to get the `MonoClass*` that the runtime is using for `System.Exception`.
1807 * Returns: The `MonoClass*` for the `` type.
1810 mono_get_exception_class (void)
1812 return mono_defaults.exception_class;
1816 static char* get_attribute_value (const gchar **attribute_names,
1817 const gchar **attribute_values,
1818 const char *att_name)
1821 for (n=0; attribute_names[n] != NULL; n++) {
1822 if (strcmp (attribute_names[n], att_name) == 0)
1823 return g_strdup (attribute_values[n]);
1828 static void start_element (GMarkupParseContext *context,
1829 const gchar *element_name,
1830 const gchar **attribute_names,
1831 const gchar **attribute_values,
1835 AppConfigInfo* app_config = (AppConfigInfo*) user_data;
1837 if (strcmp (element_name, "configuration") == 0) {
1838 app_config->configuration_count++;
1841 if (strcmp (element_name, "startup") == 0) {
1842 app_config->startup_count++;
1846 if (app_config->configuration_count != 1 || app_config->startup_count != 1)
1849 if (strcmp (element_name, "requiredRuntime") == 0) {
1850 app_config->required_runtime = get_attribute_value (attribute_names, attribute_values, "version");
1851 } else if (strcmp (element_name, "supportedRuntime") == 0) {
1852 char *version = get_attribute_value (attribute_names, attribute_values, "version");
1853 app_config->supported_runtimes = g_slist_append (app_config->supported_runtimes, version);
1857 static void end_element (GMarkupParseContext *context,
1858 const gchar *element_name,
1862 AppConfigInfo* app_config = (AppConfigInfo*) user_data;
1864 if (strcmp (element_name, "configuration") == 0) {
1865 app_config->configuration_count--;
1866 } else if (strcmp (element_name, "startup") == 0) {
1867 app_config->startup_count--;
1871 static const GMarkupParser
1880 static AppConfigInfo *
1881 app_config_parse (const char *exe_filename)
1883 AppConfigInfo *app_config;
1884 GMarkupParseContext *context;
1887 const char *bundled_config;
1888 char *config_filename;
1890 bundled_config = mono_config_string_for_assembly_file (exe_filename);
1892 if (bundled_config) {
1893 text = g_strdup (bundled_config);
1894 len = strlen (text);
1896 config_filename = g_strconcat (exe_filename, ".config", NULL);
1898 if (!g_file_get_contents (config_filename, &text, &len, NULL)) {
1899 g_free (config_filename);
1902 g_free (config_filename);
1905 app_config = g_new0 (AppConfigInfo, 1);
1907 context = g_markup_parse_context_new (&mono_parser, (GMarkupParseFlags)0, app_config, NULL);
1908 if (g_markup_parse_context_parse (context, text, len, NULL)) {
1909 g_markup_parse_context_end_parse (context, NULL);
1911 g_markup_parse_context_free (context);
1917 app_config_free (AppConfigInfo* app_config)
1920 GSList *list = app_config->supported_runtimes;
1921 while (list != NULL) {
1922 rt = (char*)list->data;
1924 list = g_slist_next (list);
1926 g_slist_free (app_config->supported_runtimes);
1927 g_free (app_config->required_runtime);
1928 g_free (app_config);
1932 static const MonoRuntimeInfo*
1933 get_runtime_by_version (const char *version)
1936 int max = G_N_ELEMENTS (supported_runtimes);
1942 for (n=0; n<max; n++) {
1943 if (strcmp (version, supported_runtimes[n].runtime_version) == 0)
1944 return &supported_runtimes[n];
1947 vlen = strlen (version);
1948 if (vlen >= 4 && version [1] - '0' >= 4) {
1949 for (n=0; n<max; n++) {
1950 if (strncmp (version, supported_runtimes[n].runtime_version, 4) == 0)
1951 return &supported_runtimes[n];
1959 get_runtimes_from_exe (const char *exe_file, MonoImage **exe_image, const MonoRuntimeInfo** runtimes)
1961 AppConfigInfo* app_config;
1963 const MonoRuntimeInfo* runtime = NULL;
1964 MonoImage *image = NULL;
1966 app_config = app_config_parse (exe_file);
1968 if (app_config != NULL) {
1969 /* Check supportedRuntime elements, if none is supported, fail.
1970 * If there are no such elements, look for a requiredRuntime element.
1972 if (app_config->supported_runtimes != NULL) {
1974 GSList *list = app_config->supported_runtimes;
1975 while (list != NULL) {
1976 version = (char*) list->data;
1977 runtime = get_runtime_by_version (version);
1978 if (runtime != NULL)
1979 runtimes [n++] = runtime;
1980 list = g_slist_next (list);
1982 runtimes [n] = NULL;
1983 app_config_free (app_config);
1987 /* Check the requiredRuntime element. This is for 1.0 apps only. */
1988 if (app_config->required_runtime != NULL) {
1989 runtimes [0] = get_runtime_by_version (app_config->required_runtime);
1990 runtimes [1] = NULL;
1991 app_config_free (app_config);
1994 app_config_free (app_config);
1997 /* Look for a runtime with the exact version */
1998 image = mono_assembly_open_from_bundle (exe_file, NULL, FALSE);
2001 image = mono_image_open (exe_file, NULL);
2003 if (image == NULL) {
2004 /* The image is wrong or the file was not found. In this case return
2005 * a default runtime and leave to the initialization method the work of
2006 * reporting the error.
2008 runtimes [0] = get_runtime_by_version (DEFAULT_RUNTIME_VERSION);
2009 runtimes [1] = NULL;
2015 runtimes [0] = get_runtime_by_version (image->version);
2016 runtimes [1] = NULL;
2021 * mono_get_runtime_info:
2023 * Returns: the version of the current runtime instance.
2025 const MonoRuntimeInfo*
2026 mono_get_runtime_info (void)
2028 return current_runtime;
2032 * mono_framework_version:
2034 * Return the major version of the framework curently executing.
2037 mono_framework_version (void)
2039 return current_runtime->framework_version [0] - '0';
2043 mono_enable_debug_domain_unload (gboolean enable)
2045 debug_domain_unload = enable;
2048 MonoAotCacheConfig *
2049 mono_get_aot_cache_config (void)
2051 return &aot_cache_config;
2055 mono_domain_lock (MonoDomain *domain)
2057 mono_locks_coop_acquire (&domain->lock, DomainLock);
2061 mono_domain_unlock (MonoDomain *domain)
2063 mono_locks_coop_release (&domain->lock, DomainLock);