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/appdomain.h>
38 #include <mono/metadata/mono-debug-debugger.h>
39 #include <mono/metadata/mono-config.h>
40 #include <mono/metadata/threads-types.h>
41 #include <mono/metadata/runtime.h>
42 #include <mono/metadata/w32mutex.h>
43 #include <mono/metadata/w32semaphore.h>
44 #include <mono/metadata/w32event.h>
45 #include <mono/metadata/w32process.h>
46 #include <mono/metadata/w32file.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 #define GET_APPDOMAIN() ((MonoDomain*)mono_tls_get_domain ())
54 #define SET_APPDOMAIN(x) do { \
55 MonoThreadInfo *info; \
56 mono_tls_set_domain (x); \
57 info = mono_thread_info_current (); \
59 mono_thread_info_tls_set (info, TLS_KEY_DOMAIN, (x)); \
62 #define GET_APPCONTEXT() (mono_thread_internal_current ()->current_appcontext)
63 #define SET_APPCONTEXT(x) MONO_OBJECT_SETREF (mono_thread_internal_current (), current_appcontext, (x))
65 static guint16 appdomain_list_size = 0;
66 static guint16 appdomain_next = 0;
67 static MonoDomain **appdomains_list = NULL;
68 static MonoImage *exe_image;
69 static gboolean debug_domain_unload;
71 gboolean mono_dont_free_domains;
73 #define mono_appdomains_lock() mono_coop_mutex_lock (&appdomains_mutex)
74 #define mono_appdomains_unlock() mono_coop_mutex_unlock (&appdomains_mutex)
75 static MonoCoopMutex appdomains_mutex;
77 static MonoDomain *mono_root_domain = NULL;
80 static int max_domain_code_size = 0;
81 static int max_domain_code_alloc = 0;
82 static int total_domain_code_alloc = 0;
84 /* AppConfigInfo: Information about runtime versions supported by an
88 GSList *supported_runtimes;
89 char *required_runtime;
90 int configuration_count;
94 static const MonoRuntimeInfo *current_runtime = NULL;
96 /* This is the list of runtime versions supported by this JIT.
98 static const MonoRuntimeInfo supported_runtimes[] = {
99 {"v4.0.30319","4.5", { {4,0,0,0}, {10,0,0,0}, {4,0,0,0}, {4,0,0,0} } },
100 {"mobile", "2.1", { {2,0,5,0}, {10,0,0,0}, {2,0,5,0}, {2,0,5,0} } },
101 {"moonlight", "2.1", { {2,0,5,0}, { 9,0,0,0}, {3,5,0,0}, {3,0,0,0} } },
105 /* The stable runtime version */
106 #define DEFAULT_RUNTIME_VERSION "v4.0.30319"
108 /* Callbacks installed by the JIT */
109 static MonoCreateDomainFunc create_domain_hook;
110 static MonoFreeDomainFunc free_domain_hook;
112 /* AOT cache configuration */
113 static MonoAotCacheConfig aot_cache_config;
116 get_runtimes_from_exe (const char *exe_file, MonoImage **exe_image, const MonoRuntimeInfo** runtimes);
118 static const MonoRuntimeInfo*
119 get_runtime_by_version (const char *version);
121 #define ALIGN_TO(val,align) ((((guint64)val) + ((align) - 1)) & ~((align) - 1))
122 #define ALIGN_PTR_TO(ptr,align) (gpointer)((((gssize)(ptr)) + (align - 1)) & (~(align - 1)))
124 static LockFreeMempool*
125 lock_free_mempool_new (void)
127 return g_new0 (LockFreeMempool, 1);
131 lock_free_mempool_free (LockFreeMempool *mp)
133 LockFreeMempoolChunk *chunk, *next;
137 next = (LockFreeMempoolChunk *)chunk->prev;
138 mono_vfree (chunk, mono_pagesize (), MONO_MEM_ACCOUNT_DOMAIN);
147 static LockFreeMempoolChunk*
148 lock_free_mempool_chunk_new (LockFreeMempool *mp, int len)
150 LockFreeMempoolChunk *chunk, *prev;
153 size = mono_pagesize ();
154 while (size - sizeof (LockFreeMempoolChunk) < len)
155 size += mono_pagesize ();
156 chunk = (LockFreeMempoolChunk *)mono_valloc (0, size, MONO_MMAP_READ|MONO_MMAP_WRITE, MONO_MEM_ACCOUNT_DOMAIN);
158 chunk->mem = (guint8 *)ALIGN_PTR_TO ((char*)chunk + sizeof (LockFreeMempoolChunk), 16);
159 chunk->size = ((char*)chunk + size) - (char*)chunk->mem;
162 /* Add to list of chunks lock-free */
165 if (InterlockedCompareExchangePointer ((volatile gpointer*)&mp->chunks, chunk, prev) == prev)
177 lock_free_mempool_alloc0 (LockFreeMempool *mp, guint size)
179 LockFreeMempoolChunk *chunk;
183 // FIXME: Free the allocator
185 size = ALIGN_TO (size, 8);
188 chunk = lock_free_mempool_chunk_new (mp, size);
189 mono_memory_barrier ();
194 /* The code below is lock-free, 'chunk' is shared state */
195 oldpos = InterlockedExchangeAdd (&chunk->pos, size);
196 if (oldpos + size > chunk->size) {
197 chunk = lock_free_mempool_chunk_new (mp, size);
198 g_assert (chunk->pos + size <= chunk->size);
201 mono_memory_barrier ();
204 res = (char*)chunk->mem + oldpos;
211 mono_install_create_domain_hook (MonoCreateDomainFunc func)
213 create_domain_hook = func;
217 mono_install_free_domain_hook (MonoFreeDomainFunc func)
219 free_domain_hook = func;
224 * @s1: First string to compare
225 * @s2: Second string to compare
227 * Compares two `MonoString*` instances ordinally for equality.
229 * Returns FALSE if the strings differ.
232 mono_string_equal (MonoString *s1, MonoString *s2)
234 int l1 = mono_string_length (s1);
235 int l2 = mono_string_length (s2);
242 return memcmp (mono_string_chars (s1), mono_string_chars (s2), l1 * 2) == 0;
247 * @s: the string to hash
249 * Compute the hash for a `MonoString*`
250 * Returns the hash for the string.
253 mono_string_hash (MonoString *s)
255 const guint16 *p = mono_string_chars (s);
256 int i, len = mono_string_length (s);
259 for (i = 0; i < len; i++) {
260 h = (h << 5) - h + *p;
268 mono_ptrarray_equal (gpointer *s1, gpointer *s2)
270 int len = GPOINTER_TO_INT (s1 [0]);
271 if (len != GPOINTER_TO_INT (s2 [0]))
274 return memcmp (s1 + 1, s2 + 1, len * sizeof(gpointer)) == 0;
278 mono_ptrarray_hash (gpointer *s)
281 int len = GPOINTER_TO_INT (s [0]);
284 for (i = 1; i < len; i++)
285 hash += GPOINTER_TO_UINT (s [i]);
291 * Allocate an id for domain and set domain->domain_id.
292 * LOCKING: must be called while holding appdomains_mutex.
293 * We try to assign low numbers to the domain, so it can be used
294 * as an index in data tables to lookup domain-specific info
295 * with minimal memory overhead. We also try not to reuse the
296 * same id too quickly (to help debugging).
299 domain_id_alloc (MonoDomain *domain)
302 if (!appdomains_list) {
303 appdomain_list_size = 2;
304 appdomains_list = (MonoDomain **)mono_gc_alloc_fixed (appdomain_list_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "domains list");
306 for (i = appdomain_next; i < appdomain_list_size; ++i) {
307 if (!appdomains_list [i]) {
313 for (i = 0; i < appdomain_next; ++i) {
314 if (!appdomains_list [i]) {
321 MonoDomain **new_list;
322 int new_size = appdomain_list_size * 2;
323 if (new_size >= (1 << 16))
324 g_assert_not_reached ();
325 id = appdomain_list_size;
326 new_list = (MonoDomain **)mono_gc_alloc_fixed (new_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "domains list");
327 memcpy (new_list, appdomains_list, appdomain_list_size * sizeof (void*));
328 mono_gc_free_fixed (appdomains_list);
329 appdomains_list = new_list;
330 appdomain_list_size = new_size;
332 domain->domain_id = id;
333 appdomains_list [id] = domain;
335 if (appdomain_next > appdomain_list_size)
340 static gsize domain_gc_bitmap [sizeof(MonoDomain)/4/32 + 1];
341 static MonoGCDescriptor domain_gc_desc = MONO_GC_DESCRIPTOR_NULL;
342 static guint32 domain_shadow_serial = 0L;
345 * mono_domain_create:
347 * Creates a new application domain, the unmanaged representation
348 * of the actual domain. Usually you will want to create the
350 * Application domains provide an isolation facilty for assemblies. You
351 * can load assemblies and execute code in them that will not be visible
352 * to other application domains. This is a runtime-based virtualization
355 * It is possible to unload domains, which unloads the assemblies and
356 * data that was allocated in that domain.
358 * When a domain is created a mempool is allocated for domain-specific
359 * structures, along a dedicated code manager to hold code that is
360 * associated with the domain.
362 * Returns: New initialized MonoDomain, with no configuration or assemblies
366 mono_domain_create (void)
369 guint32 shadow_serial;
371 mono_appdomains_lock ();
372 shadow_serial = domain_shadow_serial++;
374 if (!domain_gc_desc) {
375 unsigned int i, bit = 0;
376 for (i = G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_FIRST_OBJECT); i < G_STRUCT_OFFSET (MonoDomain, MONO_DOMAIN_FIRST_GC_TRACKED); i += sizeof (gpointer)) {
377 bit = i / sizeof (gpointer);
378 domain_gc_bitmap [bit / 32] |= (gsize) 1 << (bit % 32);
380 domain_gc_desc = mono_gc_make_descr_from_bitmap ((gsize*)domain_gc_bitmap, bit + 1);
382 mono_appdomains_unlock ();
386 * Boehm doesn't like roots inside GC allocated objects, and alloc_fixed returns
387 * a GC_MALLOC-ed object, contrary to the api docs. This causes random crashes when
388 * running the corlib test suite.
389 * To solve this, we pass a NULL descriptor, and don't register roots.
391 domain = (MonoDomain *)mono_gc_alloc_fixed (sizeof (MonoDomain), NULL, MONO_ROOT_SOURCE_DOMAIN, "domain object");
393 domain = (MonoDomain *)mono_gc_alloc_fixed (sizeof (MonoDomain), domain_gc_desc, MONO_ROOT_SOURCE_DOMAIN, "domain object");
394 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");
396 domain->shadow_serial = shadow_serial;
397 domain->domain = NULL;
398 domain->setup = NULL;
399 domain->friendly_name = NULL;
400 domain->search_path = NULL;
402 mono_profiler_appdomain_event (domain, MONO_PROFILE_START_LOAD);
404 domain->mp = mono_mempool_new ();
405 domain->code_mp = mono_code_manager_new ();
406 domain->lock_free_mp = lock_free_mempool_new ();
407 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");
408 domain->domain_assemblies = NULL;
409 domain->assembly_bindings = NULL;
410 domain->assembly_bindings_parsed = FALSE;
411 domain->class_vtable_array = g_ptr_array_new ();
412 domain->proxy_vtable_hash = g_hash_table_new ((GHashFunc)mono_ptrarray_hash, (GCompareFunc)mono_ptrarray_equal);
413 domain->static_data_array = NULL;
414 mono_jit_code_hash_init (&domain->jit_code_hash);
415 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");
416 domain->num_jit_info_tables = 1;
417 domain->jit_info_table = mono_jit_info_table_new (domain);
418 domain->jit_info_free_queue = NULL;
419 domain->finalizable_objects_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
420 domain->ftnptrs_hash = g_hash_table_new (mono_aligned_addr_hash, NULL);
422 mono_coop_mutex_init_recursive (&domain->lock);
424 mono_os_mutex_init_recursive (&domain->assemblies_lock);
425 mono_os_mutex_init_recursive (&domain->jit_code_hash_lock);
426 mono_os_mutex_init_recursive (&domain->finalizable_objects_hash_lock);
428 domain->method_rgctx_hash = NULL;
430 mono_appdomains_lock ();
431 domain_id_alloc (domain);
432 mono_appdomains_unlock ();
434 #ifndef DISABLE_PERFCOUNTERS
435 mono_perfcounters->loader_appdomains++;
436 mono_perfcounters->loader_total_appdomains++;
439 mono_debug_domain_create (domain);
441 if (create_domain_hook)
442 create_domain_hook (domain);
444 mono_profiler_appdomain_loaded (domain, MONO_PROFILE_OK);
450 * mono_init_internal:
452 * Creates the initial application domain and initializes the mono_defaults
454 * This function is guaranteed to not run any IL code.
455 * If exe_filename is not NULL, the method will determine the required runtime
456 * from the exe configuration file or the version PE field.
457 * If runtime_version is not NULL, that runtime version will be used.
458 * Either exe_filename or runtime_version must be provided.
460 * Returns: the initial domain.
463 mono_init_internal (const char *filename, const char *exe_filename, const char *runtime_version)
465 static MonoDomain *domain = NULL;
466 MonoAssembly *ass = NULL;
467 MonoImageOpenStatus status = MONO_IMAGE_OK;
468 const MonoRuntimeInfo* runtimes [G_N_ELEMENTS (supported_runtimes) + 1] = { NULL };
471 #ifdef DEBUG_DOMAIN_UNLOAD
472 debug_domain_unload = TRUE;
476 g_assert_not_reached ();
478 #if defined(HOST_WIN32) && G_HAVE_API_SUPPORT(HAVE_CLASSIC_WINAPI_SUPPORT)
479 /* Avoid system error message boxes. */
480 SetErrorMode (SEM_FAILCRITICALERRORS | SEM_NOOPENFILEERRORBOX);
484 mono_w32handle_init ();
485 mono_w32handle_namespace_init ();
488 mono_w32mutex_init ();
489 mono_w32semaphore_init ();
490 mono_w32event_init ();
491 mono_w32process_init ();
492 mono_w32file_init ();
494 #ifndef DISABLE_PERFCOUNTERS
495 mono_perfcounters_init ();
497 mono_counters_init ();
499 mono_counters_register ("Max native code in a domain", MONO_COUNTER_INT|MONO_COUNTER_JIT, &max_domain_code_size);
500 mono_counters_register ("Max code space allocated in a domain", MONO_COUNTER_INT|MONO_COUNTER_JIT, &max_domain_code_alloc);
501 mono_counters_register ("Total code space allocated", MONO_COUNTER_INT|MONO_COUNTER_JIT, &total_domain_code_alloc);
503 mono_gc_base_init ();
504 mono_thread_info_attach (&dummy);
506 mono_coop_mutex_init_recursive (&appdomains_mutex);
508 mono_metadata_init ();
510 mono_assemblies_init ();
511 mono_classes_init ();
513 mono_reflection_init ();
514 mono_runtime_init_tls ();
516 /* FIXME: When should we release this memory? */
517 MONO_GC_REGISTER_ROOT_FIXED (appdomains_list, MONO_ROOT_SOURCE_DOMAIN, "domains list");
519 domain = mono_domain_create ();
520 mono_root_domain = domain;
522 SET_APPDOMAIN (domain);
524 /* Get a list of runtimes supported by the exe */
525 if (exe_filename != NULL) {
527 * This function will load the exe file as a MonoImage. We need to close it, but
528 * that would mean it would be reloaded later. So instead, we save it to
529 * exe_image, and close it during shutdown.
531 get_runtimes_from_exe (exe_filename, &exe_image, runtimes);
534 exe_image = mono_assembly_open_from_bundle (exe_filename, NULL, FALSE);
536 exe_image = mono_image_open (exe_filename, NULL);
538 mono_fixup_exe_image (exe_image);
540 } else if (runtime_version != NULL) {
541 runtimes [0] = get_runtime_by_version (runtime_version);
545 if (runtimes [0] == NULL) {
546 const MonoRuntimeInfo *default_runtime = get_runtime_by_version (DEFAULT_RUNTIME_VERSION);
547 runtimes [0] = default_runtime;
549 g_print ("WARNING: The runtime version supported by this application is unavailable.\n");
550 g_print ("Using default runtime: %s\n", default_runtime->runtime_version);
553 /* The selected runtime will be the first one for which there is a mscrolib.dll */
554 for (n = 0; runtimes [n] != NULL && ass == NULL; n++) {
555 current_runtime = runtimes [n];
556 ass = mono_assembly_load_corlib (current_runtime, &status);
557 if (status != MONO_IMAGE_OK && status != MONO_IMAGE_ERROR_ERRNO)
562 if ((status != MONO_IMAGE_OK) || (ass == NULL)) {
564 case MONO_IMAGE_ERROR_ERRNO: {
565 char *corlib_file = g_build_filename (mono_assembly_getrootdir (), "mono", current_runtime->framework_version, "mscorlib.dll", NULL);
566 g_print ("The assembly mscorlib.dll was not found or could not be loaded.\n");
567 g_print ("It should have been installed in the `%s' directory.\n", corlib_file);
568 g_free (corlib_file);
571 case MONO_IMAGE_IMAGE_INVALID:
572 g_print ("The file %s/mscorlib.dll is an invalid CIL image\n",
573 mono_assembly_getrootdir ());
575 case MONO_IMAGE_MISSING_ASSEMBLYREF:
576 g_print ("Missing assembly reference in %s/mscorlib.dll\n",
577 mono_assembly_getrootdir ());
580 /* to suppress compiler warning */
586 mono_defaults.corlib = mono_assembly_get_image (ass);
588 mono_defaults.object_class = mono_class_load_from_name (
589 mono_defaults.corlib, "System", "Object");
591 mono_defaults.void_class = mono_class_load_from_name (
592 mono_defaults.corlib, "System", "Void");
594 mono_defaults.boolean_class = mono_class_load_from_name (
595 mono_defaults.corlib, "System", "Boolean");
597 mono_defaults.byte_class = mono_class_load_from_name (
598 mono_defaults.corlib, "System", "Byte");
600 mono_defaults.sbyte_class = mono_class_load_from_name (
601 mono_defaults.corlib, "System", "SByte");
603 mono_defaults.int16_class = mono_class_load_from_name (
604 mono_defaults.corlib, "System", "Int16");
606 mono_defaults.uint16_class = mono_class_load_from_name (
607 mono_defaults.corlib, "System", "UInt16");
609 mono_defaults.int32_class = mono_class_load_from_name (
610 mono_defaults.corlib, "System", "Int32");
612 mono_defaults.uint32_class = mono_class_load_from_name (
613 mono_defaults.corlib, "System", "UInt32");
615 mono_defaults.uint_class = mono_class_load_from_name (
616 mono_defaults.corlib, "System", "UIntPtr");
618 mono_defaults.int_class = mono_class_load_from_name (
619 mono_defaults.corlib, "System", "IntPtr");
621 mono_defaults.int64_class = mono_class_load_from_name (
622 mono_defaults.corlib, "System", "Int64");
624 mono_defaults.uint64_class = mono_class_load_from_name (
625 mono_defaults.corlib, "System", "UInt64");
627 mono_defaults.single_class = mono_class_load_from_name (
628 mono_defaults.corlib, "System", "Single");
630 mono_defaults.double_class = mono_class_load_from_name (
631 mono_defaults.corlib, "System", "Double");
633 mono_defaults.char_class = mono_class_load_from_name (
634 mono_defaults.corlib, "System", "Char");
636 mono_defaults.string_class = mono_class_load_from_name (
637 mono_defaults.corlib, "System", "String");
639 mono_defaults.enum_class = mono_class_load_from_name (
640 mono_defaults.corlib, "System", "Enum");
642 mono_defaults.array_class = mono_class_load_from_name (
643 mono_defaults.corlib, "System", "Array");
645 mono_defaults.delegate_class = mono_class_load_from_name (
646 mono_defaults.corlib, "System", "Delegate");
648 mono_defaults.multicastdelegate_class = mono_class_load_from_name (
649 mono_defaults.corlib, "System", "MulticastDelegate");
651 mono_defaults.asyncresult_class = mono_class_load_from_name (
652 mono_defaults.corlib, "System.Runtime.Remoting.Messaging",
655 mono_defaults.manualresetevent_class = mono_class_load_from_name (
656 mono_defaults.corlib, "System.Threading", "ManualResetEvent");
658 mono_defaults.typehandle_class = mono_class_load_from_name (
659 mono_defaults.corlib, "System", "RuntimeTypeHandle");
661 mono_defaults.methodhandle_class = mono_class_load_from_name (
662 mono_defaults.corlib, "System", "RuntimeMethodHandle");
664 mono_defaults.fieldhandle_class = mono_class_load_from_name (
665 mono_defaults.corlib, "System", "RuntimeFieldHandle");
667 mono_defaults.systemtype_class = mono_class_load_from_name (
668 mono_defaults.corlib, "System", "Type");
670 mono_defaults.runtimetype_class = mono_class_load_from_name (
671 mono_defaults.corlib, "System", "RuntimeType");
673 mono_defaults.exception_class = mono_class_load_from_name (
674 mono_defaults.corlib, "System", "Exception");
676 mono_defaults.threadabortexception_class = mono_class_load_from_name (
677 mono_defaults.corlib, "System.Threading", "ThreadAbortException");
679 mono_defaults.thread_class = mono_class_load_from_name (
680 mono_defaults.corlib, "System.Threading", "Thread");
682 mono_defaults.internal_thread_class = mono_class_load_from_name (
683 mono_defaults.corlib, "System.Threading", "InternalThread");
685 mono_defaults.appdomain_class = mono_class_load_from_name (
686 mono_defaults.corlib, "System", "AppDomain");
688 #ifndef DISABLE_REMOTING
689 mono_defaults.transparent_proxy_class = mono_class_load_from_name (
690 mono_defaults.corlib, "System.Runtime.Remoting.Proxies", "TransparentProxy");
692 mono_defaults.real_proxy_class = mono_class_load_from_name (
693 mono_defaults.corlib, "System.Runtime.Remoting.Proxies", "RealProxy");
695 mono_defaults.marshalbyrefobject_class = mono_class_load_from_name (
696 mono_defaults.corlib, "System", "MarshalByRefObject");
698 mono_defaults.iremotingtypeinfo_class = mono_class_load_from_name (
699 mono_defaults.corlib, "System.Runtime.Remoting", "IRemotingTypeInfo");
703 mono_defaults.mono_method_message_class = mono_class_load_from_name (
704 mono_defaults.corlib, "System.Runtime.Remoting.Messaging", "MonoMethodMessage");
706 mono_defaults.field_info_class = mono_class_load_from_name (
707 mono_defaults.corlib, "System.Reflection", "FieldInfo");
709 mono_defaults.method_info_class = mono_class_load_from_name (
710 mono_defaults.corlib, "System.Reflection", "MethodInfo");
712 mono_defaults.stringbuilder_class = mono_class_load_from_name (
713 mono_defaults.corlib, "System.Text", "StringBuilder");
715 mono_defaults.math_class = mono_class_load_from_name (
716 mono_defaults.corlib, "System", "Math");
718 mono_defaults.stack_frame_class = mono_class_load_from_name (
719 mono_defaults.corlib, "System.Diagnostics", "StackFrame");
721 mono_defaults.stack_trace_class = mono_class_load_from_name (
722 mono_defaults.corlib, "System.Diagnostics", "StackTrace");
724 mono_defaults.marshal_class = mono_class_load_from_name (
725 mono_defaults.corlib, "System.Runtime.InteropServices", "Marshal");
727 mono_defaults.typed_reference_class = mono_class_load_from_name (
728 mono_defaults.corlib, "System", "TypedReference");
730 mono_defaults.argumenthandle_class = mono_class_load_from_name (
731 mono_defaults.corlib, "System", "RuntimeArgumentHandle");
733 mono_defaults.monitor_class = mono_class_load_from_name (
734 mono_defaults.corlib, "System.Threading", "Monitor");
736 Not using GENERATE_TRY_GET_CLASS_WITH_CACHE_DECL as this type is heavily checked by sgen when computing finalization.
738 mono_defaults.critical_finalizer_object = mono_class_try_load_from_name (mono_defaults.corlib,
739 "System.Runtime.ConstrainedExecution", "CriticalFinalizerObject");
741 mono_assembly_load_friends (ass);
743 mono_defaults.handleref_class = mono_class_try_load_from_name (
744 mono_defaults.corlib, "System.Runtime.InteropServices", "HandleRef");
746 mono_defaults.attribute_class = mono_class_load_from_name (
747 mono_defaults.corlib, "System", "Attribute");
749 mono_defaults.customattribute_data_class = mono_class_load_from_name (
750 mono_defaults.corlib, "System.Reflection", "CustomAttributeData");
752 mono_class_init (mono_defaults.array_class);
753 mono_defaults.generic_nullable_class = mono_class_load_from_name (
754 mono_defaults.corlib, "System", "Nullable`1");
755 mono_defaults.generic_ilist_class = mono_class_load_from_name (
756 mono_defaults.corlib, "System.Collections.Generic", "IList`1");
757 mono_defaults.generic_ireadonlylist_class = mono_class_load_from_name (
758 mono_defaults.corlib, "System.Collections.Generic", "IReadOnlyList`1");
760 mono_defaults.threadpool_wait_callback_class = mono_class_load_from_name (
761 mono_defaults.corlib, "System.Threading", "_ThreadPoolWaitCallback");
763 mono_defaults.threadpool_perform_wait_callback_method = mono_class_get_method_from_name (
764 mono_defaults.threadpool_wait_callback_class, "PerformWaitCallback", 0);
766 domain->friendly_name = g_path_get_basename (filename);
768 mono_profiler_appdomain_name (domain, domain->friendly_name);
776 * Creates the initial application domain and initializes the mono_defaults
779 * This function is guaranteed to not run any IL code.
780 * The runtime is initialized using the default runtime version.
782 * Returns: the initial domain.
785 mono_init (const char *domain_name)
787 return mono_init_internal (domain_name, NULL, DEFAULT_RUNTIME_VERSION);
791 * mono_init_from_assembly:
792 * @domain_name: name to give to the initial domain
793 * @filename: filename to load on startup
795 * Used by the runtime, users should use mono_jit_init instead.
797 * Creates the initial application domain and initializes the mono_defaults
799 * This function is guaranteed to not run any IL code.
800 * The runtime is initialized using the runtime version required by the
801 * provided executable. The version is determined by looking at the exe
802 * configuration file and the version PE field)
804 * Returns: the initial domain.
807 mono_init_from_assembly (const char *domain_name, const char *filename)
809 return mono_init_internal (domain_name, filename, NULL);
815 * Used by the runtime, users should use mono_jit_init instead.
817 * Creates the initial application domain and initializes the mono_defaults
820 * This function is guaranteed to not run any IL code.
821 * The runtime is initialized using the provided rutime version.
823 * Returns: the initial domain.
826 mono_init_version (const char *domain_name, const char *version)
828 return mono_init_internal (domain_name, NULL, version);
834 * Cleans up all metadata modules.
839 mono_close_exe_image ();
841 mono_defaults.corlib = NULL;
843 mono_config_cleanup ();
844 mono_loader_cleanup ();
845 mono_classes_cleanup ();
846 mono_assemblies_cleanup ();
847 mono_debug_cleanup ();
848 mono_images_cleanup ();
849 mono_metadata_cleanup ();
851 mono_coop_mutex_destroy (&appdomains_mutex);
853 mono_w32process_cleanup ();
854 mono_w32file_cleanup ();
858 mono_close_exe_image (void)
861 mono_image_close (exe_image);
865 * mono_get_root_domain:
867 * The root AppDomain is the initial domain created by the runtime when it is
868 * initialized. Programs execute on this AppDomain, but can create new ones
869 * later. Currently there is no unmanaged API to create new AppDomains, this
870 * must be done from managed code.
872 * Returns: the root appdomain, to obtain the current domain, use mono_domain_get ()
875 mono_get_root_domain (void)
877 return mono_root_domain;
883 * This method returns the value of the current MonoDomain that this thread
884 * and code are running under. To obtain the root domain use
885 * mono_get_root_domain() API.
887 * Returns: the current domain
892 return GET_APPDOMAIN ();
896 mono_domain_unset (void)
898 SET_APPDOMAIN (NULL);
902 mono_domain_set_internal_with_options (MonoDomain *domain, gboolean migrate_exception)
904 MonoInternalThread *thread;
906 if (mono_domain_get () == domain)
909 SET_APPDOMAIN (domain);
910 SET_APPCONTEXT (domain->default_context);
912 if (migrate_exception) {
913 thread = mono_thread_internal_current ();
914 if (!thread->abort_exc)
917 g_assert (thread->abort_exc->object.vtable->domain != domain);
918 MONO_OBJECT_SETREF (thread, abort_exc, mono_get_exception_thread_abort ());
919 g_assert (thread->abort_exc->object.vtable->domain == domain);
924 * mono_domain_set_internal:
925 * @domain: the new domain
927 * Sets the current domain to @domain.
930 mono_domain_set_internal (MonoDomain *domain)
932 mono_domain_set_internal_with_options (domain, TRUE);
936 * mono_domain_foreach:
937 * @func: function to invoke with the domain data
938 * @user_data: user-defined pointer that is passed to the supplied @func fo reach domain
940 * Use this method to safely iterate over all the loaded application
941 * domains in the current runtime. The provided @func is invoked with a
942 * pointer to the MonoDomain and is given the value of the @user_data
943 * parameter which can be used to pass state to your called routine.
946 mono_domain_foreach (MonoDomainFunc func, gpointer user_data)
952 * Create a copy of the data to avoid calling the user callback
953 * inside the lock because that could lead to deadlocks.
954 * We can do this because this function is not perf. critical.
956 mono_appdomains_lock ();
957 size = appdomain_list_size;
958 copy = (MonoDomain **)mono_gc_alloc_fixed (appdomain_list_size * sizeof (void*), MONO_GC_DESCRIPTOR_NULL, MONO_ROOT_SOURCE_DOMAIN, "temporary domains list");
959 memcpy (copy, appdomains_list, appdomain_list_size * sizeof (void*));
960 mono_appdomains_unlock ();
962 for (i = 0; i < size; ++i) {
964 func (copy [i], user_data);
967 mono_gc_free_fixed (copy);
971 * mono_domain_assembly_open:
972 * @domain: the application domain
973 * @name: file name of the assembly
975 * fixme: maybe we should integrate this with mono_assembly_open ??
978 mono_domain_assembly_open (MonoDomain *domain, const char *name)
984 mono_domain_assemblies_lock (domain);
985 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
986 ass = (MonoAssembly *)tmp->data;
987 if (strcmp (name, ass->aname.name) == 0) {
988 mono_domain_assemblies_unlock (domain);
992 mono_domain_assemblies_unlock (domain);
994 if (domain != mono_domain_get ()) {
995 current = mono_domain_get ();
997 mono_domain_set (domain, FALSE);
998 ass = mono_assembly_open (name, NULL);
999 mono_domain_set (current, FALSE);
1001 ass = mono_assembly_open (name, NULL);
1008 unregister_vtable_reflection_type (MonoVTable *vtable)
1010 MonoObject *type = (MonoObject *)vtable->type;
1012 if (type->vtable->klass != mono_defaults.runtimetype_class)
1013 MONO_GC_UNREGISTER_ROOT_IF_MOVING (vtable->type);
1018 * @domain: the domain to release
1019 * @force: if true, it allows the root domain to be released (used at shutdown only).
1021 * This releases the resources associated with the specific domain.
1022 * This is a low-level function that is invoked by the AppDomain infrastructure
1026 mono_domain_free (MonoDomain *domain, gboolean force)
1028 int code_size, code_alloc;
1032 if ((domain == mono_root_domain) && !force) {
1033 g_warning ("cant unload root domain");
1037 if (mono_dont_free_domains)
1040 mono_profiler_appdomain_event (domain, MONO_PROFILE_START_UNLOAD);
1042 mono_debug_domain_unload (domain);
1044 mono_appdomains_lock ();
1045 appdomains_list [domain->domain_id] = NULL;
1046 mono_appdomains_unlock ();
1048 /* must do this early as it accesses fields and types */
1049 if (domain->special_static_fields) {
1050 mono_alloc_special_static_data_free (domain->special_static_fields);
1051 g_hash_table_destroy (domain->special_static_fields);
1052 domain->special_static_fields = NULL;
1056 * We must destroy all these hash tables here because they
1057 * contain references to managed objects belonging to the
1058 * domain. Once we let the GC clear the domain there must be
1059 * no more such references, or we'll crash if a collection
1062 mono_g_hash_table_destroy (domain->ldstr_table);
1063 domain->ldstr_table = NULL;
1065 mono_g_hash_table_destroy (domain->env);
1068 mono_reflection_cleanup_domain (domain);
1070 /* This must be done before type_hash is freed */
1071 if (domain->class_vtable_array) {
1073 for (i = 0; i < domain->class_vtable_array->len; ++i)
1074 unregister_vtable_reflection_type ((MonoVTable *)g_ptr_array_index (domain->class_vtable_array, i));
1077 if (domain->type_hash) {
1078 mono_g_hash_table_destroy (domain->type_hash);
1079 domain->type_hash = NULL;
1081 if (domain->type_init_exception_hash) {
1082 mono_g_hash_table_destroy (domain->type_init_exception_hash);
1083 domain->type_init_exception_hash = NULL;
1086 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1087 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1088 mono_assembly_release_gc_roots (ass);
1091 /* Have to zero out reference fields since they will be invalidated by the clear_domain () call below */
1092 for (p = (gpointer*)&domain->MONO_DOMAIN_FIRST_OBJECT; p < (gpointer*)&domain->MONO_DOMAIN_FIRST_GC_TRACKED; ++p)
1095 /* This needs to be done before closing assemblies */
1096 mono_gc_clear_domain (domain);
1098 /* Close dynamic assemblies first, since they have no ref count */
1099 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1100 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1101 if (!ass->image || !image_is_dynamic (ass->image))
1103 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);
1104 if (!mono_assembly_close_except_image_pools (ass))
1108 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1109 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1112 if (!ass->image || image_is_dynamic (ass->image))
1114 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);
1115 if (!mono_assembly_close_except_image_pools (ass))
1119 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
1120 MonoAssembly *ass = (MonoAssembly *)tmp->data;
1122 mono_assembly_close_finish (ass);
1124 g_slist_free (domain->domain_assemblies);
1125 domain->domain_assemblies = NULL;
1128 * Send this after the assemblies have been unloaded and the domain is still in a
1131 mono_profiler_appdomain_event (domain, MONO_PROFILE_END_UNLOAD);
1133 if (free_domain_hook)
1134 free_domain_hook (domain);
1136 /* FIXME: free delegate_hash_table when it's used */
1137 if (domain->search_path) {
1138 g_strfreev (domain->search_path);
1139 domain->search_path = NULL;
1141 domain->create_proxy_for_type_method = NULL;
1142 domain->private_invoke_method = NULL;
1143 domain->default_context = NULL;
1144 domain->out_of_memory_ex = NULL;
1145 domain->null_reference_ex = NULL;
1146 domain->stack_overflow_ex = NULL;
1147 domain->ephemeron_tombstone = NULL;
1148 domain->entry_assembly = NULL;
1150 g_free (domain->friendly_name);
1151 domain->friendly_name = NULL;
1152 g_ptr_array_free (domain->class_vtable_array, TRUE);
1153 domain->class_vtable_array = NULL;
1154 g_hash_table_destroy (domain->proxy_vtable_hash);
1155 domain->proxy_vtable_hash = NULL;
1156 if (domain->static_data_array) {
1157 mono_gc_free_fixed (domain->static_data_array);
1158 domain->static_data_array = NULL;
1160 mono_internal_hash_table_destroy (&domain->jit_code_hash);
1163 * There might still be jit info tables of this domain which
1164 * are not freed. Since the domain cannot be in use anymore,
1165 * this will free them.
1167 mono_thread_hazardous_try_free_all ();
1168 if (domain->aot_modules)
1169 mono_jit_info_table_free (domain->aot_modules);
1170 g_assert (domain->num_jit_info_tables == 1);
1171 mono_jit_info_table_free (domain->jit_info_table);
1172 domain->jit_info_table = NULL;
1173 g_assert (!domain->jit_info_free_queue);
1175 /* collect statistics */
1176 code_alloc = mono_code_manager_size (domain->code_mp, &code_size);
1177 total_domain_code_alloc += code_alloc;
1178 max_domain_code_alloc = MAX (max_domain_code_alloc, code_alloc);
1179 max_domain_code_size = MAX (max_domain_code_size, code_size);
1181 if (debug_domain_unload) {
1182 mono_mempool_invalidate (domain->mp);
1183 mono_code_manager_invalidate (domain->code_mp);
1185 #ifndef DISABLE_PERFCOUNTERS
1186 mono_perfcounters->loader_bytes -= mono_mempool_get_allocated (domain->mp);
1188 mono_mempool_destroy (domain->mp);
1190 mono_code_manager_destroy (domain->code_mp);
1191 domain->code_mp = NULL;
1193 lock_free_mempool_free (domain->lock_free_mp);
1194 domain->lock_free_mp = NULL;
1196 g_hash_table_destroy (domain->finalizable_objects_hash);
1197 domain->finalizable_objects_hash = NULL;
1198 if (domain->method_rgctx_hash) {
1199 g_hash_table_destroy (domain->method_rgctx_hash);
1200 domain->method_rgctx_hash = NULL;
1202 if (domain->generic_virtual_cases) {
1203 g_hash_table_destroy (domain->generic_virtual_cases);
1204 domain->generic_virtual_cases = NULL;
1206 if (domain->ftnptrs_hash) {
1207 g_hash_table_destroy (domain->ftnptrs_hash);
1208 domain->ftnptrs_hash = NULL;
1210 if (domain->method_to_dyn_method) {
1211 g_hash_table_destroy (domain->method_to_dyn_method);
1212 domain->method_to_dyn_method = NULL;
1215 mono_os_mutex_destroy (&domain->finalizable_objects_hash_lock);
1216 mono_os_mutex_destroy (&domain->assemblies_lock);
1217 mono_os_mutex_destroy (&domain->jit_code_hash_lock);
1219 mono_coop_mutex_destroy (&domain->lock);
1221 domain->setup = NULL;
1223 mono_gc_deregister_root ((char*)&(domain->MONO_DOMAIN_FIRST_GC_TRACKED));
1225 /* FIXME: anything else required ? */
1227 mono_gc_free_fixed (domain);
1229 #ifndef DISABLE_PERFCOUNTERS
1230 mono_perfcounters->loader_appdomains--;
1233 if (domain == mono_root_domain)
1234 mono_root_domain = NULL;
1238 * mono_domain_get_by_id:
1241 * Returns: the domain for a specific domain id.
1244 mono_domain_get_by_id (gint32 domainid)
1246 MonoDomain * domain;
1248 mono_appdomains_lock ();
1249 if (domainid < appdomain_list_size)
1250 domain = appdomains_list [domainid];
1253 mono_appdomains_unlock ();
1259 * mono_domain_get_id:
1261 * A domain ID is guaranteed to be unique for as long as the domain
1262 * using it is alive. It may be reused later once the domain has been
1265 * Returns: The unique ID for @domain.
1268 mono_domain_get_id (MonoDomain *domain)
1270 return domain->domain_id;
1274 * mono_domain_get_friendly_name:
1276 * The returned string's lifetime is the same as @domain's. Consider
1277 * copying it if you need to store it somewhere.
1279 * Returns: The friendly name of @domain. Can be NULL if not yet set.
1282 mono_domain_get_friendly_name (MonoDomain *domain)
1284 return domain->friendly_name;
1288 * mono_domain_alloc:
1290 * LOCKING: Acquires the domain lock.
1293 mono_domain_alloc (MonoDomain *domain, guint size)
1297 mono_domain_lock (domain);
1298 #ifndef DISABLE_PERFCOUNTERS
1299 mono_perfcounters->loader_bytes += size;
1301 res = mono_mempool_alloc (domain->mp, size);
1302 mono_domain_unlock (domain);
1308 * mono_domain_alloc0:
1310 * LOCKING: Acquires the domain lock.
1313 mono_domain_alloc0 (MonoDomain *domain, guint size)
1317 mono_domain_lock (domain);
1318 #ifndef DISABLE_PERFCOUNTERS
1319 mono_perfcounters->loader_bytes += size;
1321 res = mono_mempool_alloc0 (domain->mp, size);
1322 mono_domain_unlock (domain);
1328 mono_domain_alloc0_lock_free (MonoDomain *domain, guint size)
1330 return lock_free_mempool_alloc0 (domain->lock_free_mp, size);
1334 * mono_domain_code_reserve:
1336 * LOCKING: Acquires the domain lock.
1339 mono_domain_code_reserve (MonoDomain *domain, int size)
1343 mono_domain_lock (domain);
1344 res = mono_code_manager_reserve (domain->code_mp, size);
1345 mono_domain_unlock (domain);
1351 * mono_domain_code_reserve_align:
1353 * LOCKING: Acquires the domain lock.
1356 mono_domain_code_reserve_align (MonoDomain *domain, int size, int alignment)
1360 mono_domain_lock (domain);
1361 res = mono_code_manager_reserve_align (domain->code_mp, size, alignment);
1362 mono_domain_unlock (domain);
1368 * mono_domain_code_commit:
1370 * LOCKING: Acquires the domain lock.
1373 mono_domain_code_commit (MonoDomain *domain, void *data, int size, int newsize)
1375 mono_domain_lock (domain);
1376 mono_code_manager_commit (domain->code_mp, data, size, newsize);
1377 mono_domain_unlock (domain);
1381 * mono_domain_code_foreach:
1382 * Iterate over the code thunks of the code manager of @domain.
1384 * The @func callback MUST not take any locks. If it really needs to, it must respect
1385 * the locking rules of the runtime: http://www.mono-project.com/Mono:Runtime:Documentation:ThreadSafety
1386 * LOCKING: Acquires the domain lock.
1390 mono_domain_code_foreach (MonoDomain *domain, MonoCodeManagerFunc func, void *user_data)
1392 mono_domain_lock (domain);
1393 mono_code_manager_foreach (domain->code_mp, func, user_data);
1394 mono_domain_unlock (domain);
1399 mono_context_set (MonoAppContext * new_context)
1401 SET_APPCONTEXT (new_context);
1407 * Returns: the current Mono Application Context.
1410 mono_context_get (void)
1412 return GET_APPCONTEXT ();
1416 * mono_context_get_id:
1417 * @context: the context to operate on.
1419 * Context IDs are guaranteed to be unique for the duration of a Mono
1420 * process; they are never reused.
1422 * Returns: The unique ID for @context.
1425 mono_context_get_id (MonoAppContext *context)
1427 return context->context_id;
1431 * mono_context_get_domain_id:
1432 * @context: the context to operate on.
1434 * Returns: The ID of the domain that @context was created in.
1437 mono_context_get_domain_id (MonoAppContext *context)
1439 return context->domain_id;
1442 /* LOCKING: the caller holds the lock for this domain */
1444 mono_domain_add_class_static_data (MonoDomain *domain, MonoClass *klass, gpointer data, guint32 *bitmap)
1446 /* Note [Domain Static Data Array]:
1448 * Entry 0 in the array is the index of the next free slot.
1449 * Entry 1 is the total size of the array.
1452 if (domain->static_data_array) {
1453 int size = GPOINTER_TO_INT (domain->static_data_array [1]);
1454 next = GPOINTER_TO_INT (domain->static_data_array [0]);
1456 /* 'data' is allocated by alloc_fixed */
1457 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");
1458 mono_gc_memmove_aligned (new_array, domain->static_data_array, sizeof (gpointer) * size);
1460 new_array [1] = GINT_TO_POINTER (size);
1461 mono_gc_free_fixed (domain->static_data_array);
1462 domain->static_data_array = new_array;
1466 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");
1468 new_array [0] = GINT_TO_POINTER (next);
1469 new_array [1] = GINT_TO_POINTER (size);
1470 domain->static_data_array = new_array;
1472 domain->static_data_array [next++] = data;
1473 domain->static_data_array [0] = GINT_TO_POINTER (next);
1479 * Use this function to get the `MonoImage*` for the mscorlib.dll assembly
1481 * Returns: The MonoImage for mscorlib.dll
1484 mono_get_corlib (void)
1486 return mono_defaults.corlib;
1490 * mono_get_object_class:
1492 * Use this function to get the `MonoClass*` that the runtime is using for `System.Object`.
1494 * Returns: The `MonoClass*` for the `System.Object` type.
1497 mono_get_object_class (void)
1499 return mono_defaults.object_class;
1503 * mono_get_byte_class:
1505 * Use this function to get the `MonoClass*` that the runtime is using for `System.Byte`.
1507 * Returns: The `MonoClass*` for the `System.Byte` type.
1510 mono_get_byte_class (void)
1512 return mono_defaults.byte_class;
1516 * mono_get_void_class:
1518 * Use this function to get the `MonoClass*` that the runtime is using for `System.Void`.
1520 * Returns: The `MonoClass*` for the `System.Void` type.
1523 mono_get_void_class (void)
1525 return mono_defaults.void_class;
1529 * mono_get_boolean_class:
1531 * Use this function to get the `MonoClass*` that the runtime is using for `System.Boolean`.
1533 * Returns: The `MonoClass*` for the `System.Boolean` type.
1536 mono_get_boolean_class (void)
1538 return mono_defaults.boolean_class;
1542 * mono_get_sbyte_class:
1544 * Use this function to get the `MonoClass*` that the runtime is using for `System.SByte`.
1546 * Returns: The `MonoClass*` for the `System.SByte` type.
1549 mono_get_sbyte_class (void)
1551 return mono_defaults.sbyte_class;
1555 * mono_get_int16_class:
1557 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int16`.
1559 * Returns: The `MonoClass*` for the `System.Int16` type.
1562 mono_get_int16_class (void)
1564 return mono_defaults.int16_class;
1568 * mono_get_uint16_class:
1570 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt16`.
1572 * Returns: The `MonoClass*` for the `System.UInt16` type.
1575 mono_get_uint16_class (void)
1577 return mono_defaults.uint16_class;
1581 * mono_get_int32_class:
1583 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int32`.
1585 * Returns: The `MonoClass*` for the `System.Int32` type.
1588 mono_get_int32_class (void)
1590 return mono_defaults.int32_class;
1594 * mono_get_uint32_class:
1596 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt32`.
1598 * Returns: The `MonoClass*` for the `System.UInt32` type.
1601 mono_get_uint32_class (void)
1603 return mono_defaults.uint32_class;
1607 * mono_get_intptr_class:
1609 * Use this function to get the `MonoClass*` that the runtime is using for `System.IntPtr`.
1611 * Returns: The `MonoClass*` for the `System.IntPtr` type.
1614 mono_get_intptr_class (void)
1616 return mono_defaults.int_class;
1620 * mono_get_uintptr_class:
1622 * Use this function to get the `MonoClass*` that the runtime is using for `System.UIntPtr`.
1624 * Returns: The `MonoClass*` for the `System.UIntPtr` type.
1627 mono_get_uintptr_class (void)
1629 return mono_defaults.uint_class;
1633 * mono_get_int64_class:
1635 * Use this function to get the `MonoClass*` that the runtime is using for `System.Int64`.
1637 * Returns: The `MonoClass*` for the `System.Int64` type.
1640 mono_get_int64_class (void)
1642 return mono_defaults.int64_class;
1646 * mono_get_uint64_class:
1648 * Use this function to get the `MonoClass*` that the runtime is using for `System.UInt64`.
1650 * Returns: The `MonoClass*` for the `System.UInt64` type.
1653 mono_get_uint64_class (void)
1655 return mono_defaults.uint64_class;
1659 * mono_get_single_class:
1661 * Use this function to get the `MonoClass*` that the runtime is using for `System.Single` (32-bit floating points).
1663 * Returns: The `MonoClass*` for the `System.Single` type.
1666 mono_get_single_class (void)
1668 return mono_defaults.single_class;
1672 * mono_get_double_class:
1674 * Use this function to get the `MonoClass*` that the runtime is using for `System.Double` (64-bit floating points).
1676 * Returns: The `MonoClass*` for the `System.Double` type.
1679 mono_get_double_class (void)
1681 return mono_defaults.double_class;
1685 * mono_get_char_class:
1687 * Use this function to get the `MonoClass*` that the runtime is using for `System.Char`.
1689 * Returns: The `MonoClass*` for the `System.Char` type.
1692 mono_get_char_class (void)
1694 return mono_defaults.char_class;
1698 * mono_get_string_class:
1700 * Use this function to get the `MonoClass*` that the runtime is using for `System.String`.
1702 * Returns: The `MonoClass*` for the `System.String` type.
1705 mono_get_string_class (void)
1707 return mono_defaults.string_class;
1711 * mono_get_enum_class:
1713 * Use this function to get the `MonoClass*` that the runtime is using for `System.Enum`.
1715 * Returns: The `MonoClass*` for the `System.Enum` type.
1718 mono_get_enum_class (void)
1720 return mono_defaults.enum_class;
1724 * mono_get_array_class:
1726 * Use this function to get the `MonoClass*` that the runtime is using for `System.Array`.
1728 * Returns: The `MonoClass*` for the `System.Array` type.
1731 mono_get_array_class (void)
1733 return mono_defaults.array_class;
1737 * mono_get_thread_class:
1739 * Use this function to get the `MonoClass*` that the runtime is using for `System.Threading.Thread`.
1741 * Returns: The `MonoClass*` for the `System.Threading.Thread` type.
1744 mono_get_thread_class (void)
1746 return mono_defaults.thread_class;
1750 * mono_get_exception_class:
1752 * Use this function to get the `MonoClass*` that the runtime is using for `System.Exception`.
1754 * Returns: The `MonoClass*` for the `` type.
1757 mono_get_exception_class (void)
1759 return mono_defaults.exception_class;
1763 static char* get_attribute_value (const gchar **attribute_names,
1764 const gchar **attribute_values,
1765 const char *att_name)
1768 for (n=0; attribute_names[n] != NULL; n++) {
1769 if (strcmp (attribute_names[n], att_name) == 0)
1770 return g_strdup (attribute_values[n]);
1775 static void start_element (GMarkupParseContext *context,
1776 const gchar *element_name,
1777 const gchar **attribute_names,
1778 const gchar **attribute_values,
1782 AppConfigInfo* app_config = (AppConfigInfo*) user_data;
1784 if (strcmp (element_name, "configuration") == 0) {
1785 app_config->configuration_count++;
1788 if (strcmp (element_name, "startup") == 0) {
1789 app_config->startup_count++;
1793 if (app_config->configuration_count != 1 || app_config->startup_count != 1)
1796 if (strcmp (element_name, "requiredRuntime") == 0) {
1797 app_config->required_runtime = get_attribute_value (attribute_names, attribute_values, "version");
1798 } else if (strcmp (element_name, "supportedRuntime") == 0) {
1799 char *version = get_attribute_value (attribute_names, attribute_values, "version");
1800 app_config->supported_runtimes = g_slist_append (app_config->supported_runtimes, version);
1804 static void end_element (GMarkupParseContext *context,
1805 const gchar *element_name,
1809 AppConfigInfo* app_config = (AppConfigInfo*) user_data;
1811 if (strcmp (element_name, "configuration") == 0) {
1812 app_config->configuration_count--;
1813 } else if (strcmp (element_name, "startup") == 0) {
1814 app_config->startup_count--;
1818 static const GMarkupParser
1827 static AppConfigInfo *
1828 app_config_parse (const char *exe_filename)
1830 AppConfigInfo *app_config;
1831 GMarkupParseContext *context;
1834 const char *bundled_config;
1835 char *config_filename;
1837 bundled_config = mono_config_string_for_assembly_file (exe_filename);
1839 if (bundled_config) {
1840 text = g_strdup (bundled_config);
1841 len = strlen (text);
1843 config_filename = g_strconcat (exe_filename, ".config", NULL);
1845 if (!g_file_get_contents (config_filename, &text, &len, NULL)) {
1846 g_free (config_filename);
1849 g_free (config_filename);
1852 app_config = g_new0 (AppConfigInfo, 1);
1854 context = g_markup_parse_context_new (&mono_parser, (GMarkupParseFlags)0, app_config, NULL);
1855 if (g_markup_parse_context_parse (context, text, len, NULL)) {
1856 g_markup_parse_context_end_parse (context, NULL);
1858 g_markup_parse_context_free (context);
1864 app_config_free (AppConfigInfo* app_config)
1867 GSList *list = app_config->supported_runtimes;
1868 while (list != NULL) {
1869 rt = (char*)list->data;
1871 list = g_slist_next (list);
1873 g_slist_free (app_config->supported_runtimes);
1874 g_free (app_config->required_runtime);
1875 g_free (app_config);
1879 static const MonoRuntimeInfo*
1880 get_runtime_by_version (const char *version)
1883 int max = G_N_ELEMENTS (supported_runtimes);
1889 for (n=0; n<max; n++) {
1890 if (strcmp (version, supported_runtimes[n].runtime_version) == 0)
1891 return &supported_runtimes[n];
1894 vlen = strlen (version);
1895 if (vlen >= 4 && version [1] - '0' >= 4) {
1896 for (n=0; n<max; n++) {
1897 if (strncmp (version, supported_runtimes[n].runtime_version, 4) == 0)
1898 return &supported_runtimes[n];
1906 get_runtimes_from_exe (const char *exe_file, MonoImage **exe_image, const MonoRuntimeInfo** runtimes)
1908 AppConfigInfo* app_config;
1910 const MonoRuntimeInfo* runtime = NULL;
1911 MonoImage *image = NULL;
1913 app_config = app_config_parse (exe_file);
1915 if (app_config != NULL) {
1916 /* Check supportedRuntime elements, if none is supported, fail.
1917 * If there are no such elements, look for a requiredRuntime element.
1919 if (app_config->supported_runtimes != NULL) {
1921 GSList *list = app_config->supported_runtimes;
1922 while (list != NULL) {
1923 version = (char*) list->data;
1924 runtime = get_runtime_by_version (version);
1925 if (runtime != NULL)
1926 runtimes [n++] = runtime;
1927 list = g_slist_next (list);
1929 runtimes [n] = NULL;
1930 app_config_free (app_config);
1934 /* Check the requiredRuntime element. This is for 1.0 apps only. */
1935 if (app_config->required_runtime != NULL) {
1936 runtimes [0] = get_runtime_by_version (app_config->required_runtime);
1937 runtimes [1] = NULL;
1938 app_config_free (app_config);
1941 app_config_free (app_config);
1944 /* Look for a runtime with the exact version */
1945 image = mono_assembly_open_from_bundle (exe_file, NULL, FALSE);
1948 image = mono_image_open (exe_file, NULL);
1950 if (image == NULL) {
1951 /* The image is wrong or the file was not found. In this case return
1952 * a default runtime and leave to the initialization method the work of
1953 * reporting the error.
1955 runtimes [0] = get_runtime_by_version (DEFAULT_RUNTIME_VERSION);
1956 runtimes [1] = NULL;
1962 runtimes [0] = get_runtime_by_version (image->version);
1963 runtimes [1] = NULL;
1968 * mono_get_runtime_info:
1970 * Returns: the version of the current runtime instance.
1972 const MonoRuntimeInfo*
1973 mono_get_runtime_info (void)
1975 return current_runtime;
1979 * mono_framework_version:
1981 * Return the major version of the framework curently executing.
1984 mono_framework_version (void)
1986 return current_runtime->framework_version [0] - '0';
1990 mono_enable_debug_domain_unload (gboolean enable)
1992 debug_domain_unload = enable;
1995 MonoAotCacheConfig *
1996 mono_get_aot_cache_config (void)
1998 return &aot_cache_config;
2002 mono_domain_lock (MonoDomain *domain)
2004 mono_locks_coop_acquire (&domain->lock, DomainLock);
2008 mono_domain_unlock (MonoDomain *domain)
2010 mono_locks_coop_release (&domain->lock, DomainLock);
2014 mono_domain_get_assemblies (MonoDomain *domain, gboolean refonly)
2017 GPtrArray *assemblies;
2020 assemblies = g_ptr_array_new ();
2021 mono_domain_assemblies_lock (domain);
2022 for (tmp = domain->domain_assemblies; tmp; tmp = tmp->next) {
2023 ass = (MonoAssembly *)tmp->data;
2024 if (refonly != ass->ref_only)
2026 if (ass->corlib_internal)
2028 g_ptr_array_add (assemblies, ass);
2030 mono_domain_assemblies_unlock (domain);