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 PLATFORM_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         MonoValueHashTable *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         GSList *reflection_info_unregister_classes;
 258
 259         /*
 260          * No other runtime locks must be taken while holding this lock.
 261          * It's meant to be used only to mutate and query structures part of this image.
 262          */
 263         CRITICAL_SECTION    lock;
 264 };
 265
 266 enum {
 267         MONO_SECTION_TEXT,
 268         MONO_SECTION_RSRC,
 269         MONO_SECTION_RELOC,
 270         MONO_SECTION_MAX
 271 };
 272
 273 typedef struct {
 274         GHashTable *hash;
 275         char *data;
 276         guint32 alloc_size; /* malloced bytes */
 277         guint32 index;
 278         guint32 offset; /* from start of metadata */
 279 } MonoDynamicStream;
 280
 281 typedef struct {
 282         guint32 alloc_rows;
 283         guint32 rows;
 284         guint8  row_size; /*  calculated later with column_sizes */
 285         guint8  columns;
 286         guint32 next_idx;
 287         guint32 *values; /* rows * columns */
 288 } MonoDynamicTable;
 289
 290 struct _MonoDynamicAssembly {
 291         MonoAssembly assembly;
 292         char *strong_name;
 293         guint32 strong_name_size;
 294         guint8 run;
 295         guint8 save;
 296 };
 297
 298 struct _MonoDynamicImage {
 299         MonoImage image;
 300         guint32 meta_size;
 301         guint32 text_rva;
 302         guint32 metadata_rva;
 303         guint32 image_base;
 304         guint32 cli_header_offset;
 305         guint32 iat_offset;
 306         guint32 idt_offset;
 307         guint32 ilt_offset;
 308         guint32 imp_names_offset;
 309         struct {
 310                 guint32 rva;
 311                 guint32 size;
 312                 guint32 offset;
 313                 guint32 attrs;
 314         } sections [MONO_SECTION_MAX];
 315         GHashTable *typespec;
 316         GHashTable *typeref;
 317         GHashTable *handleref;
 318         MonoGHashTable *tokens;
 319         GHashTable *blob_cache;
 320         GHashTable *standalonesig_cache;
 321         GList *array_methods;
 322         GPtrArray *gen_params;
 323         MonoGHashTable *token_fixups;
 324         GHashTable *method_to_table_idx;
 325         GHashTable *field_to_table_idx;
 326         GHashTable *method_aux_hash;
 327         MonoGHashTable *generic_def_objects;
 328         MonoGHashTable *methodspec;
 329         gboolean run;
 330         gboolean save;
 331         gboolean initial_image;
 332         guint32 pe_kind, machine;
 333         char *strong_name;
 334         guint32 strong_name_size;
 335         char *win32_res;
 336         guint32 win32_res_size;
 337         guint8 *public_key;
 338         int public_key_len;
 339         MonoDynamicStream sheap;
 340         MonoDynamicStream code; /* used to store method headers and bytecode */
 341         MonoDynamicStream resources; /* managed embedded resources */
 342         MonoDynamicStream us;
 343         MonoDynamicStream blob;
 344         MonoDynamicStream tstream;
 345         MonoDynamicStream guid;
 346         MonoDynamicTable tables [MONO_TABLE_NUM];
 347         MonoClass *wrappers_type; /*wrappers are bound to this type instead of <Module>*/
 348 };
 349
 350 /* Contains information about assembly binding */
 351 typedef struct _MonoAssemblyBindingInfo {
 352         char *name;
 353         char *culture;
 354         guchar public_key_token [MONO_PUBLIC_KEY_TOKEN_LENGTH];
 355         int major;
 356         int minor;
 357         AssemblyVersionSet old_version_bottom;
 358         AssemblyVersionSet old_version_top;
 359         AssemblyVersionSet new_version;
 360         guint has_old_version_bottom : 1;
 361         guint has_old_version_top : 1;
 362         guint has_new_version : 1;
 363         guint is_valid : 1;
 364 } MonoAssemblyBindingInfo;
 365
 366 struct _MonoMethodHeader {
 367         guint32      code_size;
 368         const unsigned char  *code;
 369         guint16      max_stack;
 370         unsigned int num_clauses : 15;
 371         /* if num_locals != 0, then the following apply: */
 372         unsigned int init_locals : 1;
 373         guint16      num_locals;
 374         MonoExceptionClause *clauses;
 375         MonoType    *locals [MONO_ZERO_LEN_ARRAY];
 376 };
 377
 378 #define MONO_SIZEOF_METHOD_HEADER (sizeof (struct _MonoMethodHeader) - MONO_ZERO_LEN_ARRAY * SIZEOF_VOID_P)
 379
 380 /* for use with allocated memory blocks (assumes alignment is to 8 bytes) */
 381 guint mono_aligned_addr_hash (gconstpointer ptr) MONO_INTERNAL;
 382
 383 void
 384 mono_image_check_for_module_cctor (MonoImage *image) MONO_INTERNAL;
 385
 386 gpointer
 387 mono_image_alloc  (MonoImage *image, guint size) MONO_INTERNAL;
 388
 389 gpointer
 390 mono_image_alloc0 (MonoImage *image, guint size) MONO_INTERNAL;
 391
 392 char*
 393 mono_image_strdup (MonoImage *image, const char *s) MONO_INTERNAL;
 394
 395 GList*
 396 g_list_prepend_image (MonoImage *image, GList *list, gpointer data) MONO_INTERNAL;
 397
 398 GSList*
 399 g_slist_append_image (MonoImage *image, GSList *list, gpointer data) MONO_INTERNAL;
 400
 401 void
 402 mono_image_lock (MonoImage *image) MONO_INTERNAL;
 403
 404 void
 405 mono_image_unlock (MonoImage *image) MONO_INTERNAL;
 406
 407 gpointer
 408 mono_image_property_lookup (MonoImage *image, gpointer subject, guint32 property) MONO_INTERNAL;
 409
 410 void
 411 mono_image_property_insert (MonoImage *image, gpointer subject, guint32 property, gpointer value) MONO_INTERNAL;
 412
 413 void
 414 mono_image_property_remove (MonoImage *image, gpointer subject) MONO_INTERNAL;
 415
 416
 417 MonoType*
 418 mono_metadata_get_shared_type (MonoType *type) MONO_INTERNAL;
 419
 420 void
 421 mono_metadata_clean_for_image (MonoImage *image) MONO_INTERNAL;
 422
 423 void
 424 mono_metadata_cleanup (void);
 425
 426 const char *   mono_meta_table_name              (int table) MONO_INTERNAL;
 427 void           mono_metadata_compute_table_bases (MonoImage *meta) MONO_INTERNAL;
 428
 429 gboolean
 430 mono_metadata_interfaces_from_typedef_full  (MonoImage             *image,
 431                                                                                          guint32                table_index,
 432                                                                                          MonoClass           ***interfaces,
 433                                                                                          guint                 *count,
 434                                                                                          gboolean               heap_alloc_result,
 435                                                                                          MonoGenericContext    *context) MONO_INTERNAL;
 436
 437 MonoArrayType *
 438 mono_metadata_parse_array_full              (MonoImage             *image,
 439                                              MonoGenericContainer  *container,
 440                                              const char            *ptr,
 441                                              const char           **rptr) MONO_INTERNAL;
 442
 443 MonoType *
 444 mono_metadata_parse_type_full               (MonoImage             *image,
 445                                              MonoGenericContainer  *container,
 446                                              MonoParseTypeMode      mode,
 447                                              short                  opt_attrs,
 448                                              const char            *ptr,
 449                                              const char           **rptr);
 450
 451 MonoMethodSignature *
 452 mono_metadata_parse_signature_full          (MonoImage             *image,
 453                                              MonoGenericContainer  *generic_container,
 454                                              guint32                token) MONO_INTERNAL;
 455
 456 MonoMethodSignature *
 457 mono_metadata_parse_method_signature_full   (MonoImage             *image,
 458                                              MonoGenericContainer  *generic_container,
 459                                              int                     def,
 460                                              const char             *ptr,
 461                                              const char            **rptr);
 462
 463 MonoMethodHeader *
 464 mono_metadata_parse_mh_full                 (MonoImage             *image,
 465                                              MonoGenericContainer  *container,
 466                                              const char            *ptr);
 467
 468 int* mono_metadata_get_param_attrs          (MonoImage *m, int def);
 469
 470 guint
 471 mono_metadata_generic_context_hash          (const MonoGenericContext *context) MONO_INTERNAL;
 472
 473 gboolean
 474 mono_metadata_generic_context_equal         (const MonoGenericContext *g1,
 475                                              const MonoGenericContext *g2) MONO_INTERNAL;
 476
 477 MonoGenericInst *
 478 mono_metadata_parse_generic_inst            (MonoImage             *image,
 479                                              MonoGenericContainer  *container,
 480                                              int                    count,
 481                                              const char            *ptr,
 482                                              const char           **rptr) MONO_INTERNAL;
 483
 484 MonoGenericInst *
 485 mono_metadata_get_generic_inst              (int                    type_argc,
 486                                              MonoType             **type_argv) MONO_INTERNAL;
 487
 488 MonoGenericClass *
 489 mono_metadata_lookup_generic_class          (MonoClass             *gclass,
 490                                              MonoGenericInst       *inst,
 491                                              gboolean               is_dynamic) MONO_INTERNAL;
 492
 493 MonoGenericInst *
 494 mono_metadata_inflate_generic_inst          (MonoGenericInst       *ginst,
 495                                              MonoGenericContext    *context) MONO_INTERNAL;
 496
 497 void mono_dynamic_stream_reset  (MonoDynamicStream* stream) MONO_INTERNAL;
 498 void mono_assembly_addref       (MonoAssembly *assembly) MONO_INTERNAL;
 499 void mono_assembly_load_friends (MonoAssembly* ass) MONO_INTERNAL;
 500 gboolean mono_assembly_has_skip_verification (MonoAssembly* ass) MONO_INTERNAL;
 501
 502 gboolean mono_public_tokens_are_equal (const unsigned char *pubt1, const unsigned char *pubt2) MONO_INTERNAL;
 503
 504 void mono_config_parse_publisher_policy (const char *filename, MonoAssemblyBindingInfo *binding_info) MONO_INTERNAL;
 505
 506 gboolean
 507 mono_assembly_name_parse_full                (const char           *name,
 508                                               MonoAssemblyName     *aname,
 509                                               gboolean save_public_key,
 510                                               gboolean *is_version_defined,
 511                                                   gboolean *is_token_defined) MONO_INTERNAL;
 512
 513 guint32 mono_metadata_get_generic_param_row (MonoImage *image, guint32 token, guint32 *owner);
 514
 515 void mono_unload_interface_ids (MonoBitSet *bitset) MONO_INTERNAL;
 516
 517
 518 MonoType *mono_metadata_type_dup (MonoImage *image, const MonoType *original) MONO_INTERNAL;
 519 MonoMethodSignature  *mono_metadata_signature_dup_full (MonoImage *image,MonoMethodSignature *sig) MONO_INTERNAL;
 520 MonoMethodSignature  *mono_metadata_signature_dup_mempool (MonoMemPool *mp, MonoMethodSignature *sig) MONO_INTERNAL;
 521
 522 MonoGenericInst *
 523 mono_get_shared_generic_inst (MonoGenericContainer *container) MONO_INTERNAL;
 524
 525 int
 526 mono_type_stack_size_internal (MonoType *t, int *align, gboolean allow_open) MONO_INTERNAL;
 527
 528 gboolean
 529 mono_metadata_type_equal_full (MonoType *t1, MonoType *t2, gboolean signature_only) MONO_INTERNAL;
 530
 531 MonoMarshalSpec *
 532 mono_metadata_parse_marshal_spec_full (MonoImage *image, const char *ptr) MONO_INTERNAL;
 533
 534 guint          mono_metadata_generic_inst_hash (gconstpointer data) MONO_INTERNAL;
 535 gboolean       mono_metadata_generic_inst_equal (gconstpointer ka, gconstpointer kb) MONO_INTERNAL;
 536
 537 void
 538 mono_metadata_field_info_with_mempool (
 539                                           MonoImage *meta,
 540                                       guint32       table_index,
 541                                       guint32      *offset,
 542                                       guint32      *rva,
 543                                       MonoMarshalSpec **marshal_spec);
 544
 545 MonoClassField*
 546 mono_metadata_get_corresponding_field_from_generic_type_definition (MonoClassField *field) MONO_INTERNAL;
 547
 548 MonoEvent*
 549 mono_metadata_get_corresponding_event_from_generic_type_definition (MonoEvent *event) MONO_INTERNAL;
 550
 551 MonoProperty*
 552 mono_metadata_get_corresponding_property_from_generic_type_definition (MonoProperty *property) MONO_INTERNAL;
 553
 554 guint32
 555 mono_metadata_signature_size (MonoMethodSignature *sig) MONO_INTERNAL;
 556
 557 gboolean mono_image_load_pe_data (MonoImage *image) MONO_INTERNAL;
 558
 559 gboolean mono_image_load_cli_data (MonoImage *image) MONO_INTERNAL;
 560
 561 void mono_image_load_names (MonoImage *image) MONO_INTERNAL;
 562
 563 MonoImage *mono_image_open_raw (const char *fname, MonoImageOpenStatus *status) MONO_INTERNAL;
 564
 565 #endif /* __MONO_METADATA_INTERNALS_H__ */
 566