2 * Copyright 2012 Xamarin Inc
4 #ifndef __MONO_METADATA_CLASS_INTERBALS_H__
5 #define __MONO_METADATA_CLASS_INTERBALS_H__
7 #include <mono/metadata/class.h>
8 #include <mono/metadata/object.h>
9 #include <mono/metadata/mempool.h>
10 #include <mono/metadata/metadata-internals.h>
11 #include <mono/io-layer/io-layer.h>
12 #include "mono/utils/mono-compiler.h"
13 #include "mono/utils/mono-error.h"
15 #define MONO_CLASS_IS_ARRAY(c) ((c)->rank)
17 #define MONO_CLASS_HAS_STATIC_METADATA(klass) ((klass)->type_token && !(klass)->image->dynamic && !(klass)->generic_class)
19 #define MONO_DEFAULT_SUPERTABLE_SIZE 6
21 extern gboolean mono_print_vtable;
23 typedef struct _MonoMethodWrapper MonoMethodWrapper;
24 typedef struct _MonoMethodInflated MonoMethodInflated;
25 typedef struct _MonoMethodPInvoke MonoMethodPInvoke;
27 /* Properties that applies to a group of structs should better use a higher number
28 * to avoid colision with type specific properties.
30 * This prop applies to class, method, property, event, assembly and image.
32 #define MONO_PROP_DYNAMIC_CATTR 0x1000
34 #ifdef ENABLE_ICALL_EXPORT
35 #pragma GCC diagnostic ignored "-Wmissing-prototypes"
36 #define ICALL_EXPORT MONO_API
38 #define ICALL_EXPORT static
42 #define WRAPPER(e,n) MONO_WRAPPER_ ## e,
43 #include "wrapper-types.h"
49 MONO_TYPE_NAME_FORMAT_IL,
50 MONO_TYPE_NAME_FORMAT_REFLECTION,
51 MONO_TYPE_NAME_FORMAT_FULL_NAME,
52 MONO_TYPE_NAME_FORMAT_ASSEMBLY_QUALIFIED
56 MONO_REMOTING_TARGET_UNKNOWN,
57 MONO_REMOTING_TARGET_APPDOMAIN,
58 MONO_REMOTING_TARGET_COMINTEROP
61 #define MONO_METHOD_PROP_GENERIC_CONTAINER 0
64 guint16 flags; /* method flags */
65 guint16 iflags; /* method implementation flags */
68 MonoMethodSignature *signature;
69 /* name is useful mostly for debugging */
71 /* this is used by the inlining algorithm */
72 unsigned int inline_info:1;
73 unsigned int inline_failure:1;
74 unsigned int wrapper_type:5;
75 unsigned int string_ctor:1;
76 unsigned int save_lmf:1;
77 unsigned int dynamic:1; /* created & destroyed during runtime */
78 unsigned int sre_method:1; /* created at runtime using Reflection.Emit */
79 unsigned int is_generic:1; /* whenever this is a generic method definition */
80 unsigned int is_inflated:1; /* whether we're a MonoMethodInflated */
81 unsigned int skip_visibility:1; /* whenever to skip JIT visibility checks */
82 unsigned int verification_success:1; /* whether this method has been verified successfully.*/
83 /* TODO we MUST get rid of this field, it's an ugly hack nobody is proud of. */
84 unsigned int is_mb_open : 1; /* This is the fully open instantiation of a generic method_builder. Worse than is_tb_open, but it's temporary */
88 * If is_generic is TRUE, the generic_container is stored in image->property_hash,
89 * using the key MONO_METHOD_PROP_GENERIC_CONTAINER.
93 struct _MonoMethodWrapper {
95 MonoMethodHeader *header;
99 struct _MonoMethodPInvoke {
102 /* add marshal info */
103 guint16 piflags; /* pinvoke flags */
104 guint16 implmap_idx; /* index into IMPLMAP */
108 * Stores the default value / RVA of fields.
109 * This information is rarely needed, so it is stored separately from
112 typedef struct MonoFieldDefaultValue {
114 * If the field is constant, pointer to the metadata constant
116 * If the field has an RVA flag, pointer to the data.
121 /* If the field is constant, the type of the constant. */
122 MonoTypeEnum def_type;
123 } MonoFieldDefaultValue;
126 * MonoClassField is just a runtime representation of the metadata for
127 * field, it doesn't contain the data directly. Static fields are
128 * stored in MonoVTable->data. Instance fields are allocated in the
129 * objects after the object header.
131 struct _MonoClassField {
132 /* Type of the field */
137 /* Type where the field was defined */
141 * Offset where this field is stored; if it is an instance
142 * field, it's the offset from the start of the object, if
143 * it's static, it's from the start of the memory chunk
144 * allocated for statics for the class.
145 * For special static fields, this is set to -1 during vtable construction.
150 /* a field is ignored if it's named "_Deleted" and it has the specialname and rtspecialname flags set */
151 #define mono_field_is_deleted(field) (((field)->type->attrs & (FIELD_ATTRIBUTE_SPECIAL_NAME | FIELD_ATTRIBUTE_RT_SPECIAL_NAME)) \
152 && (strcmp (mono_field_get_name (field), "_Deleted") == 0))
154 /* a field is ignored if it's named "_Deleted" and it has the specialname and rtspecialname flags set */
155 /* Try to avoid loading the field's type */
156 #define mono_field_is_deleted_with_flags(field, flags) (((flags) & (FIELD_ATTRIBUTE_SPECIAL_NAME | FIELD_ATTRIBUTE_RT_SPECIAL_NAME)) \
157 && (strcmp (mono_field_get_name (field), "_Deleted") == 0))
160 MonoClassField *field;
162 MonoMarshalSpec *mspec;
166 guint32 native_size, min_align;
168 MonoMethod *ptr_to_str;
169 MonoMethod *str_to_ptr;
170 MonoMarshalField fields [MONO_ZERO_LEN_ARRAY];
173 #define MONO_SIZEOF_MARSHAL_TYPE (offsetof (MonoMarshalType, fields))
175 struct _MonoProperty {
189 #ifndef MONO_SMALL_CONFIG
195 /* type of exception being "on hold" for later processing (see exception_type) */
197 MONO_EXCEPTION_NONE = 0,
198 MONO_EXCEPTION_SECURITY_LINKDEMAND = 1,
199 MONO_EXCEPTION_SECURITY_INHERITANCEDEMAND = 2,
200 MONO_EXCEPTION_INVALID_PROGRAM = 3,
201 MONO_EXCEPTION_UNVERIFIABLE_IL = 4,
202 MONO_EXCEPTION_MISSING_METHOD = 5,
203 MONO_EXCEPTION_MISSING_FIELD = 6,
204 MONO_EXCEPTION_TYPE_LOAD = 7,
205 MONO_EXCEPTION_FILE_NOT_FOUND = 8,
206 MONO_EXCEPTION_METHOD_ACCESS = 9,
207 MONO_EXCEPTION_FIELD_ACCESS = 10,
208 MONO_EXCEPTION_GENERIC_SHARING_FAILED = 11,
209 MONO_EXCEPTION_BAD_IMAGE = 12,
210 MONO_EXCEPTION_OBJECT_SUPPLIED = 13, /*The exception object is already created.*/
211 MONO_EXCEPTION_OUT_OF_MEMORY = 14,
212 MONO_EXCEPTION_INLINE_FAILED = 15,
213 MONO_EXCEPTION_MONO_ERROR = 16,
214 /* add other exception type */
217 /* This struct collects the info needed for the runtime use of a class,
218 * like the vtables for a domain, the GC descriptor, etc.
222 /* domain_vtables is indexed by the domain id and the size is max_domain + 1 */
223 MonoVTable *domain_vtables [MONO_ZERO_LEN_ARRAY];
224 } MonoClassRuntimeInfo;
226 #define MONO_SIZEOF_CLASS_RUNTIME_INFO (sizeof (MonoClassRuntimeInfo) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
228 #define MONO_CLASS_PROP_EXCEPTION_DATA 0
231 * This structure contains the rarely used fields of MonoClass
232 * Since using just one field causes the whole structure to be allocated, it should
233 * be used for fields which are only used in like 5% of all classes.
237 #if MONO_SMALL_CONFIG
238 guint16 first, count;
240 guint32 first, count;
244 /* Initialized by a call to mono_class_setup_properties () */
245 MonoProperty *properties;
247 /* Initialized by a call to mono_class_setup_events () */
250 guint32 declsec_flags; /* declarative security attributes flags */
252 /* Default values/RVA for fields and properties */
253 /* Accessed using mono_class_get_field_default_value () / mono_field_get_data () */
254 MonoFieldDefaultValue *field_def_values;
255 MonoFieldDefaultValue *prop_def_values;
257 GList *nested_classes;
261 /* element class for arrays and enum basetype for enums */
262 MonoClass *element_class;
263 /* used for subtype checks */
264 MonoClass *cast_class;
266 /* for fast subtype checks */
267 MonoClass **supertypes;
270 /* array dimension */
273 int instance_size; /* object instance size */
276 /* We use init_pending to detect cyclic calls to mono_class_init */
277 guint init_pending : 1;
279 /* A class contains static and non static data. Static data can be
280 * of the same type as the class itselfs, but it does not influence
281 * the instance size of the class. To avoid cyclic calls to
282 * mono_class_init (from mono_class_instance_size ()) we first
283 * initialise all non static fields. After that we set size_inited
284 * to 1, because we know the instance size now. After that we
285 * initialise all static fields.
287 /* size_inited is accessed without locks, so it needs a memory barrier */
288 guint size_inited : 1;
289 guint valuetype : 1; /* derives from System.ValueType */
290 guint enumtype : 1; /* derives from System.Enum */
291 guint blittable : 1; /* class is blittable */
292 guint unicode : 1; /* class uses unicode char when marshalled */
293 guint wastypebuilder : 1; /* class was created at runtime from a TypeBuilder */
298 guint packing_size : 4;
299 guint ghcimpl : 1; /* class has its own GetHashCode impl */
300 guint has_finalize : 1; /* class has its own Finalize impl */
301 #ifndef DISABLE_REMOTING
302 guint marshalbyref : 1; /* class is a MarshalByRefObject */
303 guint contextbound : 1; /* class is a ContextBoundObject */
306 guint delegate : 1; /* class is a Delegate */
307 guint gc_descr_inited : 1; /* gc_descr is initialized */
308 guint has_cctor : 1; /* class has a cctor */
309 guint has_references : 1; /* it has GC-tracked references in the instance */
310 guint has_static_refs : 1; /* it has static fields that are GC-tracked */
311 guint no_special_static_fields : 1; /* has no thread/context static fields */
312 /* directly or indirectly derives from ComImport attributed class.
313 * this means we need to create a proxy for instances of this class
314 * for COM Interop. set this flag on loading so all we need is a quick check
315 * during object creation rather than having to traverse supertypes
317 guint is_com_object : 1;
318 guint nested_classes_inited : 1; /* Whenever nested_class is initialized */
321 guint interfaces_inited : 1; /* interfaces is initialized */
322 guint simd_type : 1; /* class is a simd intrinsic type */
323 guint is_generic : 1; /* class is a generic type definition */
324 guint is_inflated : 1; /* class is a generic instance */
325 guint has_finalize_inited : 1; /* has_finalize is initialized */
326 guint fields_inited : 1; /* fields is initialized */
327 guint setup_fields_called : 1; /* to prevent infinite loops in setup_fields */
329 guint8 exception_type; /* MONO_EXCEPTION_* */
331 /* Additional information about the exception */
332 /* Stored as property MONO_CLASS_PROP_EXCEPTION_DATA */
333 //void *exception_data;
336 MonoClass *nested_in;
340 const char *name_space;
343 int vtable_size; /* number of slots */
345 guint16 interface_count;
346 guint16 interface_id; /* unique inderface id (for interfaces) */
347 guint16 max_interface_id;
349 guint16 interface_offsets_count;
350 MonoClass **interfaces_packed;
351 guint16 *interface_offsets_packed;
352 /* enabled only with small config for now: we might want to do it unconditionally */
353 #ifdef MONO_SMALL_CONFIG
354 #define COMPRESSED_INTERFACE_BITMAP 1
356 guint8 *interface_bitmap;
358 MonoClass **interfaces;
361 int class_size; /* size of area for static fields */
362 int element_size; /* for array types */
363 int generic_param_token; /* for generic param types, both var and mvar */
367 * From the TypeDef table
371 #if MONO_SMALL_CONFIG
372 guint16 first, count;
374 guint32 first, count;
378 /* A GC handle pointing to the corresponding type builder/generic param builder */
379 guint32 ref_info_handle;
381 /* loaded on demand */
382 MonoMarshalType *marshal_info;
385 * Field information: Type and location from object base
387 MonoClassField *fields;
389 MonoMethod **methods;
391 /* used as the type of the this argument and when passing the arg by value */
395 MonoGenericClass *generic_class;
396 MonoGenericContainer *generic_container;
400 MonoClassRuntimeInfo *runtime_info;
402 /* next element in the class_cache hash list (in MonoImage) */
403 MonoClass *next_class_cache;
405 /* Generic vtable. Initialized by a call to mono_class_setup_vtable () */
408 /* Rarely used fields of classes */
412 #ifdef COMPRESSED_INTERFACE_BITMAP
413 int mono_compress_bitmap (uint8_t *dest, const uint8_t *bitmap, int size);
414 int mono_class_interface_match (const uint8_t *bitmap, int id);
416 #define mono_class_interface_match(bmap,uiid) ((bmap) [(uiid) >> 3] & (1 << ((uiid)&7)))
419 #define MONO_CLASS_IMPLEMENTS_INTERFACE(k,uiid) (((uiid) <= (k)->max_interface_id) && mono_class_interface_match ((k)->interface_bitmap, (uiid)))
421 #define MONO_VTABLE_AVAILABLE_GC_BITS 4
423 #ifdef DISABLE_REMOTING
424 #define mono_class_is_marshalbyref(klass) (FALSE)
425 #define mono_class_is_contextbound(klass) (FALSE)
426 #define mono_vtable_is_remote(vtable) (FALSE)
427 #define mono_vtable_set_is_remote(vtable,enable) do {} while (0)
429 #define mono_class_is_marshalbyref(klass) ((klass)->marshalbyref)
430 #define mono_class_is_contextbound(klass) ((klass)->contextbound)
431 #define mono_vtable_is_remote(vtable) ((vtable)->remote)
432 #define mono_vtable_set_is_remote(vtable,enable) do { (vtable)->remote = enable ? 1 : 0; } while (0)
436 #define mono_class_is_com_object(klass) (FALSE)
437 #define mono_class_set_is_com_object(klass) do {} while (0)
439 #define mono_class_is_com_object(klass) ((klass)->is_com_object)
440 #define mono_class_set_is_com_object(klass) do { (klass)->is_com_object = 1; } while (0)
444 MONO_API int mono_class_interface_offset (MonoClass *klass, MonoClass *itf);
445 int mono_class_interface_offset_with_variance (MonoClass *klass, MonoClass *itf, gboolean *non_exact_match);
447 typedef gpointer MonoRuntimeGenericContext;
449 /* the interface_offsets array is stored in memory before this struct */
453 * According to comments in gc_gcj.h, this should be the second word in
457 MonoDomain *domain; /* each object/vtable belongs to exactly one domain */
458 gpointer type; /* System.Type type for klass */
459 guint8 *interface_bitmap;
460 guint16 max_interface_id;
462 guint remote : 1; /* class is remotely activated */
463 guint initialized : 1; /* cctor has been run */
464 guint init_failed : 1; /* cctor execution failed */
465 guint has_static_fields : 1; /* pointer to the data stored at the end of the vtable array */
466 guint gc_bits : MONO_VTABLE_AVAILABLE_GC_BITS; /* Those bits are reserved for the usaged of the GC */
468 guint32 imt_collisions_bitmap;
469 MonoRuntimeGenericContext *runtime_generic_context;
470 /* do not add any fields after vtable, the structure is dynamically extended */
471 /* vtable contains function pointers to methods or their trampolines, at the
472 end there may be a slot containing the pointer to the static fields */
473 gpointer vtable [MONO_ZERO_LEN_ARRAY];
476 #define MONO_SIZEOF_VTABLE (sizeof (MonoVTable) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
478 #define MONO_VTABLE_IMPLEMENTS_INTERFACE(vt,uiid) (((uiid) <= (vt)->max_interface_id) && mono_class_interface_match ((vt)->interface_bitmap, (uiid)))
481 * Generic instantiation data type encoding.
485 * A particular generic instantiation:
487 * All instantiations are cached and we don't distinguish between class and method
488 * instantiations here.
490 struct _MonoGenericInst {
491 #ifndef MONO_SMALL_CONFIG
492 guint id; /* unique ID for debugging */
494 guint type_argc : 22; /* number of type arguments */
495 guint is_open : 1; /* if this is an open type */
496 MonoType *type_argv [MONO_ZERO_LEN_ARRAY];
499 #define MONO_SIZEOF_GENERIC_INST (sizeof (MonoGenericInst) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
501 * The generic context: an instantiation of a set of class and method generic parameters.
503 * NOTE: Never allocate this directly on the heap. It have to be either allocated on the stack,
504 * or embedded within other objects. Don't store pointers to this, because it may be on the stack.
505 * If you really have to, ensure you store a pointer to the embedding object along with it.
507 struct _MonoGenericContext {
508 /* The instantiation corresponding to the class generic parameters */
509 MonoGenericInst *class_inst;
510 /* The instantiation corresponding to the method generic parameters */
511 MonoGenericInst *method_inst;
515 * Inflated generic method.
517 struct _MonoMethodInflated {
520 MonoMethodPInvoke pinvoke;
522 MonoMethodHeader *header;
523 MonoMethod *declaring; /* the generic method definition. */
524 MonoGenericContext context; /* The current instantiation */
528 * A particular instantiation of a generic type.
530 struct _MonoGenericClass {
531 MonoClass *container_class; /* the generic type definition */
532 MonoGenericContext context; /* a context that contains the type instantiation doesn't contain any method instantiation */
533 guint is_dynamic : 1; /* We're a MonoDynamicGenericClass */
534 guint is_tb_open : 1; /* This is the fully open instantiation for a type_builder. Quite ugly, but it's temporary.*/
535 MonoClass *cached_class; /* if present, the MonoClass corresponding to the instantiation. */
538 * The image set which owns this generic class. Memory owned by the generic class
539 * including cached_class should be allocated from the mempool of the image set,
540 * so it is easy to free.
546 * This is used when instantiating a generic type definition which is
549 struct _MonoDynamicGenericClass {
550 MonoGenericClass generic_class;
552 MonoClassField *fields;
554 /* The non-inflated types of the fields */
555 MonoType **field_generic_types;
556 /* The managed objects representing the fields */
557 MonoObject **field_objects;
563 struct _MonoGenericParam {
565 * Type or method this parameter was defined in.
567 MonoGenericContainer *owner;
570 * If != 0, this is a generated generic param used by the JIT to implement generic
573 MonoTypeEnum gshared_constraint;
575 * If owner is NULL, or owner is 'owned' by this gparam,
576 * then this is the image whose mempool this struct was allocated from.
577 * The second case happens for gparams created in
578 * mono_reflection_initialize_generic_parameter ().
583 /* Additional details about a MonoGenericParam */
585 MonoClass *pklass; /* The corresponding `MonoClass'. */
589 MonoClass** constraints; /* NULL means end of list */
590 } MonoGenericParamInfo;
593 MonoGenericParam param;
594 MonoGenericParamInfo info;
595 } MonoGenericParamFull;
598 * The generic container.
600 * Stores the type parameters of a generic type definition or a generic method definition.
602 struct _MonoGenericContainer {
603 MonoGenericContext context;
604 /* If we're a generic method definition in a generic type definition,
605 the generic container of the containing class. */
606 MonoGenericContainer *parent;
607 /* the generic type definition or the generic method definition corresponding to this container */
613 /* If true, we're a generic method, otherwise a generic type definition. */
614 /* Invariant: parent != NULL => is_method */
616 /* Our type parameters. */
617 MonoGenericParamFull *type_params;
620 * For owner-less containers created by SRE, the image the container was
626 #define mono_generic_container_get_param(gc, i) ((MonoGenericParam *) ((gc)->type_params + (i)))
627 #define mono_generic_container_get_param_info(gc, i) (&((gc)->type_params + (i))->info)
629 #define mono_generic_param_owner(p) ((p)->owner)
630 #define mono_generic_param_num(p) ((p)->num)
631 #define mono_generic_param_info(p) (mono_generic_param_owner (p) ? &((MonoGenericParamFull *) p)->info : NULL)
632 #define mono_generic_param_name(p) (((mono_generic_param_owner (p) || (p)->gshared_constraint)) ? ((MonoGenericParamFull *) p)->info.name : NULL)
633 #define mono_type_get_generic_param_owner(t) (mono_generic_param_owner ((t)->data.generic_param))
634 #define mono_type_get_generic_param_num(t) (mono_generic_param_num ((t)->data.generic_param))
637 * Class information which might be cached by the runtime in the AOT file for
638 * example. Caching this allows us to avoid computing a generic vtable
639 * (class->vtable) in most cases, saving time and avoiding creation of lots of
640 * MonoMethod structures.
642 typedef struct MonoCachedClassInfo {
644 guint has_finalize : 1;
647 guint has_nested_classes : 1;
649 guint has_references : 1;
650 guint has_static_refs : 1;
651 guint no_special_static_fields : 1;
652 guint is_generic_container : 1;
654 MonoImage *finalize_image;
655 guint32 finalize_token;
656 guint32 instance_size;
658 guint32 packing_size;
660 } MonoCachedClassInfo;
665 gconstpointer wrapper;
666 gconstpointer trampoline;
667 MonoMethodSignature *sig;
668 const char *c_symbol;
669 MonoMethod *wrapper_method;
674 guint8 exception_type;
675 char *class_name; /* If kind == TYPE */
676 char *assembly_name; /* If kind == TYPE or ASSEMBLY */
677 MonoClass *klass; /* If kind != TYPE */
678 const char *member_name; /* If kind != TYPE */
679 gboolean ref_only; /* If kind == ASSEMBLY */
680 char *msg; /* If kind == BAD_IMAGE */
684 mono_class_setup_supertypes (MonoClass *klass);
687 mono_class_setup_fields_locking (MonoClass *klass);
690 * Only call this function if you can ensure both @klass and @parent
691 * have supertype information initialized.
692 * This can be accomplished by mono_class_setup_supertypes or mono_class_init.
693 * If unsure, use mono_class_has_parent.
695 static inline gboolean
696 mono_class_has_parent_fast (MonoClass *klass, MonoClass *parent)
698 return (klass->idepth >= parent->idepth) && (klass->supertypes [parent->idepth - 1] == parent);
701 static inline gboolean
702 mono_class_has_parent (MonoClass *klass, MonoClass *parent)
704 if (G_UNLIKELY (!klass->supertypes))
705 mono_class_setup_supertypes (klass);
707 if (G_UNLIKELY (!parent->supertypes))
708 mono_class_setup_supertypes (parent);
710 return mono_class_has_parent_fast (klass, parent);
714 MonoVTable *default_vtable;
715 MonoVTable *xdomain_vtable;
716 MonoClass *proxy_class;
717 char* proxy_class_name;
718 uint32_t interface_count;
719 MonoClass *interfaces [MONO_ZERO_LEN_ARRAY];
722 #define MONO_SIZEOF_REMOTE_CLASS (sizeof (MonoRemoteClass) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
725 guint64 new_object_count;
726 size_t initialized_class_count;
727 size_t generic_vtable_count;
728 size_t used_class_count;
730 size_t class_vtable_size;
731 size_t class_static_data_size;
732 size_t generic_instance_count;
733 size_t generic_class_count;
734 size_t inflated_method_count;
735 size_t inflated_method_count_2;
736 size_t inflated_type_count;
737 size_t generics_metadata_size;
738 size_t delegate_creations;
739 size_t imt_tables_size;
740 size_t imt_number_of_tables;
741 size_t imt_number_of_methods;
742 size_t imt_used_slots;
743 size_t imt_slots_with_collisions;
744 size_t imt_max_collisions_in_slot;
745 size_t imt_method_count_when_max_collisions;
746 size_t imt_thunks_size;
747 size_t jit_info_table_insert_count;
748 size_t jit_info_table_remove_count;
749 size_t jit_info_table_lookup_count;
750 size_t generics_sharable_methods;
751 size_t generics_unsharable_methods;
752 size_t generics_shared_methods;
753 size_t gsharedvt_methods;
754 size_t minor_gc_count;
755 size_t major_gc_count;
756 size_t minor_gc_time_usecs;
757 size_t major_gc_time_usecs;
762 * new structure to hold performace counters values that are exported
764 * Note: never remove fields from this structure and only add them to the end.
765 * Size of fields and type should not be changed as well.
772 guint32 jit_failures;
773 /* Exceptions category */
774 guint32 exceptions_thrown;
775 guint32 exceptions_filters;
776 guint32 exceptions_finallys;
777 guint32 exceptions_depth;
778 guint32 aspnet_requests_queued;
779 guint32 aspnet_requests;
780 /* Memory category */
781 guint32 gc_collections0;
782 guint32 gc_collections1;
783 guint32 gc_collections2;
784 guint32 gc_promotions0;
785 guint32 gc_promotions1;
786 guint32 gc_promotion_finalizers;
791 guint32 gc_fin_survivors;
792 guint32 gc_num_handles;
793 guint32 gc_allocated;
796 guint32 gc_total_bytes;
797 guint32 gc_committed_bytes;
798 guint32 gc_reserved_bytes;
799 guint32 gc_num_pinned;
800 guint32 gc_sync_blocks;
801 /* Remoting category */
802 guint32 remoting_calls;
803 guint32 remoting_channels;
804 guint32 remoting_proxies;
805 guint32 remoting_classes;
806 guint32 remoting_objects;
807 guint32 remoting_contexts;
808 /* Loader category */
809 guint32 loader_classes;
810 guint32 loader_total_classes;
811 guint32 loader_appdomains;
812 guint32 loader_total_appdomains;
813 guint32 loader_assemblies;
814 guint32 loader_total_assemblies;
815 guint32 loader_failures;
816 guint32 loader_bytes;
817 guint32 loader_appdomains_uloaded;
818 /* Threads and Locks category */
819 guint32 thread_contentions;
820 guint32 thread_queue_len;
821 guint32 thread_queue_max;
822 guint32 thread_num_logical;
823 guint32 thread_num_physical;
824 guint32 thread_cur_recognized;
825 guint32 thread_num_recognized;
826 /* Interop category */
827 guint32 interop_num_ccw;
828 guint32 interop_num_stubs;
829 guint32 interop_num_marshals;
830 /* Security category */
831 guint32 security_num_checks;
832 guint32 security_num_link_checks;
833 guint32 security_time;
834 guint32 security_depth;
837 guint64 threadpool_workitems;
838 guint64 threadpool_ioworkitems;
839 guint threadpool_threads;
840 guint threadpool_iothreads;
843 extern MonoPerfCounters *mono_perfcounters;
845 MONO_API void mono_perfcounters_init (void);
848 * The definition of the first field in SafeHandle,
849 * Keep in sync with SafeHandle.cs, this is only used
850 * to access the `handle' parameter.
858 * Keep in sync with HandleRef.cs
866 MONO_GENERIC_SHARING_NONE,
867 MONO_GENERIC_SHARING_COLLECTIONS,
868 MONO_GENERIC_SHARING_CORLIB,
869 MONO_GENERIC_SHARING_ALL
873 * Flags for which contexts were used in inflating a generic.
876 MONO_GENERIC_CONTEXT_USED_CLASS = 1,
877 MONO_GENERIC_CONTEXT_USED_METHOD = 2
880 #define MONO_GENERIC_CONTEXT_USED_BOTH (MONO_GENERIC_CONTEXT_USED_CLASS | MONO_GENERIC_CONTEXT_USED_METHOD)
882 extern MonoStats mono_stats;
884 typedef gpointer (*MonoTrampoline) (MonoMethod *method);
885 typedef gpointer (*MonoJumpTrampoline) (MonoDomain *domain, MonoMethod *method, gboolean add_sync_wrapper);
886 typedef gpointer (*MonoRemotingTrampoline) (MonoDomain *domain, MonoMethod *method, MonoRemotingTarget target);
887 typedef gpointer (*MonoDelegateTrampoline) (MonoDomain *domain, MonoClass *klass);
889 typedef gpointer (*MonoLookupDynamicToken) (MonoImage *image, guint32 token, gboolean valid_token, MonoClass **handle_class, MonoGenericContext *context);
891 typedef gboolean (*MonoGetCachedClassInfo) (MonoClass *klass, MonoCachedClassInfo *res);
893 typedef gboolean (*MonoGetClassFromName) (MonoImage *image, const char *name_space, const char *name, MonoClass **res);
895 static inline gboolean
896 method_is_dynamic (MonoMethod *method)
898 #ifdef DISABLE_REFLECTION_EMIT
901 return method->dynamic;
906 mono_classes_init (void);
909 mono_classes_cleanup (void);
912 mono_class_layout_fields (MonoClass *klass);
915 mono_class_setup_interface_offsets (MonoClass *klass);
918 mono_class_setup_vtable_general (MonoClass *klass, MonoMethod **overrides, int onum, GList *in_setup);
921 mono_class_setup_vtable (MonoClass *klass);
924 mono_class_setup_methods (MonoClass *klass);
927 mono_class_setup_mono_type (MonoClass *klass);
930 mono_class_setup_parent (MonoClass *klass, MonoClass *parent);
933 mono_class_get_method_by_index (MonoClass *klass, int index);
936 mono_class_get_inflated_method (MonoClass *klass, MonoMethod *method);
939 mono_class_get_vtable_entry (MonoClass *klass, int offset);
942 mono_class_get_implemented_interfaces (MonoClass *klass, MonoError *error);
945 mono_class_get_vtable_size (MonoClass *klass);
948 mono_class_is_open_constructed_type (MonoType *t);
951 mono_class_get_overrides_full (MonoImage *image, guint32 type_token, MonoMethod ***overrides, gint32 *num_overrides,
952 MonoGenericContext *generic_context);
955 mono_class_get_cctor (MonoClass *klass);
958 mono_class_get_finalizer (MonoClass *klass);
961 mono_class_needs_cctor_run (MonoClass *klass, MonoMethod *caller);
964 mono_class_field_is_special_static (MonoClassField *field);
967 mono_class_field_get_special_static_type (MonoClassField *field);
970 mono_class_has_special_static_fields (MonoClass *klass);
973 mono_class_get_field_default_value (MonoClassField *field, MonoTypeEnum *def_type);
976 mono_class_get_property_default_value (MonoProperty *property, MonoTypeEnum *def_type);
979 mono_install_trampoline (MonoTrampoline func);
982 mono_install_jump_trampoline (MonoJumpTrampoline func);
985 mono_install_delegate_trampoline (MonoDelegateTrampoline func);
988 mono_lookup_dynamic_token (MonoImage *image, guint32 token, MonoGenericContext *context);
991 mono_lookup_dynamic_token_class (MonoImage *image, guint32 token, gboolean check_token, MonoClass **handle_class, MonoGenericContext *context);
994 mono_install_lookup_dynamic_token (MonoLookupDynamicToken func);
997 mono_runtime_create_jump_trampoline (MonoDomain *domain, MonoMethod *method, gboolean add_sync_wrapper);
1000 mono_runtime_create_delegate_trampoline (MonoClass *klass);
1003 mono_install_get_cached_class_info (MonoGetCachedClassInfo func);
1006 mono_install_get_class_from_name (MonoGetClassFromName func);
1009 mono_class_get_context (MonoClass *klass);
1011 MonoMethodSignature*
1012 mono_method_signature_checked (MonoMethod *m, MonoError *err);
1015 mono_method_get_context_general (MonoMethod *method, gboolean uninflated);
1018 mono_method_get_context (MonoMethod *method);
1020 /* Used by monodis, thus cannot be MONO_INTERNAL */
1021 MONO_API MonoGenericContainer*
1022 mono_method_get_generic_container (MonoMethod *method);
1025 mono_generic_class_get_context (MonoGenericClass *gclass);
1028 mono_generic_class_get_class (MonoGenericClass *gclass);
1031 mono_method_set_generic_container (MonoMethod *method, MonoGenericContainer* container);
1034 mono_class_inflate_generic_method_full (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context);
1037 mono_class_inflate_generic_method_full_checked (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context, MonoError *error);
1040 mono_class_inflate_generic_method_checked (MonoMethod *method, MonoGenericContext *context, MonoError *error);
1043 mono_method_inflated_lookup (MonoMethodInflated* method, gboolean cache);
1045 MONO_API MonoMethodSignature *
1046 mono_metadata_get_inflated_signature (MonoMethodSignature *sig, MonoGenericContext *context);
1049 mono_class_inflate_generic_type_with_mempool (MonoImage *image, MonoType *type, MonoGenericContext *context, MonoError *error);
1052 mono_class_inflate_generic_class (MonoClass *gklass, MonoGenericContext *context);
1055 mono_class_inflate_generic_type_checked (MonoType *type, MonoGenericContext *context, MonoError *error);
1058 mono_metadata_free_inflated_signature (MonoMethodSignature *sig);
1060 MonoMethodSignature*
1061 mono_inflate_generic_signature (MonoMethodSignature *sig, MonoGenericContext *context, MonoError *error);
1066 MonoClass *object_class;
1067 MonoClass *byte_class;
1068 MonoClass *void_class;
1069 MonoClass *boolean_class;
1070 MonoClass *sbyte_class;
1071 MonoClass *int16_class;
1072 MonoClass *uint16_class;
1073 MonoClass *int32_class;
1074 MonoClass *uint32_class;
1075 MonoClass *int_class;
1076 MonoClass *uint_class;
1077 MonoClass *int64_class;
1078 MonoClass *uint64_class;
1079 MonoClass *single_class;
1080 MonoClass *double_class;
1081 MonoClass *char_class;
1082 MonoClass *string_class;
1083 MonoClass *enum_class;
1084 MonoClass *array_class;
1085 MonoClass *delegate_class;
1086 MonoClass *multicastdelegate_class;
1087 MonoClass *asyncresult_class;
1088 MonoClass *manualresetevent_class;
1089 MonoClass *typehandle_class;
1090 MonoClass *fieldhandle_class;
1091 MonoClass *methodhandle_class;
1092 MonoClass *systemtype_class;
1093 MonoClass *monotype_class;
1094 MonoClass *exception_class;
1095 MonoClass *threadabortexception_class;
1096 MonoClass *thread_class;
1097 MonoClass *internal_thread_class;
1098 #ifndef DISABLE_REMOTING
1099 MonoClass *transparent_proxy_class;
1100 MonoClass *real_proxy_class;
1101 MonoClass *marshalbyrefobject_class;
1102 MonoClass *iremotingtypeinfo_class;
1104 MonoClass *mono_method_message_class;
1105 MonoClass *appdomain_class;
1106 MonoClass *field_info_class;
1107 MonoClass *method_info_class;
1108 MonoClass *stringbuilder_class;
1109 MonoClass *math_class;
1110 MonoClass *stack_frame_class;
1111 MonoClass *stack_trace_class;
1112 MonoClass *marshal_class;
1113 MonoClass *typed_reference_class;
1114 MonoClass *argumenthandle_class;
1115 MonoClass *monitor_class;
1116 MonoClass *runtimesecurityframe_class;
1117 MonoClass *executioncontext_class;
1118 MonoClass *internals_visible_class;
1119 MonoClass *generic_ilist_class;
1120 MonoClass *generic_nullable_class;
1121 MonoClass *safehandle_class;
1122 MonoClass *handleref_class;
1123 MonoClass *attribute_class;
1124 MonoClass *customattribute_data_class;
1125 MonoClass *critical_finalizer_object;
1126 MonoClass *generic_ireadonlylist_class;
1129 #ifdef DISABLE_REMOTING
1130 #define mono_class_is_transparent_proxy(klass) (FALSE)
1131 #define mono_class_is_real_proxy(klass) (FALSE)
1132 #define mono_object_is_transparent_proxy(object) (FALSE)
1135 mono_remote_class (MonoDomain *domain, MonoString *class_name, MonoClass *proxy_class);
1138 mono_install_remoting_trampoline (MonoRemotingTrampoline func);
1140 #define mono_class_is_transparent_proxy(klass) ((klass) == mono_defaults.transparent_proxy_class)
1141 #define mono_class_is_real_proxy(klass) ((klass) == mono_defaults.real_proxy_class)
1142 #define mono_object_is_transparent_proxy(object) (((MonoObject*)object)->vtable->klass == mono_defaults.transparent_proxy_class)
1146 #define GENERATE_GET_CLASS_WITH_CACHE_DECL(shortname) \
1147 MonoClass* mono_class_get_##shortname##_class (void);
1149 #define GENERATE_GET_CLASS_WITH_CACHE(shortname,namespace,name) \
1151 mono_class_get_##shortname##_class (void) \
1153 static MonoClass *tmp_class; \
1154 MonoClass *class = tmp_class; \
1156 class = mono_class_from_name (mono_defaults.corlib, #namespace, #name); \
1158 mono_memory_barrier (); \
1159 tmp_class = class; \
1164 #define GENERATE_STATIC_GET_CLASS_WITH_CACHE(shortname,namespace,name) \
1165 static GENERATE_GET_CLASS_WITH_CACHE (shortname,namespace,name)
1170 GENERATE_GET_CLASS_WITH_CACHE_DECL (interop_proxy)
1171 GENERATE_GET_CLASS_WITH_CACHE_DECL (idispatch)
1172 GENERATE_GET_CLASS_WITH_CACHE_DECL (iunknown)
1173 GENERATE_GET_CLASS_WITH_CACHE_DECL (com_object)
1174 GENERATE_GET_CLASS_WITH_CACHE_DECL (variant)
1178 extern MonoDefaults mono_defaults;
1181 mono_loader_init (void);
1184 mono_loader_cleanup (void);
1187 mono_loader_lock (void) MONO_LLVM_INTERNAL;
1190 mono_loader_unlock (void) MONO_LLVM_INTERNAL;
1193 mono_loader_lock_track_ownership (gboolean track);
1196 mono_loader_lock_is_owned_by_self (void);
1199 mono_loader_lock_if_inited (void);
1202 mono_loader_unlock_if_inited (void);
1205 mono_loader_set_error_assembly_load (const char *assembly_name, gboolean ref_only);
1208 mono_loader_set_error_type_load (const char *class_name, const char *assembly_name);
1211 mono_loader_set_error_method_load (const char *class_name, const char *member_name);
1214 mono_loader_set_error_field_load (MonoClass *klass, const char *member_name);
1216 mono_loader_set_error_bad_image (char *msg);
1219 mono_loader_error_prepare_exception (MonoLoaderError *error);
1222 mono_loader_get_last_error (void);
1225 mono_loader_clear_error (void);
1228 mono_reflection_init (void);
1231 mono_icall_init (void);
1234 mono_icall_cleanup (void);
1237 mono_method_get_wrapper_data (MonoMethod *method, guint32 id);
1240 mono_metadata_has_generic_params (MonoImage *image, guint32 token);
1242 MONO_API MonoGenericContainer *
1243 mono_metadata_load_generic_params (MonoImage *image, guint32 token,
1244 MonoGenericContainer *parent_container);
1247 mono_metadata_load_generic_param_constraints_checked (MonoImage *image, guint32 token,
1248 MonoGenericContainer *container, MonoError *error);
1250 MonoMethodSignature*
1251 mono_create_icall_signature (const char *sigstr);
1254 mono_register_jit_icall (gconstpointer func, const char *name, MonoMethodSignature *sig, gboolean is_save);
1257 mono_register_jit_icall_full (gconstpointer func, const char *name, MonoMethodSignature *sig, gboolean is_save, gboolean no_raise, const char *c_symbol);
1260 mono_register_jit_icall_wrapper (MonoJitICallInfo *info, gconstpointer wrapper);
1263 mono_find_jit_icall_by_name (const char *name) MONO_LLVM_INTERNAL;
1266 mono_find_jit_icall_by_addr (gconstpointer addr) MONO_LLVM_INTERNAL;
1269 mono_get_jit_icall_info (void);
1272 mono_lookup_jit_icall_symbol (const char *name);
1275 mono_class_set_failure (MonoClass *klass, guint32 ex_type, void *ex_data);
1278 mono_class_get_exception_data (MonoClass *klass);
1281 mono_class_get_exception_for_failure (MonoClass *klass);
1284 mono_type_get_name_full (MonoType *type, MonoTypeNameFormat format);
1287 mono_type_get_full_name (MonoClass *klass);
1289 MonoArrayType *mono_dup_array_type (MonoImage *image, MonoArrayType *a);
1290 MonoMethodSignature *mono_metadata_signature_deep_dup (MonoImage *image, MonoMethodSignature *sig);
1293 mono_image_init_name_cache (MonoImage *image);
1295 gboolean mono_class_is_nullable (MonoClass *klass);
1296 MonoClass *mono_class_get_nullable_param (MonoClass *klass);
1298 /* object debugging functions, for use inside gdb */
1299 MONO_API void mono_object_describe (MonoObject *obj);
1300 MONO_API void mono_object_describe_fields (MonoObject *obj);
1301 MONO_API void mono_value_describe_fields (MonoClass* klass, const char* addr);
1302 MONO_API void mono_class_describe_statics (MonoClass* klass);
1304 /*Enum validation related functions*/
1306 mono_type_is_valid_enum_basetype (MonoType * type);
1309 mono_class_is_valid_enum (MonoClass *klass);
1312 mono_type_get_checked (MonoImage *image, guint32 type_token, MonoGenericContext *context, MonoError *error);
1315 mono_generic_class_is_generic_type_definition (MonoGenericClass *gklass);
1318 mono_class_get_method_generic (MonoClass *klass, MonoMethod *method);
1321 mono_type_get_basic_type_from_generic (MonoType *type);
1324 mono_method_can_access_method_full (MonoMethod *method, MonoMethod *called, MonoClass *context_klass);
1327 mono_method_can_access_field_full (MonoMethod *method, MonoClassField *field, MonoClass *context_klass);
1330 mono_class_can_access_class (MonoClass *access_class, MonoClass *target_class);
1333 mono_class_get_generic_type_definition (MonoClass *klass);
1336 mono_class_has_parent_and_ignore_generics (MonoClass *klass, MonoClass *parent);
1339 mono_method_get_vtable_slot (MonoMethod *method);
1342 mono_method_get_vtable_index (MonoMethod *method);
1345 mono_method_search_in_array_class (MonoClass *klass, const char *name, MonoMethodSignature *sig);
1348 mono_class_setup_interface_id (MonoClass *klass);
1350 MonoGenericContainer*
1351 mono_class_get_generic_container (MonoClass *klass);
1354 mono_class_get_generic_class (MonoClass *klass);
1357 mono_class_alloc_ext (MonoClass *klass);
1360 mono_class_setup_interfaces (MonoClass *klass, MonoError *error);
1363 mono_class_get_field_from_name_full (MonoClass *klass, const char *name, MonoType *type);
1366 mono_class_vtable_full (MonoDomain *domain, MonoClass *klass, gboolean raise_on_error);
1369 mono_class_is_assignable_from_slow (MonoClass *target, MonoClass *candidate);
1372 mono_class_has_variant_generic_params (MonoClass *klass);
1375 mono_class_is_variant_compatible (MonoClass *klass, MonoClass *oklass, gboolean check_for_reference_conv);
1377 gboolean mono_is_corlib_image (MonoImage *image);
1380 mono_field_get_type_checked (MonoClassField *field, MonoError *error);
1383 mono_class_get_fields_lazy (MonoClass* klass, gpointer *iter);
1386 mono_class_check_vtable_constraints (MonoClass *klass, GList *in_setup);
1389 mono_class_has_finalizer (MonoClass *klass);
1392 mono_unload_interface_id (MonoClass *klass);
1395 mono_class_get_methods_by_name (MonoClass *klass, const char *name, guint32 bflags, gboolean ignore_case, gboolean allow_ctors, MonoException **ex);
1398 mono_class_full_name (MonoClass *klass);
1401 mono_class_inflate_generic_class_checked (MonoClass *gklass, MonoGenericContext *context, MonoError *error);
1404 mono_class_get_checked (MonoImage *image, guint32 type_token, MonoError *error);
1407 mono_class_get_and_inflate_typespec_checked (MonoImage *image, guint32 type_token, MonoGenericContext *context, MonoError *error);
1410 mono_class_from_name_case_checked (MonoImage *image, const char* name_space, const char *name, MonoError *error);
1413 mono_field_from_token_checked (MonoImage *image, uint32_t token, MonoClass **retklass, MonoGenericContext *context, MonoError *error);
1416 mono_ldtoken_checked (MonoImage *image, guint32 token, MonoClass **handle_class, MonoGenericContext *context, MonoError *error);
1418 #endif /* __MONO_METADATA_CLASS_INTERBALS_H__ */