mono/metadata/metadata-internals.h

   1
   2 #ifndef __MONO_METADATA_INTERNALS_H__
   3 #define __MONO_METADATA_INTERNALS_H__
   4
   5 #include "mono/metadata/image.h"
   6 #include "mono/metadata/blob.h"
   7 #include "mono/metadata/mempool.h"
   8 #include "mono/metadata/domain-internals.h"
   9 #include "mono/utils/mono-hash.h"
  10 #include "mono/utils/mono-compiler.h"
  11 #include "mono/utils/mono-dl.h"
  12 #include "mono/utils/monobitset.h"
  13 #include "mono/utils/mono-property-hash.h"
  14 #include "mono/utils/mono-value-hash.h"
  15
  16 #define MONO_SECMAN_FLAG_INIT(x)                (x & 0x2)
  17 #define MONO_SECMAN_FLAG_GET_VALUE(x)           (x & 0x1)
  18 #define MONO_SECMAN_FLAG_SET_VALUE(x,y)         do { x = ((y) ? 0x3 : 0x2); } while (0)
  19
  20 struct _MonoAssembly {
  21         /*
  22          * The number of appdomains which have this assembly loaded plus the number of
  23          * assemblies referencing this assembly through an entry in their image->references
  24          * arrays. The later is needed because entries in the image->references array
  25          * might point to assemblies which are only loaded in some appdomains, and without
  26          * the additional reference, they can be freed at any time.
  27          * The ref_count is initially 0.
  28          */
  29         int ref_count; /* use atomic operations only */
  30         char *basedir;
  31         MonoAssemblyName aname;
  32         MonoImage *image;
  33         GSList *friend_assembly_names; /* Computed by mono_assembly_load_friends () */
  34         guint8 friend_assembly_names_inited;
  35         guint8 in_gac;
  36         guint8 dynamic;
  37         guint8 corlib_internal;
  38         gboolean ref_only;
  39         /* security manager flags (one bit is for lazy initialization) */
  40         guint32 ecma:2;         /* Has the ECMA key */
  41         guint32 aptc:2;         /* Has the [AllowPartiallyTrustedCallers] attributes */
  42         guint32 fulltrust:2;    /* Has FullTrust permission */
  43         guint32 unmanaged:2;    /* Has SecurityPermissionFlag.UnmanagedCode permission */
  44         guint32 skipverification:2;     /* Has SecurityPermissionFlag.SkipVerification permission */
  45 };
  46
  47 typedef struct {
  48         const char* data;
  49         guint32  size;
  50 } MonoStreamHeader;
  51
  52 struct _MonoTableInfo {
  53         const char *base;
  54         guint       rows     : 24;
  55         guint       row_size : 8;
  56
  57         /*
  58          * Tables contain up to 9 columns and the possible sizes of the
  59          * fields in the documentation are 1, 2 and 4 bytes.  So we
  60          * can encode in 2 bits the size.
  61          *
  62          * A 32 bit value can encode the resulting size
  63          *
  64          * The top eight bits encode the number of columns in the table.
  65          * we only need 4, but 8 is aligned no shift required.
  66          */
  67         guint32   size_bitfield;
  68 };
  69
  70 #define REFERENCE_MISSING ((gpointer) -1)
  71
  72 typedef struct _MonoDllMap MonoDllMap;
  73
  74 struct _MonoImage {
  75         /*
  76          * The number of assemblies which reference this MonoImage though their 'image'
  77          * field plus the number of images which reference this MonoImage through their
  78          * 'modules' field, plus the number of threads holding temporary references to
  79          * this image between calls of mono_image_open () and mono_image_close ().
  80          */
  81         int   ref_count;
  82         void *raw_data_handle;
  83         char *raw_data;
  84         guint32 raw_data_len;
  85         guint8 raw_buffer_used    : 1;
  86         guint8 raw_data_allocated : 1;
  87
  88 #ifdef HOST_WIN32
  89         /* Module was loaded using LoadLibrary. */
  90         guint8 is_module_handle : 1;
  91
  92         /* Module entry point is _CorDllMain. */
  93         guint8 has_entry_point : 1;
  94 #endif
  95
  96         /* Whenever this is a dynamically emitted module */
  97         guint8 dynamic : 1;
  98
  99         /* Whenever this is a reflection only image */
 100         guint8 ref_only : 1;
 101
 102         /* Whenever this image contains uncompressed metadata */
 103         guint8 uncompressed_metadata : 1;
 104
 105         guint8 checked_module_cctor : 1;
 106         guint8 has_module_cctor : 1;
 107
 108         guint8 idx_string_wide : 1;
 109         guint8 idx_guid_wide : 1;
 110         guint8 idx_blob_wide : 1;
 111
 112         /* Whenever this image is considered as platform code for the CoreCLR security model */
 113         guint8 core_clr_platform_code : 1;
 114
 115         char *name;
 116         const char *assembly_name;
 117         const char *module_name;
 118         char *version;
 119         gint16 md_version_major, md_version_minor;
 120         char *guid;
 121         void *image_info;
 122         MonoMemPool         *mempool; /*protected by the image lock*/
 123
 124         char                *raw_metadata;
 125
 126         MonoStreamHeader     heap_strings;
 127         MonoStreamHeader     heap_us;
 128         MonoStreamHeader     heap_blob;
 129         MonoStreamHeader     heap_guid;
 130         MonoStreamHeader     heap_tables;
 131
 132         const char          *tables_base;
 133
 134         /**/
 135         MonoTableInfo        tables [MONO_TABLE_NUM];
 136
 137         /*
 138          * references is initialized only by using the mono_assembly_open
 139          * function, and not by using the lowlevel mono_image_open.
 140          *
 141          * It is NULL terminated.
 142          */
 143         MonoAssembly **references;
 144
 145         MonoImage **modules;
 146         guint32 module_count;
 147         gboolean *modules_loaded;
 148
 149         MonoImage **files;
 150
 151         gpointer aot_module;
 152
 153         /*
 154          * The Assembly this image was loaded from.
 155          */
 156         MonoAssembly *assembly;
 157
 158         /*
 159          * Indexed by method tokens and typedef tokens.
 160          */
 161         GHashTable *method_cache; /*protected by the image lock*/
 162         MonoInternalHashTable class_cache;
 163
 164         /* Indexed by memberref + methodspec tokens */
 165         GHashTable *methodref_cache; /*protected by the image lock*/
 166
 167         /*
 168          * Indexed by fielddef and memberref tokens
 169          */
 170         GHashTable *field_cache;
 171
 172         /* indexed by typespec tokens. */
 173         GHashTable *typespec_cache;
 174         /* indexed by token */
 175         GHashTable *memberref_signatures;
 176         GHashTable *helper_signatures;
 177
 178         /* Indexed by blob heap indexes */
 179         GHashTable *method_signatures;
 180
 181         /*
 182          * Indexes namespaces to hash tables that map class name to typedef token.
 183          */
 184         GHashTable *name_cache;  /*protected by the image lock*/
 185
 186         /*
 187          * Indexed by MonoClass
 188          */
 189         GHashTable *array_cache;
 190         GHashTable *ptr_cache;
 191
 192         GHashTable *szarray_cache;
 193         /* This has a separate lock to improve scalability */
 194         CRITICAL_SECTION szarray_cache_lock;
 195
 196         /*
 197          * indexed by MonoMethodSignature
 198          */
 199         GHashTable *delegate_begin_invoke_cache;
 200         GHashTable *delegate_end_invoke_cache;
 201         GHashTable *delegate_invoke_cache;
 202         GHashTable *runtime_invoke_cache;
 203
 204         /*
 205          * indexed by SignatureMethodPair
 206          */
 207         GHashTable *delegate_abstract_invoke_cache;
 208
 209         /*
 210          * indexed by MonoMethod pointers
 211          */
 212         GHashTable *runtime_invoke_direct_cache;
 213         GHashTable *runtime_invoke_vcall_cache;
 214         GHashTable *managed_wrapper_cache;
 215         GHashTable *native_wrapper_cache;
 216         GHashTable *native_wrapper_aot_cache;
 217         GHashTable *remoting_invoke_cache;
 218         GHashTable *synchronized_cache;
 219         GHashTable *unbox_wrapper_cache;
 220         GHashTable *cominterop_invoke_cache;
 221         GHashTable *cominterop_wrapper_cache; /* LOCKING: marshal lock */
 222         GHashTable *thunk_invoke_cache;
 223
 224         /*
 225          * indexed by MonoClass pointers
 226          */
 227         GHashTable *ldfld_wrapper_cache;
 228         GHashTable *ldflda_wrapper_cache;
 229         GHashTable *stfld_wrapper_cache;
 230         GHashTable *isinst_cache;
 231         GHashTable *castclass_cache;
 232         GHashTable *proxy_isinst_cache;
 233         GHashTable *rgctx_template_hash; /* LOCKING: templates lock */
 234
 235         /*
 236          * indexed by token and MonoGenericContext pointer
 237          */
 238         GHashTable *generic_class_cache;
 239
 240         /* Contains rarely used fields of runtime structures belonging to this image */
 241         MonoPropertyHash *property_hash;
 242
 243         void *reflection_info;
 244
 245         /*
 246          * user_info is a public field and is not touched by the
 247          * metadata engine
 248          */
 249         void *user_info;
 250
 251         /* dll map entries */
 252         MonoDllMap *dll_map;
 253
 254         /* interfaces IDs from this image */
 255         MonoBitSet *interface_bitset;
 256
 257         /* when the image is being closed, this is abused as a list of
 258            malloc'ed regions to be freed. */
 259         GSList *reflection_info_unregister_classes;
 260
 261         /*
 262          * No other runtime locks must be taken while holding this lock.
 263          * It's meant to be used only to mutate and query structures part of this image.
 264          */
 265         CRITICAL_SECTION    lock;
 266 };
 267
 268 enum {
 269         MONO_SECTION_TEXT,
 270         MONO_SECTION_RSRC,
 271         MONO_SECTION_RELOC,
 272         MONO_SECTION_MAX
 273 };
 274
 275 typedef struct {
 276         GHashTable *hash;
 277         char *data;
 278         guint32 alloc_size; /* malloced bytes */
 279         guint32 index;
 280         guint32 offset; /* from start of metadata */
 281 } MonoDynamicStream;
 282
 283 typedef struct {
 284         guint32 alloc_rows;
 285         guint32 rows;
 286         guint8  row_size; /*  calculated later with column_sizes */
 287         guint8  columns;
 288         guint32 next_idx;
 289         guint32 *values; /* rows * columns */
 290 } MonoDynamicTable;
 291
 292 struct _MonoDynamicAssembly {
 293         MonoAssembly assembly;
 294         char *strong_name;
 295         guint32 strong_name_size;
 296         guint8 run;
 297         guint8 save;
 298         MonoDomain *domain;
 299 };
 300
 301 struct _MonoDynamicImage {
 302         MonoImage image;
 303         guint32 meta_size;
 304         guint32 text_rva;
 305         guint32 metadata_rva;
 306         guint32 image_base;
 307         guint32 cli_header_offset;
 308         guint32 iat_offset;
 309         guint32 idt_offset;
 310         guint32 ilt_offset;
 311         guint32 imp_names_offset;
 312         struct {
 313                 guint32 rva;
 314                 guint32 size;
 315                 guint32 offset;
 316                 guint32 attrs;
 317         } sections [MONO_SECTION_MAX];
 318         GHashTable *typespec;
 319         GHashTable *typeref;
 320         GHashTable *handleref;
 321         MonoGHashTable *tokens;
 322         GHashTable *blob_cache;
 323         GHashTable *standalonesig_cache;
 324         GList *array_methods;
 325         GPtrArray *gen_params;
 326         MonoGHashTable *token_fixups;
 327         GHashTable *method_to_table_idx;
 328         GHashTable *field_to_table_idx;
 329         GHashTable *method_aux_hash;
 330         MonoGHashTable *generic_def_objects;
 331         MonoGHashTable *methodspec;
 332         gboolean run;
 333         gboolean save;
 334         gboolean initial_image;
 335         guint32 pe_kind, machine;
 336         char *strong_name;
 337         guint32 strong_name_size;
 338         char *win32_res;
 339         guint32 win32_res_size;
 340         guint8 *public_key;
 341         int public_key_len;
 342         MonoDynamicStream sheap;
 343         MonoDynamicStream code; /* used to store method headers and bytecode */
 344         MonoDynamicStream resources; /* managed embedded resources */
 345         MonoDynamicStream us;
 346         MonoDynamicStream blob;
 347         MonoDynamicStream tstream;
 348         MonoDynamicStream guid;
 349         MonoDynamicTable tables [MONO_TABLE_NUM];
 350         MonoClass *wrappers_type; /*wrappers are bound to this type instead of <Module>*/
 351 };
 352
 353 /* Contains information about assembly binding */
 354 typedef struct _MonoAssemblyBindingInfo {
 355         char *name;
 356         char *culture;
 357         guchar public_key_token [MONO_PUBLIC_KEY_TOKEN_LENGTH];
 358         int major;
 359         int minor;
 360         AssemblyVersionSet old_version_bottom;
 361         AssemblyVersionSet old_version_top;
 362         AssemblyVersionSet new_version;
 363         guint has_old_version_bottom : 1;
 364         guint has_old_version_top : 1;
 365         guint has_new_version : 1;
 366         guint is_valid : 1;
 367 } MonoAssemblyBindingInfo;
 368
 369 struct _MonoMethodHeader {
 370         guint32      code_size;
 371         const unsigned char  *code;
 372         guint16      max_stack;
 373         unsigned int num_clauses : 15;
 374         /* if num_locals != 0, then the following apply: */
 375         unsigned int init_locals : 1;
 376         guint16      num_locals;
 377         MonoExceptionClause *clauses;
 378         MonoType    *locals [MONO_ZERO_LEN_ARRAY];
 379 };
 380
 381 #define MONO_SIZEOF_METHOD_HEADER (sizeof (struct _MonoMethodHeader) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
 382
 383 /* for use with allocated memory blocks (assumes alignment is to 8 bytes) */
 384 guint mono_aligned_addr_hash (gconstpointer ptr) MONO_INTERNAL;
 385
 386 void
 387 mono_image_check_for_module_cctor (MonoImage *image) MONO_INTERNAL;
 388
 389 gpointer
 390 mono_image_alloc  (MonoImage *image, guint size) MONO_INTERNAL;
 391
 392 gpointer
 393 mono_image_alloc0 (MonoImage *image, guint size) MONO_INTERNAL;
 394
 395 char*
 396 mono_image_strdup (MonoImage *image, const char *s) MONO_INTERNAL;
 397
 398 GList*
 399 g_list_prepend_image (MonoImage *image, GList *list, gpointer data) MONO_INTERNAL;
 400
 401 GSList*
 402 g_slist_append_image (MonoImage *image, GSList *list, gpointer data) MONO_INTERNAL;
 403
 404 void
 405 mono_image_lock (MonoImage *image) MONO_INTERNAL;
 406
 407 void
 408 mono_image_unlock (MonoImage *image) MONO_INTERNAL;
 409
 410 gpointer
 411 mono_image_property_lookup (MonoImage *image, gpointer subject, guint32 property) MONO_INTERNAL;
 412
 413 void
 414 mono_image_property_insert (MonoImage *image, gpointer subject, guint32 property, gpointer value) MONO_INTERNAL;
 415
 416 void
 417 mono_image_property_remove (MonoImage *image, gpointer subject) MONO_INTERNAL;
 418
 419 gboolean
 420 mono_image_close_except_pools (MonoImage *image) MONO_INTERNAL;
 421
 422 void
 423 mono_image_close_finish (MonoImage *image) MONO_INTERNAL;
 424
 425
 426 MonoType*
 427 mono_metadata_get_shared_type (MonoType *type) MONO_INTERNAL;
 428
 429 GSList*
 430 mono_metadata_clean_for_image (MonoImage *image) MONO_INTERNAL;
 431
 432 void
 433 mono_metadata_clean_generic_classes_for_image (MonoImage *image) MONO_INTERNAL;
 434
 435 void
 436 mono_metadata_cleanup (void);
 437
 438 const char *   mono_meta_table_name              (int table) MONO_INTERNAL;
 439 void           mono_metadata_compute_table_bases (MonoImage *meta) MONO_INTERNAL;
 440
 441 gboolean
 442 mono_metadata_interfaces_from_typedef_full  (MonoImage             *image,
 443                                                                                          guint32                table_index,
 444                                                                                          MonoClass           ***interfaces,
 445                                                                                          guint                 *count,
 446                                                                                          gboolean               heap_alloc_result,
 447                                                                                          MonoGenericContext    *context) MONO_INTERNAL;
 448
 449 MonoArrayType *
 450 mono_metadata_parse_array_full              (MonoImage             *image,
 451                                              MonoGenericContainer  *container,
 452                                              const char            *ptr,
 453                                              const char           **rptr) MONO_INTERNAL;
 454
 455 MonoType *
 456 mono_metadata_parse_type_full               (MonoImage             *image,
 457                                              MonoGenericContainer  *container,
 458                                              MonoParseTypeMode      mode,
 459                                              short                  opt_attrs,
 460                                              const char            *ptr,
 461                                              const char           **rptr);
 462
 463 MonoMethodSignature *
 464 mono_metadata_parse_signature_full          (MonoImage             *image,
 465                                              MonoGenericContainer  *generic_container,
 466                                              guint32                token) MONO_INTERNAL;
 467
 468 MonoMethodSignature *
 469 mono_metadata_parse_method_signature_full   (MonoImage             *image,
 470                                              MonoGenericContainer  *generic_container,
 471                                              int                     def,
 472                                              const char             *ptr,
 473                                              const char            **rptr);
 474
 475 MonoMethodHeader *
 476 mono_metadata_parse_mh_full                 (MonoImage             *image,
 477                                              MonoGenericContainer  *container,
 478                                              const char            *ptr);
 479
 480 int* mono_metadata_get_param_attrs          (MonoImage *m, int def, int param_count) MONO_INTERNAL;
 481 gboolean mono_metadata_method_has_param_attrs (MonoImage *m, int def) MONO_INTERNAL;
 482
 483 guint
 484 mono_metadata_generic_context_hash          (const MonoGenericContext *context) MONO_INTERNAL;
 485
 486 gboolean
 487 mono_metadata_generic_context_equal         (const MonoGenericContext *g1,
 488                                              const MonoGenericContext *g2) MONO_INTERNAL;
 489
 490 MonoGenericInst *
 491 mono_metadata_parse_generic_inst            (MonoImage             *image,
 492                                              MonoGenericContainer  *container,
 493                                              int                    count,
 494                                              const char            *ptr,
 495                                              const char           **rptr) MONO_INTERNAL;
 496
 497 MonoGenericInst *
 498 mono_metadata_get_generic_inst              (int                    type_argc,
 499                                              MonoType             **type_argv) MONO_INTERNAL;
 500
 501 MonoGenericClass *
 502 mono_metadata_lookup_generic_class          (MonoClass             *gclass,
 503                                              MonoGenericInst       *inst,
 504                                              gboolean               is_dynamic) MONO_INTERNAL;
 505
 506 MonoGenericInst * mono_metadata_inflate_generic_inst  (MonoGenericInst *ginst, MonoGenericContext *context, MonoError *error) MONO_INTERNAL;
 507
 508 void mono_dynamic_stream_reset  (MonoDynamicStream* stream) MONO_INTERNAL;
 509 void mono_assembly_addref       (MonoAssembly *assembly) MONO_INTERNAL;
 510 void mono_assembly_load_friends (MonoAssembly* ass) MONO_INTERNAL;
 511 gboolean mono_assembly_has_skip_verification (MonoAssembly* ass) MONO_INTERNAL;
 512
 513 gboolean mono_assembly_close_except_image_pools (MonoAssembly *assembly) MONO_INTERNAL;
 514 void mono_assembly_close_finish (MonoAssembly *assembly) MONO_INTERNAL;
 515
 516
 517 gboolean mono_public_tokens_are_equal (const unsigned char *pubt1, const unsigned char *pubt2) MONO_INTERNAL;
 518
 519 void mono_config_parse_publisher_policy (const char *filename, MonoAssemblyBindingInfo *binding_info) MONO_INTERNAL;
 520
 521 gboolean
 522 mono_assembly_name_parse_full                (const char           *name,
 523                                               MonoAssemblyName     *aname,
 524                                               gboolean save_public_key,
 525                                               gboolean *is_version_defined,
 526                                                   gboolean *is_token_defined) MONO_INTERNAL;
 527
 528 guint32 mono_metadata_get_generic_param_row (MonoImage *image, guint32 token, guint32 *owner);
 529
 530 void mono_unload_interface_ids (MonoBitSet *bitset) MONO_INTERNAL;
 531
 532
 533 MonoType *mono_metadata_type_dup (MonoImage *image, const MonoType *original) MONO_INTERNAL;
 534 MonoMethodSignature  *mono_metadata_signature_dup_full (MonoImage *image,MonoMethodSignature *sig) MONO_INTERNAL;
 535 MonoMethodSignature  *mono_metadata_signature_dup_mempool (MonoMemPool *mp, MonoMethodSignature *sig) MONO_INTERNAL;
 536
 537 MonoGenericInst *
 538 mono_get_shared_generic_inst (MonoGenericContainer *container) MONO_INTERNAL;
 539
 540 int
 541 mono_type_stack_size_internal (MonoType *t, int *align, gboolean allow_open) MONO_INTERNAL;
 542
 543 gboolean
 544 mono_metadata_type_equal_full (MonoType *t1, MonoType *t2, gboolean signature_only) MONO_INTERNAL;
 545
 546 MonoMarshalSpec *
 547 mono_metadata_parse_marshal_spec_full (MonoImage *image, const char *ptr) MONO_INTERNAL;
 548
 549 guint          mono_metadata_generic_inst_hash (gconstpointer data) MONO_INTERNAL;
 550 gboolean       mono_metadata_generic_inst_equal (gconstpointer ka, gconstpointer kb) MONO_INTERNAL;
 551
 552 void
 553 mono_metadata_field_info_with_mempool (
 554                                           MonoImage *meta,
 555                                       guint32       table_index,
 556                                       guint32      *offset,
 557                                       guint32      *rva,
 558                                       MonoMarshalSpec **marshal_spec);
 559
 560 MonoClassField*
 561 mono_metadata_get_corresponding_field_from_generic_type_definition (MonoClassField *field) MONO_INTERNAL;
 562
 563 MonoEvent*
 564 mono_metadata_get_corresponding_event_from_generic_type_definition (MonoEvent *event) MONO_INTERNAL;
 565
 566 MonoProperty*
 567 mono_metadata_get_corresponding_property_from_generic_type_definition (MonoProperty *property) MONO_INTERNAL;
 568
 569 guint32
 570 mono_metadata_signature_size (MonoMethodSignature *sig) MONO_INTERNAL;
 571
 572 gboolean mono_image_load_pe_data (MonoImage *image) MONO_INTERNAL;
 573
 574 gboolean mono_image_load_cli_data (MonoImage *image) MONO_INTERNAL;
 575
 576 void mono_image_load_names (MonoImage *image) MONO_INTERNAL;
 577
 578 MonoImage *mono_image_open_raw (const char *fname, MonoImageOpenStatus *status) MONO_INTERNAL;
 579
 580 #endif /* __MONO_METADATA_INTERNALS_H__ */
 581