2010-04-02 Jb Evain <jbevain@novell.com>
[mono-project.git] / mono / metadata / class-internals.h
blobb6e0197afdd6262635d95833356d779762c40b4a
1 #ifndef __MONO_METADATA_CLASS_INTERBALS_H__
2 #define __MONO_METADATA_CLASS_INTERBALS_H__
4 #include <mono/metadata/class.h>
5 #include <mono/metadata/object.h>
6 #include <mono/metadata/mempool.h>
7 #include <mono/metadata/metadata-internals.h>
8 #include <mono/io-layer/io-layer.h>
9 #include "mono/utils/mono-compiler.h"
10 #include "mono/utils/mono-error.h"
12 #define MONO_CLASS_IS_ARRAY(c) ((c)->rank)
14 #define MONO_CLASS_HAS_STATIC_METADATA(klass) ((klass)->type_token && !(klass)->image->dynamic && !(klass)->generic_class)
16 #define MONO_DEFAULT_SUPERTABLE_SIZE 6
18 extern gboolean mono_print_vtable;
20 typedef void (*MonoStackWalkImpl) (MonoStackWalk func, gboolean do_il_offset, gpointer user_data);
22 typedef struct _MonoMethodWrapper MonoMethodWrapper;
23 typedef struct _MonoMethodInflated MonoMethodInflated;
24 typedef struct _MonoMethodPInvoke MonoMethodPInvoke;
26 /* Properties that applies to a group of structs should better use a higher number
27 * to avoid colision with type specific properties.
29 * This prop applies to class, method, property, event, assembly and image.
31 #define MONO_PROP_DYNAMIC_CATTR 0x1000
33 typedef enum {
34 #define WRAPPER(e,n) MONO_WRAPPER_ ## e,
35 #include "wrapper-types.h"
36 #undef WRAPPER
37 MONO_WRAPPER_NUM
38 } MonoWrapperType;
40 typedef enum {
41 MONO_TYPE_NAME_FORMAT_IL,
42 MONO_TYPE_NAME_FORMAT_REFLECTION,
43 MONO_TYPE_NAME_FORMAT_FULL_NAME,
44 MONO_TYPE_NAME_FORMAT_ASSEMBLY_QUALIFIED
45 } MonoTypeNameFormat;
47 typedef enum {
48 MONO_REMOTING_TARGET_UNKNOWN,
49 MONO_REMOTING_TARGET_APPDOMAIN,
50 MONO_REMOTING_TARGET_COMINTEROP
51 } MonoRemotingTarget;
53 #define MONO_METHOD_PROP_GENERIC_CONTAINER 0
55 struct _MonoMethod {
56 guint16 flags; /* method flags */
57 guint16 iflags; /* method implementation flags */
58 guint32 token;
59 MonoClass *klass;
60 MonoMethodSignature *signature;
61 /* name is useful mostly for debugging */
62 const char *name;
63 /* this is used by the inlining algorithm */
64 unsigned int inline_info:1;
65 unsigned int inline_failure:1;
66 unsigned int wrapper_type:5;
67 unsigned int string_ctor:1;
68 unsigned int save_lmf:1;
69 unsigned int dynamic:1; /* created & destroyed during runtime */
70 unsigned int sre_method:1; /* created at runtime using Reflection.Emit */
71 unsigned int is_generic:1; /* whenever this is a generic method definition */
72 unsigned int is_inflated:1; /* whether we're a MonoMethodInflated */
73 unsigned int skip_visibility:1; /* whenever to skip JIT visibility checks */
74 unsigned int verification_success:1; /* whether this method has been verified successfully.*/
75 /* TODO we MUST get rid of this field, it's an ugly hack nobody is proud of. */
76 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 */
77 signed int slot : 16;
80 * If is_generic is TRUE, the generic_container is stored in image->property_hash,
81 * using the key MONO_METHOD_PROP_GENERIC_CONTAINER.
85 struct _MonoMethodWrapper {
86 MonoMethod method;
87 MonoMethodHeader *header;
88 void *method_data;
91 struct _MonoMethodPInvoke {
92 MonoMethod method;
93 gpointer addr;
94 /* add marshal info */
95 guint16 piflags; /* pinvoke flags */
96 guint16 implmap_idx; /* index into IMPLMAP */
99 /*
100 * Stores the default value / RVA of fields.
101 * This information is rarely needed, so it is stored separately from
102 * MonoClassField.
104 typedef struct MonoFieldDefaultValue {
106 * If the field is constant, pointer to the metadata constant
107 * value.
108 * If the field has an RVA flag, pointer to the data.
109 * Else, invalid.
111 const char *data;
113 /* If the field is constant, the type of the constant. */
114 MonoTypeEnum def_type;
115 } MonoFieldDefaultValue;
118 * MonoClassField is just a runtime representation of the metadata for
119 * field, it doesn't contain the data directly. Static fields are
120 * stored in MonoVTable->data. Instance fields are allocated in the
121 * objects after the object header.
123 struct _MonoClassField {
124 /* Type of the field */
125 MonoType *type;
127 const char *name;
129 /* Type where the field was defined */
130 MonoClass *parent;
133 * Offset where this field is stored; if it is an instance
134 * field, it's the offset from the start of the object, if
135 * it's static, it's from the start of the memory chunk
136 * allocated for statics for the class.
137 * For special static fields, this is set to -1 during vtable construction.
139 int offset;
142 /* a field is ignored if it's named "_Deleted" and it has the specialname and rtspecialname flags set */
143 #define mono_field_is_deleted(field) (((field)->type->attrs & (FIELD_ATTRIBUTE_SPECIAL_NAME | FIELD_ATTRIBUTE_RT_SPECIAL_NAME)) \
144 && (strcmp (mono_field_get_name (field), "_Deleted") == 0))
146 typedef struct {
147 MonoClassField *field;
148 guint32 offset;
149 MonoMarshalSpec *mspec;
150 } MonoMarshalField;
152 typedef struct {
153 guint32 native_size, min_align;
154 guint32 num_fields;
155 MonoMethod *ptr_to_str;
156 MonoMethod *str_to_ptr;
157 MonoMarshalField fields [MONO_ZERO_LEN_ARRAY];
158 } MonoMarshalType;
160 #define MONO_SIZEOF_MARSHAL_TYPE (offsetof (MonoMarshalType, fields))
162 struct _MonoProperty {
163 MonoClass *parent;
164 const char *name;
165 MonoMethod *get;
166 MonoMethod *set;
167 guint32 attrs;
170 struct _MonoEvent {
171 MonoClass *parent;
172 const char *name;
173 MonoMethod *add;
174 MonoMethod *remove;
175 MonoMethod *raise;
176 #ifndef MONO_SMALL_CONFIG
177 MonoMethod **other;
178 #endif
179 guint32 attrs;
182 /* type of exception being "on hold" for later processing (see exception_type) */
183 enum {
184 MONO_EXCEPTION_NONE = 0,
185 MONO_EXCEPTION_SECURITY_LINKDEMAND = 1,
186 MONO_EXCEPTION_SECURITY_INHERITANCEDEMAND = 2,
187 MONO_EXCEPTION_INVALID_PROGRAM = 3,
188 MONO_EXCEPTION_UNVERIFIABLE_IL = 4,
189 MONO_EXCEPTION_MISSING_METHOD = 5,
190 MONO_EXCEPTION_MISSING_FIELD = 6,
191 MONO_EXCEPTION_TYPE_LOAD = 7,
192 MONO_EXCEPTION_FILE_NOT_FOUND = 8,
193 MONO_EXCEPTION_METHOD_ACCESS = 9,
194 MONO_EXCEPTION_FIELD_ACCESS = 10,
195 MONO_EXCEPTION_GENERIC_SHARING_FAILED = 11,
196 MONO_EXCEPTION_BAD_IMAGE = 12,
197 MONO_EXCEPTION_OBJECT_SUPPLIED = 13 /*The exception object is already created.*/
198 /* add other exception type */
201 /* This struct collects the info needed for the runtime use of a class,
202 * like the vtables for a domain, the GC descriptor, etc.
204 typedef struct {
205 guint16 max_domain;
206 /* domain_vtables is indexed by the domain id and the size is max_domain + 1 */
207 MonoVTable *domain_vtables [MONO_ZERO_LEN_ARRAY];
208 } MonoClassRuntimeInfo;
210 #define MONO_SIZEOF_CLASS_RUNTIME_INFO (sizeof (MonoClassRuntimeInfo) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
212 enum {
213 MONO_RGCTX_INFO_STATIC_DATA,
214 MONO_RGCTX_INFO_KLASS,
215 MONO_RGCTX_INFO_VTABLE,
216 MONO_RGCTX_INFO_TYPE,
217 MONO_RGCTX_INFO_REFLECTION_TYPE,
218 MONO_RGCTX_INFO_METHOD,
219 MONO_RGCTX_INFO_GENERIC_METHOD_CODE,
220 MONO_RGCTX_INFO_CLASS_FIELD,
221 MONO_RGCTX_INFO_METHOD_RGCTX,
222 MONO_RGCTX_INFO_METHOD_CONTEXT,
223 MONO_RGCTX_INFO_REMOTING_INVOKE_WITH_CHECK,
224 MONO_RGCTX_INFO_METHOD_DELEGATE_CODE
227 typedef struct _MonoRuntimeGenericContextOtherInfoTemplate {
228 int info_type;
229 gpointer data;
230 struct _MonoRuntimeGenericContextOtherInfoTemplate *next;
231 } MonoRuntimeGenericContextOtherInfoTemplate;
233 typedef struct {
234 MonoClass *next_subclass;
235 MonoRuntimeGenericContextOtherInfoTemplate *other_infos;
236 GSList *method_templates;
237 } MonoRuntimeGenericContextTemplate;
239 typedef struct {
240 MonoVTable *class_vtable; /* must be the first element */
241 MonoGenericInst *method_inst;
242 gpointer infos [MONO_ZERO_LEN_ARRAY];
243 } MonoMethodRuntimeGenericContext;
245 #define MONO_SIZEOF_METHOD_RUNTIME_GENERIC_CONTEXT (sizeof (MonoMethodRuntimeGenericContext) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
247 #define MONO_RGCTX_SLOT_MAKE_RGCTX(i) (i)
248 #define MONO_RGCTX_SLOT_MAKE_MRGCTX(i) ((i) | 0x80000000)
249 #define MONO_RGCTX_SLOT_INDEX(s) ((s) & 0x7fffffff)
250 #define MONO_RGCTX_SLOT_IS_MRGCTX(s) (((s) & 0x80000000) ? TRUE : FALSE)
253 #define MONO_CLASS_PROP_EXCEPTION_DATA 0
256 * This structure contains the rarely used fields of MonoClass
257 * Since using just one field causes the whole structure to be allocated, it should
258 * be used for fields which are only used in like 5% of all classes.
260 typedef struct {
261 struct {
262 #if MONO_SMALL_CONFIG
263 guint16 first, count;
264 #else
265 guint32 first, count;
266 #endif
267 } property, event;
269 /* Initialized by a call to mono_class_setup_properties () */
270 MonoProperty *properties;
272 /* Initialized by a call to mono_class_setup_events () */
273 MonoEvent *events;
275 guint32 declsec_flags; /* declarative security attributes flags */
277 /* Default values/RVA for fields */
278 /* Accessed using mono_class_get_field_default_value () / mono_field_get_data () */
279 MonoFieldDefaultValue *field_def_values;
281 GList *nested_classes;
282 } MonoClassExt;
284 struct _MonoClass {
285 /* element class for arrays and enum basetype for enums */
286 MonoClass *element_class;
287 /* used for subtype checks */
288 MonoClass *cast_class;
290 /* for fast subtype checks */
291 MonoClass **supertypes;
292 guint16 idepth;
294 /* array dimension */
295 guint8 rank;
297 int instance_size; /* object instance size */
299 guint inited : 1;
300 /* We use init_pending to detect cyclic calls to mono_class_init */
301 guint init_pending : 1;
303 /* A class contains static and non static data. Static data can be
304 * of the same type as the class itselfs, but it does not influence
305 * the instance size of the class. To avoid cyclic calls to
306 * mono_class_init (from mono_class_instance_size ()) we first
307 * initialise all non static fields. After that we set size_inited
308 * to 1, because we know the instance size now. After that we
309 * initialise all static fields.
311 guint size_inited : 1;
312 guint valuetype : 1; /* derives from System.ValueType */
313 guint enumtype : 1; /* derives from System.Enum */
314 guint blittable : 1; /* class is blittable */
315 guint unicode : 1; /* class uses unicode char when marshalled */
316 guint wastypebuilder : 1; /* class was created at runtime from a TypeBuilder */
317 /* next byte */
318 guint8 min_align;
319 /* next byte */
320 guint packing_size : 4;
321 /* still 4 bits free */
322 /* next byte */
323 guint ghcimpl : 1; /* class has its own GetHashCode impl */
324 guint has_finalize : 1; /* class has its own Finalize impl */
325 guint marshalbyref : 1; /* class is a MarshalByRefObject */
326 guint contextbound : 1; /* class is a ContextBoundObject */
327 guint delegate : 1; /* class is a Delegate */
328 guint gc_descr_inited : 1; /* gc_descr is initialized */
329 guint has_cctor : 1; /* class has a cctor */
330 guint has_references : 1; /* it has GC-tracked references in the instance */
331 /* next byte */
332 guint has_static_refs : 1; /* it has static fields that are GC-tracked */
333 guint no_special_static_fields : 1; /* has no thread/context static fields */
334 /* directly or indirectly derives from ComImport attributed class.
335 * this means we need to create a proxy for instances of this class
336 * for COM Interop. set this flag on loading so all we need is a quick check
337 * during object creation rather than having to traverse supertypes
339 guint is_com_object : 1;
340 guint nested_classes_inited : 1; /* Whenever nested_class is initialized */
341 guint interfaces_inited : 1; /* interfaces is initialized */
342 guint simd_type : 1; /* class is a simd intrinsic type */
343 guint is_generic : 1; /* class is a generic type definition */
344 guint is_inflated : 1; /* class is a generic instance */
346 guint8 exception_type; /* MONO_EXCEPTION_* */
348 /* Additional information about the exception */
349 /* Stored as property MONO_CLASS_PROP_EXCEPTION_DATA */
350 //void *exception_data;
352 MonoClass *parent;
353 MonoClass *nested_in;
355 MonoImage *image;
356 const char *name;
357 const char *name_space;
359 guint32 type_token;
360 int vtable_size; /* number of slots */
362 guint16 interface_count;
363 guint16 interface_id; /* unique inderface id (for interfaces) */
364 guint16 max_interface_id;
366 guint16 interface_offsets_count;
367 MonoClass **interfaces_packed;
368 guint16 *interface_offsets_packed;
369 /* enabled only with small config for now: we might want to do it unconditionally */
370 #ifdef MONO_SMALL_CONFIG
371 #define COMPRESSED_INTERFACE_BITMAP 1
372 #endif
373 guint8 *interface_bitmap;
375 MonoClass **interfaces;
377 union {
378 int class_size; /* size of area for static fields */
379 int element_size; /* for array types */
380 int generic_param_token; /* for generic param types, both var and mvar */
381 } sizes;
384 * From the TypeDef table
386 guint32 flags;
387 struct {
388 #if MONO_SMALL_CONFIG
389 guint16 first, count;
390 #else
391 guint32 first, count;
392 #endif
393 } field, method;
395 /* A GC handle pointing to the corresponding type builder/generic param builder */
396 guint32 ref_info_handle;
398 /* loaded on demand */
399 MonoMarshalType *marshal_info;
402 * Field information: Type and location from object base
404 MonoClassField *fields;
406 MonoMethod **methods;
408 /* used as the type of the this argument and when passing the arg by value */
409 MonoType this_arg;
410 MonoType byval_arg;
412 MonoGenericClass *generic_class;
413 MonoGenericContainer *generic_container;
415 void *gc_descr;
417 MonoClassRuntimeInfo *runtime_info;
419 /* next element in the class_cache hash list (in MonoImage) */
420 MonoClass *next_class_cache;
422 /* Generic vtable. Initialized by a call to mono_class_setup_vtable () */
423 MonoMethod **vtable;
425 /* Rarely used fields of classes */
426 MonoClassExt *ext;
429 #ifdef COMPRESSED_INTERFACE_BITMAP
430 int mono_compress_bitmap (uint8_t *dest, const uint8_t *bitmap, int size) MONO_INTERNAL;
431 int mono_class_interface_match (const uint8_t *bitmap, int id) MONO_INTERNAL;
432 #else
433 #define mono_class_interface_match(bmap,uiid) ((bmap) [(uiid) >> 3] & (1 << ((uiid)&7)))
434 #endif
436 #define MONO_CLASS_IMPLEMENTS_INTERFACE(k,uiid) (((uiid) <= (k)->max_interface_id) && mono_class_interface_match ((k)->interface_bitmap, (uiid)))
439 int mono_class_interface_offset (MonoClass *klass, MonoClass *itf);
440 int mono_class_interface_offset_with_variance (MonoClass *klass, MonoClass *itf, gboolean *non_exact_match) MONO_INTERNAL;
442 typedef gpointer MonoRuntimeGenericContext;
444 /* the interface_offsets array is stored in memory before this struct */
445 struct MonoVTable {
446 MonoClass *klass;
448 * According to comments in gc_gcj.h, this should be the second word in
449 * the vtable.
451 void *gc_descr;
452 MonoDomain *domain; /* each object/vtable belongs to exactly one domain */
453 gpointer data; /* to store static class data */
454 gpointer type; /* System.Type type for klass */
455 guint8 *interface_bitmap;
456 guint16 max_interface_id;
457 guint8 rank;
458 guint remote : 1; /* class is remotely activated */
459 guint initialized : 1; /* cctor has been run */
460 guint init_failed : 1; /* cctor execution failed */
461 guint32 imt_collisions_bitmap;
462 MonoRuntimeGenericContext *runtime_generic_context;
463 /* do not add any fields after vtable, the structure is dynamically extended */
464 gpointer vtable [MONO_ZERO_LEN_ARRAY];
467 #define MONO_SIZEOF_VTABLE (sizeof (MonoVTable) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
469 #define MONO_VTABLE_IMPLEMENTS_INTERFACE(vt,uiid) (((uiid) <= (vt)->max_interface_id) && mono_class_interface_match ((vt)->interface_bitmap, (uiid)))
472 * Generic instantiation data type encoding.
476 * A particular generic instantiation:
478 * All instantiations are cached and we don't distinguish between class and method
479 * instantiations here.
481 struct _MonoGenericInst {
482 #ifndef MONO_SMALL_CONFIG
483 guint id; /* unique ID for debugging */
484 #endif
485 guint type_argc : 22; /* number of type arguments */
486 guint is_open : 1; /* if this is an open type */
487 MonoType *type_argv [MONO_ZERO_LEN_ARRAY];
490 #define MONO_SIZEOF_GENERIC_INST (sizeof (MonoGenericInst) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
492 * The generic context: an instantiation of a set of class and method generic parameters.
494 * NOTE: Never allocate this directly on the heap. It have to be either allocated on the stack,
495 * or embedded within other objects. Don't store pointers to this, because it may be on the stack.
496 * If you really have to, ensure you store a pointer to the embedding object along with it.
498 struct _MonoGenericContext {
499 /* The instantiation corresponding to the class generic parameters */
500 MonoGenericInst *class_inst;
501 /* The instantiation corresponding to the method generic parameters */
502 MonoGenericInst *method_inst;
506 * Inflated generic method.
508 struct _MonoMethodInflated {
509 union {
510 MonoMethod method;
511 MonoMethodPInvoke pinvoke;
512 } method;
513 MonoMethodHeader *header;
514 MonoMethod *declaring; /* the generic method definition. */
515 MonoGenericContext context; /* The current instantiation */
519 * A particular instantiation of a generic type.
521 struct _MonoGenericClass {
522 MonoClass *container_class; /* the generic type definition */
523 MonoGenericContext context; /* a context that contains the type instantiation doesn't contain any method instantiation */
524 guint is_dynamic : 1; /* We're a MonoDynamicGenericClass */
525 guint is_tb_open : 1; /* This is the fully open instantiation for a type_builder. Quite ugly, but it's temporary.*/
526 MonoClass *cached_class; /* if present, the MonoClass corresponding to the instantiation. */
530 * This is used when instantiating a generic type definition which is
531 * a TypeBuilder.
533 struct _MonoDynamicGenericClass {
534 MonoGenericClass generic_class;
535 int count_methods;
536 MonoMethod **methods;
537 int count_ctors;
538 MonoMethod **ctors;
539 int count_fields;
540 MonoClassField *fields;
541 guint initialized;
542 /* The non-inflated types of the fields */
543 MonoType **field_generic_types;
544 /* The managed objects representing the fields */
545 MonoObject **field_objects;
549 * A type parameter.
551 struct _MonoGenericParam {
552 MonoGenericContainer *owner; /* Type or method this parameter was defined in. */
553 guint16 num;
555 * If owner is NULL, or owner is 'owned' by this gparam,
556 * then this is the image whose mempool this struct was allocated from.
557 * The second case happens for gparams created in
558 * mono_reflection_initialize_generic_parameter ().
560 MonoImage *image;
563 /* Additional details about a MonoGenericParam */
564 typedef struct {
565 MonoClass *pklass; /* The corresponding `MonoClass'. */
566 const char *name;
567 guint16 flags;
568 guint32 token;
569 MonoClass** constraints; /* NULL means end of list */
570 } MonoGenericParamInfo;
572 typedef struct {
573 MonoGenericParam param;
574 MonoGenericParamInfo info;
575 } MonoGenericParamFull;
578 * The generic container.
580 * Stores the type parameters of a generic type definition or a generic method definition.
582 struct _MonoGenericContainer {
583 MonoGenericContext context;
584 /* If we're a generic method definition in a generic type definition,
585 the generic container of the containing class. */
586 MonoGenericContainer *parent;
587 /* the generic type definition or the generic method definition corresponding to this container */
588 union {
589 MonoClass *klass;
590 MonoMethod *method;
591 } owner;
592 int type_argc : 31;
593 /* If true, we're a generic method, otherwise a generic type definition. */
594 /* Invariant: parent != NULL => is_method */
595 int is_method : 1;
596 /* Our type parameters. */
597 MonoGenericParamFull *type_params;
600 * For owner-less containers created by SRE, the image the container was
601 * allocated from.
603 MonoImage *image;
606 #define mono_generic_container_get_param(gc, i) ((MonoGenericParam *) ((gc)->type_params + (i)))
607 #define mono_generic_container_get_param_info(gc, i) (&((gc)->type_params + (i))->info)
609 #define mono_generic_param_owner(p) ((p)->owner)
610 #define mono_generic_param_num(p) ((p)->num)
611 #define mono_generic_param_info(p) (mono_generic_param_owner (p) ? &((MonoGenericParamFull *) p)->info : NULL)
612 #define mono_type_get_generic_param_owner(t) (mono_generic_param_owner ((t)->data.generic_param))
613 #define mono_type_get_generic_param_num(t) (mono_generic_param_num ((t)->data.generic_param))
616 * Class information which might be cached by the runtime in the AOT file for
617 * example. Caching this allows us to avoid computing a generic vtable
618 * (class->vtable) in most cases, saving time and avoiding creation of lots of
619 * MonoMethod structures.
621 typedef struct MonoCachedClassInfo {
622 guint32 vtable_size;
623 guint has_finalize : 1;
624 guint ghcimpl : 1;
625 guint has_cctor : 1;
626 guint has_nested_classes : 1;
627 guint blittable : 1;
628 guint has_references : 1;
629 guint has_static_refs : 1;
630 guint no_special_static_fields : 1;
631 guint is_generic_container : 1;
632 guint32 cctor_token;
633 MonoImage *finalize_image;
634 guint32 finalize_token;
635 guint32 instance_size;
636 guint32 class_size;
637 guint32 packing_size;
638 guint32 min_align;
639 } MonoCachedClassInfo;
641 typedef struct {
642 const char *name;
643 gconstpointer func;
644 gconstpointer wrapper;
645 gconstpointer trampoline;
646 MonoMethodSignature *sig;
647 } MonoJitICallInfo;
649 typedef struct {
650 guint8 exception_type;
651 char *class_name; /* If kind == TYPE */
652 char *assembly_name; /* If kind == TYPE or ASSEMBLY */
653 MonoClass *klass; /* If kind != TYPE */
654 const char *member_name; /* If kind != TYPE */
655 gboolean ref_only; /* If kind == ASSEMBLY */
656 char *msg; /* If kind == BAD_IMAGE */
657 } MonoLoaderError;
659 #define mono_class_has_parent(klass,parent) (((klass)->idepth >= (parent)->idepth) && ((klass)->supertypes [(parent)->idepth - 1] == (parent)))
661 typedef struct {
662 MonoVTable *default_vtable;
663 MonoVTable *xdomain_vtable;
664 MonoClass *proxy_class;
665 char* proxy_class_name;
666 uint32_t interface_count;
667 MonoClass *interfaces [MONO_ZERO_LEN_ARRAY];
668 } MonoRemoteClass;
670 #define MONO_SIZEOF_REMOTE_CLASS (sizeof (MonoRemoteClass) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
672 MonoRemoteClass*
673 mono_remote_class (MonoDomain *domain, MonoString *class_name, MonoClass *proxy_class) MONO_INTERNAL;
675 typedef struct {
676 gulong new_object_count;
677 gulong initialized_class_count;
678 gulong generic_vtable_count;
679 gulong used_class_count;
680 gulong method_count;
681 gulong class_vtable_size;
682 gulong class_static_data_size;
683 gulong generic_instance_count;
684 gulong generic_class_count;
685 gulong inflated_method_count;
686 gulong inflated_method_count_2;
687 gulong inflated_type_count;
688 gulong generics_metadata_size;
689 gulong dynamic_code_alloc_count;
690 gulong dynamic_code_bytes_count;
691 gulong dynamic_code_frees_count;
692 gulong delegate_creations;
693 gulong imt_tables_size;
694 gulong imt_number_of_tables;
695 gulong imt_number_of_methods;
696 gulong imt_used_slots;
697 gulong imt_slots_with_collisions;
698 gulong imt_max_collisions_in_slot;
699 gulong imt_method_count_when_max_collisions;
700 gulong imt_thunks_size;
701 gulong jit_info_table_insert_count;
702 gulong jit_info_table_remove_count;
703 gulong jit_info_table_lookup_count;
704 gulong hazardous_pointer_count;
705 gulong generics_sharable_methods;
706 gulong generics_unsharable_methods;
707 gulong generics_shared_methods;
708 gulong minor_gc_count;
709 gulong major_gc_count;
710 gulong minor_gc_time_usecs;
711 gulong major_gc_time_usecs;
712 gboolean enabled;
713 } MonoStats;
716 * new structure to hold performace counters values that are exported
717 * to managed code.
718 * Note: never remove fields from this structure and only add them to the end.
719 * Size of fields and type should not be changed as well.
721 typedef struct {
722 /* JIT category */
723 guint32 jit_methods;
724 guint32 jit_bytes;
725 guint32 jit_time;
726 guint32 jit_failures;
727 /* Exceptions category */
728 guint32 exceptions_thrown;
729 guint32 exceptions_filters;
730 guint32 exceptions_finallys;
731 guint32 exceptions_depth;
732 guint32 aspnet_requests_queued;
733 guint32 aspnet_requests;
734 /* Memory category */
735 guint32 gc_collections0;
736 guint32 gc_collections1;
737 guint32 gc_collections2;
738 guint32 gc_promotions0;
739 guint32 gc_promotions1;
740 guint32 gc_promotion_finalizers;
741 guint32 gc_gen0size;
742 guint32 gc_gen1size;
743 guint32 gc_gen2size;
744 guint32 gc_lossize;
745 guint32 gc_fin_survivors;
746 guint32 gc_num_handles;
747 guint32 gc_allocated;
748 guint32 gc_induced;
749 guint32 gc_time;
750 guint32 gc_total_bytes;
751 guint32 gc_committed_bytes;
752 guint32 gc_reserved_bytes;
753 guint32 gc_num_pinned;
754 guint32 gc_sync_blocks;
755 /* Remoting category */
756 guint32 remoting_calls;
757 guint32 remoting_channels;
758 guint32 remoting_proxies;
759 guint32 remoting_classes;
760 guint32 remoting_objects;
761 guint32 remoting_contexts;
762 /* Loader category */
763 guint32 loader_classes;
764 guint32 loader_total_classes;
765 guint32 loader_appdomains;
766 guint32 loader_total_appdomains;
767 guint32 loader_assemblies;
768 guint32 loader_total_assemblies;
769 guint32 loader_failures;
770 guint32 loader_bytes;
771 guint32 loader_appdomains_uloaded;
772 /* Threads and Locks category */
773 guint32 thread_contentions;
774 guint32 thread_queue_len;
775 guint32 thread_queue_max;
776 guint32 thread_num_logical;
777 guint32 thread_num_physical;
778 guint32 thread_cur_recognized;
779 guint32 thread_num_recognized;
780 /* Interop category */
781 guint32 interop_num_ccw;
782 guint32 interop_num_stubs;
783 guint32 interop_num_marshals;
784 /* Security category */
785 guint32 security_num_checks;
786 guint32 security_num_link_checks;
787 guint32 security_time;
788 guint32 security_depth;
789 guint32 unused;
790 /* Threadpool */
791 guint64 threadpool_workitems;
792 guint64 threadpool_ioworkitems;
793 guint threadpool_threads;
794 guint threadpool_iothreads;
795 } MonoPerfCounters;
797 extern MonoPerfCounters *mono_perfcounters MONO_INTERNAL;
799 void mono_perfcounters_init (void);
802 * The definition of the first field in SafeHandle,
803 * Keep in sync with SafeHandle.cs, this is only used
804 * to access the `handle' parameter.
806 typedef struct {
807 MonoObject base;
808 void *handle;
809 } MonoSafeHandle;
812 * Keep in sync with HandleRef.cs
814 typedef struct {
815 MonoObject *wrapper;
816 void *handle;
817 } MonoHandleRef;
819 enum {
820 MONO_GENERIC_SHARING_NONE,
821 MONO_GENERIC_SHARING_COLLECTIONS,
822 MONO_GENERIC_SHARING_CORLIB,
823 MONO_GENERIC_SHARING_ALL
827 * Flags for which contexts were used in inflating a generic.
829 enum {
830 MONO_GENERIC_CONTEXT_USED_CLASS = 1,
831 MONO_GENERIC_CONTEXT_USED_METHOD = 2
834 #define MONO_GENERIC_CONTEXT_USED_BOTH (MONO_GENERIC_CONTEXT_USED_CLASS | MONO_GENERIC_CONTEXT_USED_METHOD)
836 extern MonoStats mono_stats MONO_INTERNAL;
838 typedef gpointer (*MonoTrampoline) (MonoMethod *method);
839 typedef gpointer (*MonoJumpTrampoline) (MonoDomain *domain, MonoMethod *method, gboolean add_sync_wrapper);
840 typedef gpointer (*MonoRemotingTrampoline) (MonoDomain *domain, MonoMethod *method, MonoRemotingTarget target);
841 typedef gpointer (*MonoDelegateTrampoline) (MonoClass *klass);
843 typedef gpointer (*MonoLookupDynamicToken) (MonoImage *image, guint32 token, gboolean valid_token, MonoClass **handle_class, MonoGenericContext *context);
845 typedef gboolean (*MonoGetCachedClassInfo) (MonoClass *klass, MonoCachedClassInfo *res);
847 typedef gboolean (*MonoGetClassFromName) (MonoImage *image, const char *name_space, const char *name, MonoClass **res);
849 void
850 mono_classes_init (void) MONO_INTERNAL;
852 void
853 mono_classes_cleanup (void) MONO_INTERNAL;
855 void
856 mono_class_layout_fields (MonoClass *klass) MONO_INTERNAL;
858 void
859 mono_class_setup_interface_offsets (MonoClass *klass) MONO_INTERNAL;
861 void
862 mono_class_setup_vtable_general (MonoClass *klass, MonoMethod **overrides, int onum) MONO_INTERNAL;
864 void
865 mono_class_setup_vtable (MonoClass *klass) MONO_INTERNAL;
867 void
868 mono_class_setup_methods (MonoClass *klass) MONO_INTERNAL;
870 void
871 mono_class_setup_mono_type (MonoClass *klass) MONO_INTERNAL;
873 void
874 mono_class_setup_parent (MonoClass *klass, MonoClass *parent) MONO_INTERNAL;
876 void
877 mono_class_setup_supertypes (MonoClass *klass) MONO_INTERNAL;
879 MonoMethod*
880 mono_class_get_method_by_index (MonoClass *class, int index) MONO_INTERNAL;
882 MonoMethod*
883 mono_class_get_inflated_method (MonoClass *class, MonoMethod *method) MONO_INTERNAL;
885 MonoMethod*
886 mono_class_get_vtable_entry (MonoClass *class, int offset) MONO_INTERNAL;
888 GPtrArray*
889 mono_class_get_implemented_interfaces (MonoClass *klass, MonoError *error) MONO_INTERNAL;
892 mono_class_get_vtable_size (MonoClass *klass) MONO_INTERNAL;
894 gboolean
895 mono_class_is_open_constructed_type (MonoType *t) MONO_INTERNAL;
897 gboolean
898 mono_class_get_overrides_full (MonoImage *image, guint32 type_token, MonoMethod ***overrides, gint32 *num_overrides,
899 MonoGenericContext *generic_context) MONO_INTERNAL;
901 MonoMethod*
902 mono_class_get_cctor (MonoClass *klass) MONO_INTERNAL;
904 MonoMethod*
905 mono_class_get_finalizer (MonoClass *klass) MONO_INTERNAL;
907 gboolean
908 mono_class_needs_cctor_run (MonoClass *klass, MonoMethod *caller) MONO_INTERNAL;
910 gboolean
911 mono_class_field_is_special_static (MonoClassField *field) MONO_INTERNAL;
913 gboolean
914 mono_class_has_special_static_fields (MonoClass *klass) MONO_INTERNAL;
916 const char*
917 mono_class_get_field_default_value (MonoClassField *field, MonoTypeEnum *def_type) MONO_INTERNAL;
919 const char*
920 mono_class_get_property_default_value (MonoProperty *property, MonoTypeEnum *def_type) MONO_INTERNAL;
922 void
923 mono_install_trampoline (MonoTrampoline func) MONO_INTERNAL;
925 void
926 mono_install_jump_trampoline (MonoJumpTrampoline func) MONO_INTERNAL;
928 void
929 mono_install_remoting_trampoline (MonoRemotingTrampoline func) MONO_INTERNAL;
931 void
932 mono_install_delegate_trampoline (MonoDelegateTrampoline func) MONO_INTERNAL;
934 gpointer
935 mono_lookup_dynamic_token (MonoImage *image, guint32 token, MonoGenericContext *context) MONO_INTERNAL;
937 gpointer
938 mono_lookup_dynamic_token_class (MonoImage *image, guint32 token, gboolean check_token, MonoClass **handle_class, MonoGenericContext *context) MONO_INTERNAL;
940 void
941 mono_install_lookup_dynamic_token (MonoLookupDynamicToken func) MONO_INTERNAL;
943 gpointer
944 mono_runtime_create_jump_trampoline (MonoDomain *domain, MonoMethod *method, gboolean add_sync_wrapper) MONO_INTERNAL;
946 gpointer
947 mono_runtime_create_delegate_trampoline (MonoClass *klass) MONO_INTERNAL;
949 void
950 mono_install_get_cached_class_info (MonoGetCachedClassInfo func) MONO_INTERNAL;
952 void
953 mono_install_get_class_from_name (MonoGetClassFromName func) MONO_INTERNAL;
955 MonoGenericContext*
956 mono_class_get_context (MonoClass *class) MONO_INTERNAL;
958 MonoMethodSignature*
959 mono_method_signature_checked (MonoMethod *m, MonoError *err) MONO_INTERNAL;
961 MonoGenericContext*
962 mono_method_get_context_general (MonoMethod *method, gboolean uninflated) MONO_INTERNAL;
964 MonoGenericContext*
965 mono_method_get_context (MonoMethod *method) MONO_INTERNAL;
967 /* Used by monodis, thus cannot be MONO_INTERNAL */
968 MonoGenericContainer*
969 mono_method_get_generic_container (MonoMethod *method);
971 MonoGenericContext*
972 mono_generic_class_get_context (MonoGenericClass *gclass) MONO_INTERNAL;
974 MonoClass*
975 mono_generic_class_get_class (MonoGenericClass *gclass) MONO_INTERNAL;
977 void
978 mono_method_set_generic_container (MonoMethod *method, MonoGenericContainer* container) MONO_INTERNAL;
980 MonoMethod*
981 mono_class_inflate_generic_method_full (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context) MONO_INTERNAL;
983 MonoMethod*
984 mono_class_inflate_generic_method_full_checked (MonoMethod *method, MonoClass *klass_hint, MonoGenericContext *context, MonoError *error) MONO_INTERNAL;
986 MonoMethodInflated*
987 mono_method_inflated_lookup (MonoMethodInflated* method, gboolean cache) MONO_INTERNAL;
989 MonoMethodSignature *
990 mono_metadata_get_inflated_signature (MonoMethodSignature *sig, MonoGenericContext *context);
992 MonoType*
993 mono_class_inflate_generic_type_with_mempool (MonoImage *image, MonoType *type, MonoGenericContext *context, MonoError *error) MONO_INTERNAL;
995 MonoClass*
996 mono_class_inflate_generic_class (MonoClass *gklass, MonoGenericContext *context) MONO_INTERNAL;
998 MonoType*
999 mono_class_inflate_generic_type_checked (MonoType *type, MonoGenericContext *context, MonoError *error) MONO_INTERNAL;
1001 void
1002 mono_metadata_free_inflated_signature (MonoMethodSignature *sig);
1004 typedef struct {
1005 MonoImage *corlib;
1006 MonoClass *object_class;
1007 MonoClass *byte_class;
1008 MonoClass *void_class;
1009 MonoClass *boolean_class;
1010 MonoClass *sbyte_class;
1011 MonoClass *int16_class;
1012 MonoClass *uint16_class;
1013 MonoClass *int32_class;
1014 MonoClass *uint32_class;
1015 MonoClass *int_class;
1016 MonoClass *uint_class;
1017 MonoClass *int64_class;
1018 MonoClass *uint64_class;
1019 MonoClass *single_class;
1020 MonoClass *double_class;
1021 MonoClass *char_class;
1022 MonoClass *string_class;
1023 MonoClass *enum_class;
1024 MonoClass *array_class;
1025 MonoClass *delegate_class;
1026 MonoClass *multicastdelegate_class;
1027 MonoClass *asyncresult_class;
1028 MonoClass *manualresetevent_class;
1029 MonoClass *typehandle_class;
1030 MonoClass *fieldhandle_class;
1031 MonoClass *methodhandle_class;
1032 MonoClass *systemtype_class;
1033 MonoClass *monotype_class;
1034 MonoClass *exception_class;
1035 MonoClass *threadabortexception_class;
1036 MonoClass *thread_class;
1037 MonoClass *internal_thread_class;
1038 MonoClass *transparent_proxy_class;
1039 MonoClass *real_proxy_class;
1040 MonoClass *mono_method_message_class;
1041 MonoClass *appdomain_class;
1042 MonoClass *field_info_class;
1043 MonoClass *method_info_class;
1044 MonoClass *stringbuilder_class;
1045 MonoClass *math_class;
1046 MonoClass *stack_frame_class;
1047 MonoClass *stack_trace_class;
1048 MonoClass *marshal_class;
1049 MonoClass *iserializeable_class;
1050 MonoClass *serializationinfo_class;
1051 MonoClass *streamingcontext_class;
1052 MonoClass *typed_reference_class;
1053 MonoClass *argumenthandle_class;
1054 MonoClass *marshalbyrefobject_class;
1055 MonoClass *monitor_class;
1056 MonoClass *iremotingtypeinfo_class;
1057 MonoClass *runtimesecurityframe_class;
1058 MonoClass *executioncontext_class;
1059 MonoClass *internals_visible_class;
1060 MonoClass *generic_ilist_class;
1061 MonoClass *generic_nullable_class;
1062 MonoClass *variant_class;
1063 MonoClass *com_object_class;
1064 MonoClass *com_interop_proxy_class;
1065 MonoClass *iunknown_class;
1066 MonoClass *idispatch_class;
1067 MonoClass *safehandle_class;
1068 MonoClass *handleref_class;
1069 MonoClass *attribute_class;
1070 MonoClass *customattribute_data_class;
1071 MonoClass *critical_finalizer_object;
1072 } MonoDefaults;
1074 extern MonoDefaults mono_defaults MONO_INTERNAL;
1076 void
1077 mono_loader_init (void) MONO_INTERNAL;
1079 void
1080 mono_loader_cleanup (void) MONO_INTERNAL;
1082 void
1083 mono_loader_lock (void) MONO_INTERNAL;
1085 void
1086 mono_loader_unlock (void) MONO_INTERNAL;
1088 void
1089 mono_loader_lock_track_ownership (gboolean track) MONO_INTERNAL;
1091 gboolean
1092 mono_loader_lock_is_owned_by_self (void) MONO_INTERNAL;
1094 void
1095 mono_loader_set_error_assembly_load (const char *assembly_name, gboolean ref_only) MONO_INTERNAL;
1097 void
1098 mono_loader_set_error_type_load (const char *class_name, const char *assembly_name) MONO_INTERNAL;
1100 void
1101 mono_loader_set_error_method_load (const char *class_name, const char *member_name) MONO_INTERNAL;
1103 void
1104 mono_loader_set_error_field_load (MonoClass *klass, const char *member_name) MONO_INTERNAL;
1105 void
1106 mono_loader_set_error_bad_image (char *msg) MONO_INTERNAL;
1108 MonoException *
1109 mono_loader_error_prepare_exception (MonoLoaderError *error) MONO_INTERNAL;
1111 MonoLoaderError *
1112 mono_loader_get_last_error (void) MONO_INTERNAL;
1114 void
1115 mono_loader_clear_error (void) MONO_INTERNAL;
1117 void
1118 mono_reflection_init (void) MONO_INTERNAL;
1120 void
1121 mono_icall_init (void) MONO_INTERNAL;
1123 void
1124 mono_icall_cleanup (void) MONO_INTERNAL;
1126 gpointer
1127 mono_method_get_wrapper_data (MonoMethod *method, guint32 id) MONO_INTERNAL;
1129 void
1130 mono_install_stack_walk (MonoStackWalkImpl func) MONO_INTERNAL;
1132 gboolean
1133 mono_metadata_has_generic_params (MonoImage *image, guint32 token) MONO_INTERNAL;
1135 MonoGenericContainer *
1136 mono_metadata_load_generic_params (MonoImage *image, guint32 token,
1137 MonoGenericContainer *parent_container);
1139 void
1140 mono_metadata_load_generic_param_constraints (MonoImage *image, guint32 token,
1141 MonoGenericContainer *container);
1143 gboolean
1144 mono_metadata_load_generic_param_constraints_full (MonoImage *image, guint32 token,
1145 MonoGenericContainer *container) MONO_INTERNAL;
1147 MonoMethodSignature*
1148 mono_create_icall_signature (const char *sigstr) MONO_INTERNAL;
1150 MonoJitICallInfo *
1151 mono_register_jit_icall (gconstpointer func, const char *name, MonoMethodSignature *sig, gboolean is_save) MONO_INTERNAL;
1153 void
1154 mono_register_jit_icall_wrapper (MonoJitICallInfo *info, gconstpointer wrapper) MONO_INTERNAL;
1156 MonoJitICallInfo *
1157 mono_find_jit_icall_by_name (const char *name) MONO_INTERNAL;
1159 MonoJitICallInfo *
1160 mono_find_jit_icall_by_addr (gconstpointer addr) MONO_INTERNAL;
1162 GHashTable*
1163 mono_get_jit_icall_info (void) MONO_INTERNAL;
1165 gboolean
1166 mono_class_set_failure (MonoClass *klass, guint32 ex_type, void *ex_data) MONO_INTERNAL;
1168 gpointer
1169 mono_class_get_exception_data (MonoClass *klass) MONO_INTERNAL;
1171 MonoException*
1172 mono_class_get_exception_for_failure (MonoClass *klass) MONO_INTERNAL;
1174 char*
1175 mono_type_get_name_full (MonoType *type, MonoTypeNameFormat format) MONO_INTERNAL;
1177 char*
1178 mono_type_get_full_name (MonoClass *class) MONO_INTERNAL;
1180 MonoArrayType *mono_dup_array_type (MonoImage *image, MonoArrayType *a) MONO_INTERNAL;
1181 MonoMethodSignature *mono_metadata_signature_deep_dup (MonoImage *image, MonoMethodSignature *sig) MONO_INTERNAL;
1183 void
1184 mono_image_init_name_cache (MonoImage *image);
1186 gboolean mono_class_is_nullable (MonoClass *klass) MONO_INTERNAL;
1187 MonoClass *mono_class_get_nullable_param (MonoClass *klass) MONO_INTERNAL;
1189 /* object debugging functions, for use inside gdb */
1190 void mono_object_describe (MonoObject *obj);
1191 void mono_object_describe_fields (MonoObject *obj);
1192 void mono_value_describe_fields (MonoClass* klass, const char* addr);
1193 void mono_class_describe_statics (MonoClass* klass);
1195 /*Enum validation related functions*/
1196 gboolean
1197 mono_type_is_valid_enum_basetype (MonoType * type);
1199 gboolean
1200 mono_class_is_valid_enum (MonoClass *klass);
1202 MonoType *
1203 mono_type_get_full (MonoImage *image, guint32 type_token, MonoGenericContext *context) MONO_INTERNAL;
1205 gboolean
1206 mono_generic_class_is_generic_type_definition (MonoGenericClass *gklass) MONO_INTERNAL;
1208 MonoMethod*
1209 mono_method_get_declaring_generic_method (MonoMethod *method) MONO_INTERNAL;
1211 MonoMethod*
1212 mono_class_get_method_generic (MonoClass *klass, MonoMethod *method) MONO_INTERNAL;
1214 MonoType*
1215 mono_type_get_basic_type_from_generic (MonoType *type) MONO_INTERNAL;
1217 gboolean
1218 mono_method_can_access_method_full (MonoMethod *method, MonoMethod *called, MonoClass *context_klass) MONO_INTERNAL;
1220 gboolean
1221 mono_method_can_access_field_full (MonoMethod *method, MonoClassField *field, MonoClass *context_klass) MONO_INTERNAL;
1223 MonoClass *
1224 mono_class_get_generic_type_definition (MonoClass *klass) MONO_INTERNAL;
1226 gboolean
1227 mono_class_has_parent_and_ignore_generics (MonoClass *klass, MonoClass *parent) MONO_INTERNAL;
1230 mono_method_get_vtable_slot (MonoMethod *method) MONO_INTERNAL;
1233 mono_method_get_vtable_index (MonoMethod *method) MONO_INTERNAL;
1235 MonoMethod*
1236 mono_method_search_in_array_class (MonoClass *klass, const char *name, MonoMethodSignature *sig) MONO_INTERNAL;
1238 void
1239 mono_class_setup_interface_id (MonoClass *class) MONO_INTERNAL;
1241 MonoGenericContainer*
1242 mono_class_get_generic_container (MonoClass *klass) MONO_INTERNAL;
1244 MonoGenericClass*
1245 mono_class_get_generic_class (MonoClass *klass) MONO_INTERNAL;
1247 void
1248 mono_class_alloc_ext (MonoClass *klass) MONO_INTERNAL;
1250 void
1251 mono_class_setup_interfaces (MonoClass *klass, MonoError *error) MONO_INTERNAL;
1253 MonoClassField*
1254 mono_class_get_field_from_name_full (MonoClass *klass, const char *name, MonoType *type) MONO_INTERNAL;
1256 MonoVTable*
1257 mono_class_vtable_full (MonoDomain *domain, MonoClass *class, gboolean raise_on_error) MONO_INTERNAL;
1259 gboolean
1260 mono_class_is_assignable_from_slow (MonoClass *target, MonoClass *candidate) MONO_INTERNAL;
1262 gboolean
1263 mono_class_has_variant_generic_params (MonoClass *klass) MONO_INTERNAL;
1265 #endif /* __MONO_METADATA_CLASS_INTERBALS_H__ */