3 * Copyright 2012 Xamarin Inc
4 * Licensed under the MIT license. See LICENSE file in the project root for full license information.
6 #ifndef __MONO_METADATA_CLASS_INTERNALS_H__
7 #define __MONO_METADATA_CLASS_INTERNALS_H__
9 #include <mono/metadata/class.h>
10 #include <mono/metadata/object.h>
11 #include <mono/metadata/mempool.h>
12 #include <mono/metadata/metadata-internals.h>
13 #include <mono/metadata/property-bag.h>
14 #include "mono/utils/mono-compiler.h"
15 #include "mono/utils/mono-error.h"
16 #include "mono/sgen/gc-internal-agnostic.h"
18 #define MONO_CLASS_IS_ARRAY(c) ((c)->rank)
20 #define MONO_CLASS_HAS_STATIC_METADATA(klass) ((klass)->type_token && !(klass)->image->dynamic && !mono_class_is_ginst (klass))
22 #define MONO_DEFAULT_SUPERTABLE_SIZE 6
24 extern gboolean mono_print_vtable;
25 extern gboolean mono_align_small_structs;
27 typedef struct _MonoMethodWrapper MonoMethodWrapper;
28 typedef struct _MonoMethodInflated MonoMethodInflated;
29 typedef struct _MonoMethodPInvoke MonoMethodPInvoke;
31 /* Properties that applies to a group of structs should better use a higher number
32 * to avoid colision with type specific properties.
34 * This prop applies to class, method, property, event, assembly and image.
36 #define MONO_PROP_DYNAMIC_CATTR 0x1000
38 #ifdef ENABLE_ICALL_EXPORT
39 #pragma GCC diagnostic ignored "-Wmissing-prototypes"
40 #define ICALL_EXPORT MONO_API
42 #define ICALL_EXPORT static
46 #define WRAPPER(e,n) MONO_WRAPPER_ ## e,
47 #include "wrapper-types.h"
53 MONO_TYPE_NAME_FORMAT_IL,
54 MONO_TYPE_NAME_FORMAT_REFLECTION,
55 MONO_TYPE_NAME_FORMAT_FULL_NAME,
56 MONO_TYPE_NAME_FORMAT_ASSEMBLY_QUALIFIED
60 MONO_REMOTING_TARGET_UNKNOWN,
61 MONO_REMOTING_TARGET_APPDOMAIN,
62 MONO_REMOTING_TARGET_COMINTEROP
65 #define MONO_METHOD_PROP_GENERIC_CONTAINER 0
68 guint16 flags; /* method flags */
69 guint16 iflags; /* method implementation flags */
71 MonoClass *klass; /* To what class does this method belong */
72 MonoMethodSignature *signature;
73 /* name is useful mostly for debugging */
75 /* this is used by the inlining algorithm */
76 unsigned int inline_info:1;
77 unsigned int inline_failure:1;
78 unsigned int wrapper_type:5;
79 unsigned int string_ctor:1;
80 unsigned int save_lmf:1;
81 unsigned int dynamic:1; /* created & destroyed during runtime */
82 unsigned int sre_method:1; /* created at runtime using Reflection.Emit */
83 unsigned int is_generic:1; /* whenever this is a generic method definition */
84 unsigned int is_inflated:1; /* whether we're a MonoMethodInflated */
85 unsigned int skip_visibility:1; /* whenever to skip JIT visibility checks */
86 unsigned int verification_success:1; /* whether this method has been verified successfully.*/
90 * If is_generic is TRUE, the generic_container is stored in image->property_hash,
91 * using the key MONO_METHOD_PROP_GENERIC_CONTAINER.
95 struct _MonoMethodWrapper {
97 MonoMethodHeader *header;
101 struct _MonoMethodPInvoke {
104 /* add marshal info */
105 guint16 piflags; /* pinvoke flags */
106 guint16 implmap_idx; /* index into IMPLMAP */
110 * Stores the default value / RVA of fields.
111 * This information is rarely needed, so it is stored separately from
114 typedef struct MonoFieldDefaultValue {
116 * If the field is constant, pointer to the metadata constant
118 * If the field has an RVA flag, pointer to the data.
123 /* If the field is constant, the type of the constant. */
124 MonoTypeEnum def_type;
125 } MonoFieldDefaultValue;
128 * MonoClassField is just a runtime representation of the metadata for
129 * field, it doesn't contain the data directly. Static fields are
130 * stored in MonoVTable->data. Instance fields are allocated in the
131 * objects after the object header.
133 struct _MonoClassField {
134 /* Type of the field */
139 /* Type where the field was defined */
143 * Offset where this field is stored; if it is an instance
144 * field, it's the offset from the start of the object, if
145 * it's static, it's from the start of the memory chunk
146 * allocated for statics for the class.
147 * For special static fields, this is set to -1 during vtable construction.
152 /* a field is ignored if it's named "_Deleted" and it has the specialname and rtspecialname flags set */
153 #define mono_field_is_deleted(field) (((field)->type->attrs & (FIELD_ATTRIBUTE_SPECIAL_NAME | FIELD_ATTRIBUTE_RT_SPECIAL_NAME)) \
154 && (strcmp (mono_field_get_name (field), "_Deleted") == 0))
156 /* a field is ignored if it's named "_Deleted" and it has the specialname and rtspecialname flags set */
157 /* Try to avoid loading the field's type */
158 #define mono_field_is_deleted_with_flags(field, flags) (((flags) & (FIELD_ATTRIBUTE_SPECIAL_NAME | FIELD_ATTRIBUTE_RT_SPECIAL_NAME)) \
159 && (strcmp (mono_field_get_name (field), "_Deleted") == 0))
162 MonoClassField *field;
164 MonoMarshalSpec *mspec;
168 MonoPropertyBagItem head;
170 guint32 native_size, min_align;
172 MonoMethod *ptr_to_str;
173 MonoMethod *str_to_ptr;
174 MonoMarshalField fields [MONO_ZERO_LEN_ARRAY];
177 #define MONO_SIZEOF_MARSHAL_TYPE (offsetof (MonoMarshalType, fields))
179 struct _MonoProperty {
193 #ifndef MONO_SMALL_CONFIG
199 /* type of exception being "on hold" for later processing (see exception_type) */
201 MONO_EXCEPTION_NONE = 0,
202 MONO_EXCEPTION_INVALID_PROGRAM = 3,
203 MONO_EXCEPTION_UNVERIFIABLE_IL = 4,
204 MONO_EXCEPTION_MISSING_METHOD = 5,
205 MONO_EXCEPTION_MISSING_FIELD = 6,
206 MONO_EXCEPTION_TYPE_LOAD = 7,
207 MONO_EXCEPTION_FILE_NOT_FOUND = 8,
208 MONO_EXCEPTION_METHOD_ACCESS = 9,
209 MONO_EXCEPTION_FIELD_ACCESS = 10,
210 MONO_EXCEPTION_GENERIC_SHARING_FAILED = 11,
211 MONO_EXCEPTION_BAD_IMAGE = 12,
212 MONO_EXCEPTION_OBJECT_SUPPLIED = 13, /*The exception object is already created.*/
213 MONO_EXCEPTION_OUT_OF_MEMORY = 14,
214 MONO_EXCEPTION_INLINE_FAILED = 15,
215 MONO_EXCEPTION_MONO_ERROR = 16,
216 /* add other exception type */
219 /* This struct collects the info needed for the runtime use of a class,
220 * like the vtables for a domain, the GC descriptor, etc.
224 /* domain_vtables is indexed by the domain id and the size is max_domain + 1 */
225 MonoVTable *domain_vtables [MONO_ZERO_LEN_ARRAY];
226 } MonoClassRuntimeInfo;
228 #define MONO_SIZEOF_CLASS_RUNTIME_INFO (sizeof (MonoClassRuntimeInfo) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
231 MonoPropertyBagItem head;
233 MonoProperty *properties;
234 guint32 first, count;
235 MonoFieldDefaultValue *def_values;
236 } MonoClassPropertyInfo;
239 MonoPropertyBagItem head;
241 /* Initialized by a call to mono_class_setup_events () */
243 guint32 first, count;
244 } MonoClassEventInfo;
247 MONO_CLASS_DEF = 1, /* non-generic type */
248 MONO_CLASS_GTD, /* generic type definition */
249 MONO_CLASS_GINST, /* generic instantiation */
250 MONO_CLASS_GPARAM, /* generic parameter */
251 MONO_CLASS_ARRAY, /* vector or array, bounded or not */
252 MONO_CLASS_POINTER, /* pointer of function pointer*/
256 /* element class for arrays and enum basetype for enums */
257 MonoClass *element_class;
258 /* used for subtype checks */
259 MonoClass *cast_class;
261 /* for fast subtype checks */
262 MonoClass **supertypes;
265 /* array dimension */
268 int instance_size; /* object instance size */
272 /* A class contains static and non static data. Static data can be
273 * of the same type as the class itselfs, but it does not influence
274 * the instance size of the class. To avoid cyclic calls to
275 * mono_class_init (from mono_class_instance_size ()) we first
276 * initialise all non static fields. After that we set size_inited
277 * to 1, because we know the instance size now. After that we
278 * initialise all static fields.
281 /* ALL BITFIELDS SHOULD BE WRITTEN WHILE HOLDING THE LOADER LOCK */
282 guint size_inited : 1;
283 guint valuetype : 1; /* derives from System.ValueType */
284 guint enumtype : 1; /* derives from System.Enum */
285 guint blittable : 1; /* class is blittable */
286 guint unicode : 1; /* class uses unicode char when marshalled */
287 guint wastypebuilder : 1; /* class was created at runtime from a TypeBuilder */
288 guint is_array_special_interface : 1; /* gtd or ginst of once of the magic interfaces that arrays implement */
294 guint packing_size : 4;
295 guint ghcimpl : 1; /* class has its own GetHashCode impl */
296 guint has_finalize : 1; /* class has its own Finalize impl */
297 #ifndef DISABLE_REMOTING
298 guint marshalbyref : 1; /* class is a MarshalByRefObject */
299 guint contextbound : 1; /* class is a ContextBoundObject */
302 guint delegate : 1; /* class is a Delegate */
303 guint gc_descr_inited : 1; /* gc_descr is initialized */
304 guint has_cctor : 1; /* class has a cctor */
305 guint has_references : 1; /* it has GC-tracked references in the instance */
306 guint has_static_refs : 1; /* it has static fields that are GC-tracked */
307 guint no_special_static_fields : 1; /* has no thread/context static fields */
308 /* directly or indirectly derives from ComImport attributed class.
309 * this means we need to create a proxy for instances of this class
310 * for COM Interop. set this flag on loading so all we need is a quick check
311 * during object creation rather than having to traverse supertypes
313 guint is_com_object : 1;
314 guint nested_classes_inited : 1; /* Whenever nested_class is initialized */
317 guint class_kind : 3; /* One of the values from MonoTypeKind */
318 guint interfaces_inited : 1; /* interfaces is initialized */
319 guint simd_type : 1; /* class is a simd intrinsic type */
320 guint has_finalize_inited : 1; /* has_finalize is initialized */
321 guint fields_inited : 1; /* setup_fields () has finished */
322 guint has_failure : 1; /* See mono_class_get_exception_data () for a MonoErrorBoxed with the details */
325 MonoClass *nested_in;
329 const char *name_space;
332 int vtable_size; /* number of slots */
334 guint16 interface_count;
335 guint32 interface_id; /* unique inderface id (for interfaces) */
336 guint32 max_interface_id;
338 guint16 interface_offsets_count;
339 MonoClass **interfaces_packed;
340 guint16 *interface_offsets_packed;
341 /* enabled only with small config for now: we might want to do it unconditionally */
342 #ifdef MONO_SMALL_CONFIG
343 #define COMPRESSED_INTERFACE_BITMAP 1
345 guint8 *interface_bitmap;
347 MonoClass **interfaces;
350 int class_size; /* size of area for static fields */
351 int element_size; /* for array types */
352 int generic_param_token; /* for generic param types, both var and mvar */
356 * Field information: Type and location from object base
358 MonoClassField *fields;
360 MonoMethod **methods;
362 /* used as the type of the this argument and when passing the arg by value */
366 MonoGCDescriptor gc_descr;
368 MonoClassRuntimeInfo *runtime_info;
370 /* Generic vtable. Initialized by a call to mono_class_setup_vtable () */
373 /* Infrequently used items. See class-accessors.c: InfrequentDataKind for what goes into here. */
374 MonoPropertyBag infrequent_data;
381 * From the TypeDef table
383 guint32 first_method_idx;
384 guint32 first_field_idx;
385 guint32 method_count, field_count;
386 /* next element in the class_cache hash list (in MonoImage) */
387 MonoClass *next_class_cache;
392 MonoGenericContainer *generic_container;
393 /* The canonical GENERICINST where we instantiate a generic type definition with its own generic parameters.*/
394 /* Suppose we have class T`2<A,B> {...}. canonical_inst is the GTD T`2 applied to A and B. */
395 MonoType canonical_inst;
400 MonoGenericClass *generic_class;
401 } MonoClassGenericInst;
405 } MonoClassGenericParam;
409 guint32 method_count;
416 #ifdef COMPRESSED_INTERFACE_BITMAP
417 int mono_compress_bitmap (uint8_t *dest, const uint8_t *bitmap, int size);
418 int mono_class_interface_match (const uint8_t *bitmap, int id);
420 #define mono_class_interface_match(bmap,uiid) ((bmap) [(uiid) >> 3] & (1 << ((uiid)&7)))
423 #define MONO_CLASS_IMPLEMENTS_INTERFACE(k,uiid) (((uiid) <= (k)->max_interface_id) && mono_class_interface_match ((k)->interface_bitmap, (uiid)))
425 #define MONO_VTABLE_AVAILABLE_GC_BITS 4
427 #ifdef DISABLE_REMOTING
428 #define mono_class_is_marshalbyref(klass) (FALSE)
429 #define mono_class_is_contextbound(klass) (FALSE)
430 #define mono_vtable_is_remote(vtable) (FALSE)
431 #define mono_vtable_set_is_remote(vtable,enable) do {} while (0)
433 #define mono_class_is_marshalbyref(klass) ((klass)->marshalbyref)
434 #define mono_class_is_contextbound(klass) ((klass)->contextbound)
435 #define mono_vtable_is_remote(vtable) ((vtable)->remote)
436 #define mono_vtable_set_is_remote(vtable,enable) do { (vtable)->remote = enable ? 1 : 0; } while (0)
440 #define mono_class_is_com_object(klass) (FALSE)
442 #define mono_class_is_com_object(klass) ((klass)->is_com_object)
446 MONO_API int mono_class_interface_offset (MonoClass *klass, MonoClass *itf);
447 int mono_class_interface_offset_with_variance (MonoClass *klass, MonoClass *itf, gboolean *non_exact_match);
449 typedef gpointer MonoRuntimeGenericContext;
451 /* the interface_offsets array is stored in memory before this struct */
455 * According to comments in gc_gcj.h, this should be the second word in
458 MonoGCDescriptor gc_descr;
459 MonoDomain *domain; /* each object/vtable belongs to exactly one domain */
460 gpointer type; /* System.Type type for klass */
461 guint8 *interface_bitmap;
462 guint32 max_interface_id;
464 /* Keep this a guint8, the jit depends on it */
465 guint8 initialized; /* cctor has been run */
466 guint remote : 1; /* class is remotely activated */
467 guint init_failed : 1; /* cctor execution failed */
468 guint has_static_fields : 1; /* pointer to the data stored at the end of the vtable array */
469 guint gc_bits : MONO_VTABLE_AVAILABLE_GC_BITS; /* Those bits are reserved for the usaged of the GC */
471 guint32 imt_collisions_bitmap;
472 MonoRuntimeGenericContext *runtime_generic_context;
473 /* do not add any fields after vtable, the structure is dynamically extended */
474 /* vtable contains function pointers to methods or their trampolines, at the
475 end there may be a slot containing the pointer to the static fields */
476 gpointer vtable [MONO_ZERO_LEN_ARRAY];
479 #define MONO_SIZEOF_VTABLE (sizeof (MonoVTable) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
481 #define MONO_VTABLE_IMPLEMENTS_INTERFACE(vt,uiid) (((uiid) <= (vt)->max_interface_id) && mono_class_interface_match ((vt)->interface_bitmap, (uiid)))
484 * Generic instantiation data type encoding.
488 * A particular generic instantiation:
490 * All instantiations are cached and we don't distinguish between class and method
491 * instantiations here.
493 struct _MonoGenericInst {
494 #ifndef MONO_SMALL_CONFIG
495 guint id; /* unique ID for debugging */
497 guint type_argc : 22; /* number of type arguments */
498 guint is_open : 1; /* if this is an open type */
499 MonoType *type_argv [MONO_ZERO_LEN_ARRAY];
502 #define MONO_SIZEOF_GENERIC_INST (sizeof (MonoGenericInst) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
504 * The generic context: an instantiation of a set of class and method generic parameters.
506 * NOTE: Never allocate this directly on the heap. It have to be either allocated on the stack,
507 * or embedded within other objects. Don't store pointers to this, because it may be on the stack.
508 * If you really have to, ensure you store a pointer to the embedding object along with it.
510 struct _MonoGenericContext {
511 /* The instantiation corresponding to the class generic parameters */
512 MonoGenericInst *class_inst;
513 /* The instantiation corresponding to the method generic parameters */
514 MonoGenericInst *method_inst;
518 * Inflated generic method.
520 struct _MonoMethodInflated {
523 MonoMethodPInvoke pinvoke;
525 MonoMethod *declaring; /* the generic method definition. */
526 MonoGenericContext context; /* The current instantiation */
527 MonoImageSet *owner; /* The image set that the inflated method belongs to. */
531 * A particular instantiation of a generic type.
533 struct _MonoGenericClass {
534 MonoClass *container_class; /* the generic type definition */
535 MonoGenericContext context; /* a context that contains the type instantiation doesn't contain any method instantiation */ /* FIXME: Only the class_inst member of "context" is ever used, so this field could be replaced with just a monogenericinst */
536 guint is_dynamic : 1; /* Contains dynamic types */
537 guint is_tb_open : 1; /* This is the fully open instantiation for a type_builder. Quite ugly, but it's temporary.*/
538 guint need_sync : 1; /* Only if dynamic. Need to be synchronized with its container class after its finished. */
539 MonoClass *cached_class; /* if present, the MonoClass corresponding to the instantiation. */
542 * The image set which owns this generic class. Memory owned by the generic class
543 * including cached_class should be allocated from the mempool of the image set,
544 * so it is easy to free.
552 struct _MonoGenericParam {
554 * Type or method this parameter was defined in.
556 MonoGenericContainer *owner;
559 * If != NULL, this is a generated generic param used by the JIT to implement generic
562 MonoType *gshared_constraint;
565 /* Additional details about a MonoGenericParam */
566 /* Keep in sync with managed Mono.RuntimeStructs.GenericParamInfo */
568 MonoClass *pklass; /* The corresponding `MonoClass'. */
571 // See GenericParameterAttributes
576 // Constraints on type parameters
577 MonoClass** constraints; /* NULL means end of list */
578 } MonoGenericParamInfo;
581 MonoGenericParam param;
582 MonoGenericParamInfo info;
583 } MonoGenericParamFull;
586 * The generic container.
588 * Stores the type parameters of a generic type definition or a generic method definition.
590 struct _MonoGenericContainer {
591 MonoGenericContext context;
592 /* If we're a generic method definition in a generic type definition,
593 the generic container of the containing class. */
594 MonoGenericContainer *parent;
595 /* the generic type definition or the generic method definition corresponding to this container */
596 /* Union rules: If is_anonymous, image field is valid; else if is_method, method field is valid; else klass is valid. */
602 int type_argc : 29; // Per the ECMA spec, this value is capped at 16 bits
603 /* If true, we're a generic method, otherwise a generic type definition. */
604 /* Invariant: parent != NULL => is_method */
606 /* If true, this container has no associated class/method and only the image is known. This can happen:
607 1. For the special anonymous containers kept by MonoImage.
608 2. During container creation via the mono_metadata_load_generic_params path-- in this case the caller
609 sets the owner, so temporarily while load_generic_params is completing the container is anonymous.
610 3. When user code creates a generic parameter via SRE, but has not yet set an owner. */
611 int is_anonymous : 1;
612 /* If false, all params in this container are full-size. If true, all params are just param structs. */
613 /* This field is always == to the is_anonymous field, except in "temporary" cases (2) and (3) above. */
614 /* TODO: Merge GenericParam and GenericParamFull, remove this field. Benefit is marginal. */
615 int is_small_param : 1;
616 /* Our type parameters. */
617 MonoGenericParamFull *type_params;
620 static inline MonoGenericParam *
621 mono_generic_container_get_param (MonoGenericContainer *gc, int i)
623 return (MonoGenericParam *) &gc->type_params [i];
626 static inline MonoGenericParamInfo *
627 mono_generic_container_get_param_info (MonoGenericContainer *gc, int i)
629 return &gc->type_params [i].info;
632 static inline MonoGenericContainer *
633 mono_generic_param_owner (MonoGenericParam *p)
639 mono_generic_param_num (MonoGenericParam *p)
644 static inline gboolean
645 mono_generic_param_is_fullsize (MonoGenericParam *p)
647 return !mono_generic_param_owner (p)->is_small_param;
650 static inline MonoGenericParamInfo *
651 mono_generic_param_info (MonoGenericParam *p)
653 if (mono_generic_param_is_fullsize (p))
654 return &((MonoGenericParamFull *) p)->info;
658 static inline const char *
659 mono_generic_param_name (MonoGenericParam *p)
661 if (mono_generic_param_is_fullsize (p))
662 return ((MonoGenericParamFull *) p)->info.name;
666 static inline MonoGenericContainer *
667 mono_type_get_generic_param_owner (MonoType *t)
669 return mono_generic_param_owner (t->data.generic_param);
673 mono_type_get_generic_param_num (MonoType *t)
675 return mono_generic_param_num (t->data.generic_param);
679 * Class information which might be cached by the runtime in the AOT file for
680 * example. Caching this allows us to avoid computing a generic vtable
681 * (class->vtable) in most cases, saving time and avoiding creation of lots of
682 * MonoMethod structures.
684 typedef struct MonoCachedClassInfo {
686 guint has_finalize : 1;
689 guint has_nested_classes : 1;
691 guint has_references : 1;
692 guint has_static_refs : 1;
693 guint no_special_static_fields : 1;
694 guint is_generic_container : 1;
696 MonoImage *finalize_image;
697 guint32 finalize_token;
698 guint32 instance_size;
700 guint32 packing_size;
702 } MonoCachedClassInfo;
707 gconstpointer wrapper;
708 gconstpointer trampoline;
709 MonoMethodSignature *sig;
710 const char *c_symbol;
711 MonoMethod *wrapper_method;
716 mono_class_setup_supertypes (MonoClass *klass);
719 mono_class_setup_fields (MonoClass *klass);
722 * Only call this function if you can ensure both @klass and @parent
723 * have supertype information initialized.
724 * This can be accomplished by mono_class_setup_supertypes or mono_class_init.
725 * If unsure, use mono_class_has_parent.
727 static inline gboolean
728 mono_class_has_parent_fast (MonoClass *klass, MonoClass *parent)
730 return (klass->idepth >= parent->idepth) && (klass->supertypes [parent->idepth - 1] == parent);
733 static inline gboolean
734 mono_class_has_parent (MonoClass *klass, MonoClass *parent)
736 if (G_UNLIKELY (!klass->supertypes))
737 mono_class_setup_supertypes (klass);
739 if (G_UNLIKELY (!parent->supertypes))
740 mono_class_setup_supertypes (parent);
742 return mono_class_has_parent_fast (klass, parent);
746 MonoVTable *default_vtable;
747 MonoVTable *xdomain_vtable;
748 MonoClass *proxy_class;
749 char* proxy_class_name;
750 uint32_t interface_count;
751 MonoClass *interfaces [MONO_ZERO_LEN_ARRAY];
754 #define MONO_SIZEOF_REMOTE_CLASS (sizeof (MonoRemoteClass) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
757 guint64 new_object_count;
758 size_t initialized_class_count;
759 size_t generic_vtable_count;
760 size_t used_class_count;
762 size_t class_vtable_size;
763 size_t class_static_data_size;
764 size_t generic_instance_count;
765 size_t generic_class_count;
766 size_t inflated_method_count;
767 size_t inflated_method_count_2;
768 size_t inflated_type_count;
769 size_t generics_metadata_size;
770 size_t delegate_creations;
771 size_t imt_tables_size;
772 size_t imt_number_of_tables;
773 size_t imt_number_of_methods;
774 size_t imt_used_slots;
775 size_t imt_slots_with_collisions;
776 size_t imt_max_collisions_in_slot;
777 size_t imt_method_count_when_max_collisions;
778 size_t imt_trampolines_size;
779 size_t jit_info_table_insert_count;
780 size_t jit_info_table_remove_count;
781 size_t jit_info_table_lookup_count;
782 size_t generics_sharable_methods;
783 size_t generics_unsharable_methods;
784 size_t generics_shared_methods;
785 size_t gsharedvt_methods;
786 size_t minor_gc_count;
787 size_t major_gc_count;
788 size_t minor_gc_time_usecs;
789 size_t major_gc_time_usecs;
794 * new structure to hold performace counters values that are exported
796 * Note: never remove fields from this structure and only add them to the end.
797 * Size of fields and type should not be changed as well.
804 guint32 jit_failures;
805 /* Exceptions category */
806 guint32 exceptions_thrown;
807 guint32 exceptions_filters;
808 guint32 exceptions_finallys;
809 guint32 exceptions_depth;
810 guint32 aspnet_requests_queued;
811 guint32 aspnet_requests;
812 /* Memory category */
813 guint32 gc_collections0;
814 guint32 gc_collections1;
815 guint32 gc_collections2;
816 guint32 gc_promotions0;
817 guint32 gc_promotions1;
818 guint32 gc_promotion_finalizers;
823 guint32 gc_fin_survivors;
824 guint32 gc_num_handles;
825 guint32 gc_allocated;
828 guint32 gc_total_bytes;
829 guint32 gc_committed_bytes;
830 guint32 gc_reserved_bytes;
831 guint32 gc_num_pinned;
832 guint32 gc_sync_blocks;
833 /* Remoting category */
834 guint32 remoting_calls;
835 guint32 remoting_channels;
836 guint32 remoting_proxies;
837 guint32 remoting_classes;
838 guint32 remoting_objects;
839 guint32 remoting_contexts;
840 /* Loader category */
841 guint32 loader_classes;
842 guint32 loader_total_classes;
843 guint32 loader_appdomains;
844 guint32 loader_total_appdomains;
845 guint32 loader_assemblies;
846 guint32 loader_total_assemblies;
847 guint32 loader_failures;
848 guint32 loader_bytes;
849 guint32 loader_appdomains_uloaded;
850 /* Threads and Locks category */
851 guint32 thread_contentions;
852 guint32 thread_queue_len;
853 guint32 thread_queue_max;
854 guint32 thread_num_logical;
855 guint32 thread_num_physical;
856 guint32 thread_cur_recognized;
857 guint32 thread_num_recognized;
858 /* Interop category */
859 guint32 interop_num_ccw;
860 guint32 interop_num_stubs;
861 guint32 interop_num_marshals;
862 /* Security category */
863 guint32 security_num_checks;
864 guint32 security_num_link_checks;
865 guint32 security_time;
866 guint32 security_depth;
869 guint64 threadpool_workitems;
870 guint64 threadpool_ioworkitems;
871 guint threadpool_threads;
872 guint threadpool_iothreads;
875 extern MonoPerfCounters *mono_perfcounters;
877 MONO_API void mono_perfcounters_init (void);
880 * The definition of the first field in SafeHandle,
881 * Keep in sync with SafeHandle.cs, this is only used
882 * to access the `handle' parameter.
890 * Keep in sync with HandleRef.cs
897 extern MonoStats mono_stats;
899 typedef gboolean (*MonoGetCachedClassInfo) (MonoClass *klass, MonoCachedClassInfo *res);
901 typedef gboolean (*MonoGetClassFromName) (MonoImage *image, const char *name_space, const char *name, MonoClass **res);
903 static inline gboolean
904 method_is_dynamic (MonoMethod *method)
906 #ifdef DISABLE_REFLECTION_EMIT
909 return method->dynamic;
914 mono_classes_init (void);
917 mono_classes_cleanup (void);
920 mono_class_layout_fields (MonoClass *klass, int base_instance_size, int packing_size, gboolean sre);
923 mono_class_setup_interface_offsets (MonoClass *klass);
926 mono_class_setup_vtable_general (MonoClass *klass, MonoMethod **overrides, int onum, GList *in_setup);
929 mono_class_setup_vtable (MonoClass *klass);
932 mono_class_setup_methods (MonoClass *klass);
935 mono_class_setup_mono_type (MonoClass *klass);
938 mono_class_setup_parent (MonoClass *klass, MonoClass *parent);
941 mono_class_get_method_by_index (MonoClass *klass, int index);
944 mono_class_get_inflated_method (MonoClass *klass, MonoMethod *method);
947 mono_class_get_vtable_entry (MonoClass *klass, int offset);
950 mono_class_get_implemented_interfaces (MonoClass *klass, MonoError *error);
953 mono_class_get_vtable_size (MonoClass *klass);
956 mono_class_is_open_constructed_type (MonoType *t);
959 mono_class_get_overrides_full (MonoImage *image, guint32 type_token, MonoMethod ***overrides, gint32 *num_overrides,
960 MonoGenericContext *generic_context);
963 mono_class_get_cctor (MonoClass *klass) MONO_LLVM_INTERNAL;
966 mono_class_get_finalizer (MonoClass *klass);
969 mono_class_needs_cctor_run (MonoClass *klass, MonoMethod *caller);
972 mono_class_field_is_special_static (MonoClassField *field);
975 mono_class_field_get_special_static_type (MonoClassField *field);
978 mono_class_has_special_static_fields (MonoClass *klass);
981 mono_class_get_field_default_value (MonoClassField *field, MonoTypeEnum *def_type);
984 mono_class_get_property_default_value (MonoProperty *property, MonoTypeEnum *def_type);
987 mono_lookup_dynamic_token (MonoImage *image, guint32 token, MonoGenericContext *context, MonoError *error);
990 mono_lookup_dynamic_token_class (MonoImage *image, guint32 token, gboolean check_token, MonoClass **handle_class, MonoGenericContext *context, MonoError *error);
993 mono_runtime_create_jump_trampoline (MonoDomain *domain, MonoMethod *method, gboolean add_sync_wrapper, MonoError *error);
996 mono_runtime_create_delegate_trampoline (MonoClass *klass);
999 mono_install_get_cached_class_info (MonoGetCachedClassInfo func);
1002 mono_install_get_class_from_name (MonoGetClassFromName func);
1004 MONO_PROFILER_API MonoGenericContext*
1005 mono_class_get_context (MonoClass *klass);
1007 MONO_PROFILER_API MonoMethodSignature*
1008 mono_method_signature_checked (MonoMethod *m, MonoError *err);
1011 mono_method_get_context_general (MonoMethod *method, gboolean uninflated);
1013 MONO_PROFILER_API MonoGenericContext*
1014 mono_method_get_context (MonoMethod *method);
1016 /* Used by monodis, thus cannot be MONO_INTERNAL */
1017 MONO_API MonoGenericContainer*
1018 mono_method_get_generic_container (MonoMethod *method);
1021 mono_generic_class_get_context (MonoGenericClass *gclass);
1024 mono_generic_class_get_class (MonoGenericClass *gclass);
1027 mono_method_set_generic_container (MonoMethod *method, MonoGenericContainer* container);
1030 mono_class_inflate_generic_method_full (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context);
1033 mono_class_inflate_generic_method_full_checked (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context, MonoError *error);
1036 mono_class_inflate_generic_method_checked (MonoMethod *method, MonoGenericContext *context, MonoError *error);
1039 mono_metadata_get_image_set_for_method (MonoMethodInflated *method);
1041 MONO_API MonoMethodSignature *
1042 mono_metadata_get_inflated_signature (MonoMethodSignature *sig, MonoGenericContext *context);
1045 mono_class_inflate_generic_type_with_mempool (MonoImage *image, MonoType *type, MonoGenericContext *context, MonoError *error);
1048 mono_class_inflate_generic_type_checked (MonoType *type, MonoGenericContext *context, MonoError *error);
1051 mono_metadata_free_inflated_signature (MonoMethodSignature *sig);
1053 MonoMethodSignature*
1054 mono_inflate_generic_signature (MonoMethodSignature *sig, MonoGenericContext *context, MonoError *error);
1058 MonoClass *object_class;
1059 MonoClass *byte_class;
1060 MonoClass *void_class;
1061 MonoClass *boolean_class;
1062 MonoClass *sbyte_class;
1063 MonoClass *int16_class;
1064 MonoClass *uint16_class;
1065 MonoClass *int32_class;
1066 MonoClass *uint32_class;
1067 MonoClass *int_class;
1068 MonoClass *uint_class;
1069 MonoClass *int64_class;
1070 MonoClass *uint64_class;
1071 MonoClass *single_class;
1072 MonoClass *double_class;
1073 MonoClass *char_class;
1074 MonoClass *string_class;
1075 MonoClass *enum_class;
1076 MonoClass *array_class;
1077 MonoClass *delegate_class;
1078 MonoClass *multicastdelegate_class;
1079 MonoClass *asyncresult_class;
1080 MonoClass *manualresetevent_class;
1081 MonoClass *typehandle_class;
1082 MonoClass *fieldhandle_class;
1083 MonoClass *methodhandle_class;
1084 MonoClass *systemtype_class;
1085 MonoClass *runtimetype_class;
1086 MonoClass *exception_class;
1087 MonoClass *threadabortexception_class;
1088 MonoClass *thread_class;
1089 MonoClass *internal_thread_class;
1090 #ifndef DISABLE_REMOTING
1091 MonoClass *transparent_proxy_class;
1092 MonoClass *real_proxy_class;
1093 MonoClass *marshalbyrefobject_class;
1094 MonoClass *iremotingtypeinfo_class;
1096 MonoClass *mono_method_message_class;
1097 MonoClass *appdomain_class;
1098 MonoClass *field_info_class;
1099 MonoClass *method_info_class;
1100 MonoClass *stringbuilder_class;
1101 MonoClass *math_class;
1102 MonoClass *stack_frame_class;
1103 MonoClass *stack_trace_class;
1104 MonoClass *marshal_class;
1105 MonoClass *typed_reference_class;
1106 MonoClass *argumenthandle_class;
1107 MonoClass *monitor_class;
1108 MonoClass *generic_ilist_class;
1109 MonoClass *generic_nullable_class;
1110 MonoClass *handleref_class;
1111 MonoClass *attribute_class;
1112 MonoClass *customattribute_data_class;
1113 MonoClass *critical_finalizer_object; /* MAYBE NULL */
1114 MonoClass *generic_ireadonlylist_class;
1115 MonoClass *threadpool_wait_callback_class;
1116 MonoMethod *threadpool_perform_wait_callback_method;
1119 #ifdef DISABLE_REMOTING
1120 #define mono_class_is_transparent_proxy(klass) (FALSE)
1121 #define mono_class_is_real_proxy(klass) (FALSE)
1123 #define mono_class_is_transparent_proxy(klass) ((klass) == mono_defaults.transparent_proxy_class)
1124 #define mono_class_is_real_proxy(klass) ((klass) == mono_defaults.real_proxy_class)
1127 #define mono_object_is_transparent_proxy(object) (mono_class_is_transparent_proxy (mono_object_class (object)))
1130 #define GENERATE_GET_CLASS_WITH_CACHE_DECL(shortname) \
1131 MonoClass* mono_class_get_##shortname##_class (void);
1133 #define GENERATE_TRY_GET_CLASS_WITH_CACHE_DECL(shortname) \
1134 MonoClass* mono_class_try_get_##shortname##_class (void);
1136 #define GENERATE_GET_CLASS_WITH_CACHE(shortname,name_space,name) \
1138 mono_class_get_##shortname##_class (void) \
1140 static MonoClass *tmp_class; \
1141 MonoClass *klass = tmp_class; \
1143 klass = mono_class_load_from_name (mono_defaults.corlib, name_space, name); \
1144 mono_memory_barrier (); \
1145 tmp_class = klass; \
1150 #define GENERATE_TRY_GET_CLASS_WITH_CACHE(shortname,name_space,name) \
1152 mono_class_try_get_##shortname##_class (void) \
1154 static volatile MonoClass *tmp_class; \
1155 static volatile gboolean inited; \
1156 MonoClass *klass = (MonoClass *)tmp_class; \
1157 mono_memory_barrier (); \
1159 klass = mono_class_try_load_from_name (mono_defaults.corlib, name_space, name); \
1160 tmp_class = klass; \
1161 mono_memory_barrier (); \
1167 GENERATE_TRY_GET_CLASS_WITH_CACHE_DECL (safehandle)
1171 GENERATE_GET_CLASS_WITH_CACHE_DECL (interop_proxy)
1172 GENERATE_GET_CLASS_WITH_CACHE_DECL (idispatch)
1173 GENERATE_GET_CLASS_WITH_CACHE_DECL (iunknown)
1174 GENERATE_GET_CLASS_WITH_CACHE_DECL (com_object)
1175 GENERATE_GET_CLASS_WITH_CACHE_DECL (variant)
1179 extern MonoDefaults mono_defaults;
1182 mono_loader_init (void);
1185 mono_loader_cleanup (void);
1188 mono_loader_lock (void) MONO_LLVM_INTERNAL;
1191 mono_loader_unlock (void) MONO_LLVM_INTERNAL;
1194 mono_loader_lock_track_ownership (gboolean track);
1197 mono_loader_lock_is_owned_by_self (void);
1200 mono_loader_lock_if_inited (void);
1203 mono_loader_unlock_if_inited (void);
1206 mono_reflection_init (void);
1209 mono_icall_init (void);
1212 mono_icall_cleanup (void);
1215 mono_method_get_wrapper_data (MonoMethod *method, guint32 id);
1218 mono_metadata_has_generic_params (MonoImage *image, guint32 token);
1220 MONO_API MonoGenericContainer *
1221 mono_metadata_load_generic_params (MonoImage *image, guint32 token,
1222 MonoGenericContainer *parent_container);
1225 mono_metadata_load_generic_param_constraints_checked (MonoImage *image, guint32 token,
1226 MonoGenericContainer *container, MonoError *error);
1228 MonoMethodSignature*
1229 mono_create_icall_signature (const char *sigstr);
1232 mono_register_jit_icall (gconstpointer func, const char *name, MonoMethodSignature *sig, gboolean is_save);
1235 mono_register_jit_icall_full (gconstpointer func, const char *name, MonoMethodSignature *sig, gboolean is_save, gboolean no_raise, const char *c_symbol);
1238 mono_register_jit_icall_wrapper (MonoJitICallInfo *info, gconstpointer wrapper);
1241 mono_find_jit_icall_by_name (const char *name) MONO_LLVM_INTERNAL;
1244 mono_find_jit_icall_by_addr (gconstpointer addr) MONO_LLVM_INTERNAL;
1247 mono_get_jit_icall_info (void);
1250 mono_lookup_jit_icall_symbol (const char *name);
1253 mono_class_set_type_load_failure (MonoClass *klass, const char * fmt, ...) MONO_ATTR_FORMAT_PRINTF(2,3);
1256 mono_class_get_exception_for_failure (MonoClass *klass);
1259 mono_type_get_name_full (MonoType *type, MonoTypeNameFormat format);
1262 mono_type_get_full_name (MonoClass *klass);
1265 mono_method_get_name_full (MonoMethod *method, gboolean signature, gboolean ret, MonoTypeNameFormat format);
1268 mono_method_get_full_name (MonoMethod *method);
1270 MonoArrayType *mono_dup_array_type (MonoImage *image, MonoArrayType *a);
1271 MonoMethodSignature *mono_metadata_signature_deep_dup (MonoImage *image, MonoMethodSignature *sig);
1274 mono_image_init_name_cache (MonoImage *image);
1276 gboolean mono_class_is_nullable (MonoClass *klass);
1277 MonoClass *mono_class_get_nullable_param (MonoClass *klass);
1279 /* object debugging functions, for use inside gdb */
1280 MONO_API void mono_object_describe (MonoObject *obj);
1281 MONO_API void mono_object_describe_fields (MonoObject *obj);
1282 MONO_API void mono_value_describe_fields (MonoClass* klass, const char* addr);
1283 MONO_API void mono_class_describe_statics (MonoClass* klass);
1285 /* method debugging functions, for use inside gdb */
1286 MONO_API void mono_method_print_code (MonoMethod *method);
1288 MONO_PROFILER_API char *mono_signature_full_name (MonoMethodSignature *sig);
1290 /*Enum validation related functions*/
1292 mono_type_is_valid_enum_basetype (MonoType * type);
1295 mono_class_is_valid_enum (MonoClass *klass);
1297 MONO_PROFILER_API gboolean
1298 mono_type_is_primitive (MonoType *type);
1301 mono_type_get_checked (MonoImage *image, guint32 type_token, MonoGenericContext *context, MonoError *error);
1304 mono_generic_class_is_generic_type_definition (MonoGenericClass *gklass);
1307 mono_class_get_method_generic (MonoClass *klass, MonoMethod *method);
1310 mono_type_get_basic_type_from_generic (MonoType *type);
1313 mono_method_can_access_method_full (MonoMethod *method, MonoMethod *called, MonoClass *context_klass);
1316 mono_method_can_access_field_full (MonoMethod *method, MonoClassField *field, MonoClass *context_klass);
1319 mono_class_can_access_class (MonoClass *access_class, MonoClass *target_class);
1322 mono_class_get_generic_type_definition (MonoClass *klass);
1325 mono_class_has_parent_and_ignore_generics (MonoClass *klass, MonoClass *parent);
1328 mono_method_get_vtable_slot (MonoMethod *method);
1331 mono_method_get_vtable_index (MonoMethod *method);
1334 mono_method_get_base_method (MonoMethod *method, gboolean definition, MonoError *error);
1337 mono_method_search_in_array_class (MonoClass *klass, const char *name, MonoMethodSignature *sig);
1340 mono_class_setup_interface_id (MonoClass *klass);
1342 MonoGenericContainer*
1343 mono_class_get_generic_container (MonoClass *klass);
1346 mono_class_alloc (MonoClass *klass, int size);
1349 mono_class_alloc0 (MonoClass *klass, int size);
1352 mono_class_setup_interfaces (MonoClass *klass, MonoError *error);
1355 mono_class_get_field_from_name_full (MonoClass *klass, const char *name, MonoType *type);
1358 mono_class_vtable_full (MonoDomain *domain, MonoClass *klass, MonoError *error);
1361 mono_class_is_assignable_from_slow (MonoClass *target, MonoClass *candidate);
1364 mono_class_has_variant_generic_params (MonoClass *klass);
1367 mono_class_is_variant_compatible (MonoClass *klass, MonoClass *oklass, gboolean check_for_reference_conv);
1369 gboolean mono_is_corlib_image (MonoImage *image);
1372 mono_field_get_type_checked (MonoClassField *field, MonoError *error);
1375 mono_class_get_fields_lazy (MonoClass* klass, gpointer *iter);
1378 mono_class_check_vtable_constraints (MonoClass *klass, GList *in_setup);
1381 mono_class_has_finalizer (MonoClass *klass);
1384 mono_unload_interface_id (MonoClass *klass);
1387 mono_class_get_methods_by_name (MonoClass *klass, const char *name, guint32 bflags, gboolean ignore_case, gboolean allow_ctors, MonoError *error);
1390 mono_class_full_name (MonoClass *klass);
1393 mono_class_inflate_generic_class_checked (MonoClass *gklass, MonoGenericContext *context, MonoError *error);
1396 mono_class_get_checked (MonoImage *image, guint32 type_token, MonoError *error);
1399 mono_class_get_and_inflate_typespec_checked (MonoImage *image, guint32 type_token, MonoGenericContext *context, MonoError *error);
1402 mono_class_from_name_checked (MonoImage *image, const char* name_space, const char *name, MonoError *error);
1405 mono_class_from_name_case_checked (MonoImage *image, const char* name_space, const char *name, MonoError *error);
1408 mono_field_from_token_checked (MonoImage *image, uint32_t token, MonoClass **retklass, MonoGenericContext *context, MonoError *error);
1411 mono_ldtoken_checked (MonoImage *image, guint32 token, MonoClass **handle_class, MonoGenericContext *context, MonoError *error);
1414 mono_class_from_generic_parameter_internal (MonoGenericParam *param);
1417 get_image_for_generic_param (MonoGenericParam *param);
1420 make_generic_name_string (MonoImage *image, int num);
1423 mono_class_load_from_name (MonoImage *image, const char* name_space, const char *name) MONO_LLVM_INTERNAL;
1426 mono_class_try_load_from_name (MonoImage *image, const char* name_space, const char *name);
1429 mono_error_set_for_class_failure (MonoError *orerror, const MonoClass *klass);
1432 mono_class_has_failure (const MonoClass *klass);
1434 /* Kind specific accessors */
1436 mono_class_get_generic_class (MonoClass *klass);
1439 mono_class_try_get_generic_class (MonoClass *klass);
1442 mono_class_set_flags (MonoClass *klass, guint32 flags);
1444 MonoGenericContainer*
1445 mono_class_try_get_generic_container (MonoClass *klass);
1448 mono_class_set_generic_container (MonoClass *klass, MonoGenericContainer *container);
1451 mono_class_gtd_get_canonical_inst (MonoClass *klass);
1454 mono_class_get_first_method_idx (MonoClass *klass);
1457 mono_class_set_first_method_idx (MonoClass *klass, guint32 idx);
1460 mono_class_get_first_field_idx (MonoClass *klass);
1463 mono_class_set_first_field_idx (MonoClass *klass, guint32 idx);
1466 mono_class_get_method_count (MonoClass *klass);
1469 mono_class_set_method_count (MonoClass *klass, guint32 count);
1472 mono_class_get_field_count (MonoClass *klass);
1475 mono_class_set_field_count (MonoClass *klass, guint32 count);
1478 mono_class_get_marshal_info (MonoClass *class);
1481 mono_class_set_marshal_info (MonoClass *class, MonoMarshalType *marshal_info);
1484 mono_class_get_ref_info_handle (MonoClass *class);
1487 mono_class_set_ref_info_handle (MonoClass *class, guint32 value);
1490 mono_class_get_exception_data (MonoClass *klass);
1493 mono_class_set_exception_data (MonoClass *klass, MonoErrorBoxed *value);
1496 mono_class_get_nested_classes_property (MonoClass *klass);
1499 mono_class_set_nested_classes_property (MonoClass *klass, GList *value);
1501 MonoClassPropertyInfo*
1502 mono_class_get_property_info (MonoClass *klass);
1505 mono_class_set_property_info (MonoClass *klass, MonoClassPropertyInfo *info);
1508 mono_class_get_event_info (MonoClass *klass);
1511 mono_class_set_event_info (MonoClass *klass, MonoClassEventInfo *info);
1513 MonoFieldDefaultValue*
1514 mono_class_get_field_def_values (MonoClass *klass);
1517 mono_class_set_field_def_values (MonoClass *klass, MonoFieldDefaultValue *values);
1520 mono_class_get_declsec_flags (MonoClass *class);
1523 mono_class_set_declsec_flags (MonoClass *class, guint32 value);
1526 mono_class_set_is_com_object (MonoClass *klass);
1528 /*Now that everything has been defined, let's include the inline functions */
1529 #include <mono/metadata/class-inlines.h>
1531 #endif /* __MONO_METADATA_CLASS_INTERNALS_H__ */