2 * image.c: Routines for manipulating an image stored in an
3 * extended PE/COFF file.
6 * Miguel de Icaza (miguel@ximian.com)
7 * Paolo Molaro (lupus@ximian.com)
9 * Copyright 2001-2003 Ximian, Inc (http://www.ximian.com)
10 * Copyright 2004-2009 Novell, Inc (http://www.novell.com)
12 * Licensed under the MIT license. See LICENSE file in the project root for full license information.
22 #include "mono-endian.h"
23 #include "tabledefs.h"
24 #include "tokentype.h"
25 #include "metadata-internals.h"
26 #include "profiler-private.h"
30 #include <mono/io-layer/io-layer.h>
31 #include <mono/utils/mono-logger-internals.h>
32 #include <mono/utils/mono-path.h>
33 #include <mono/utils/mono-mmap.h>
34 #include <mono/utils/mono-io-portability.h>
35 #include <mono/utils/atomic.h>
36 #include <mono/metadata/class-internals.h>
37 #include <mono/metadata/assembly.h>
38 #include <mono/metadata/object-internals.h>
39 #include <mono/metadata/security-core-clr.h>
40 #include <mono/metadata/verify-internals.h>
41 #include <mono/metadata/verify.h>
42 #include <mono/metadata/image-internals.h>
43 #include <sys/types.h>
49 #define INVALID_ADDRESS 0xffffffff
51 // Amount initially reserved in each image's mempool.
52 // FIXME: This number is arbitrary, a more practical number should be found
53 #define INITIAL_IMAGE_SIZE 512
56 * The "loaded images" hashes keep track of the various assemblies and netmodules loaded
57 * There are four, for all combinations of [look up by path or assembly name?]
58 * and [normal or reflection-only load?, as in Assembly.ReflectionOnlyLoad]
62 IMAGES_HASH_PATH_REFONLY
= 1,
64 IMAGES_HASH_NAME_REFONLY
= 3,
67 static GHashTable
*loaded_images_hashes
[4] = {NULL
, NULL
, NULL
, NULL
};
70 get_loaded_images_hash (gboolean refonly
)
72 int idx
= refonly
? IMAGES_HASH_PATH_REFONLY
: IMAGES_HASH_PATH
;
73 return loaded_images_hashes
[idx
];
77 get_loaded_images_by_name_hash (gboolean refonly
)
79 int idx
= refonly
? IMAGES_HASH_NAME_REFONLY
: IMAGES_HASH_NAME
;
80 return loaded_images_hashes
[idx
];
83 // Change the assembly set in `image` to the assembly set in `assemblyImage`. Halt if overwriting is attempted.
84 // Can be used on modules loaded through either the "file" or "module" mechanism
86 assign_assembly_parent_for_netmodule (MonoImage
*image
, MonoImage
*assemblyImage
, MonoError
*error
)
89 MonoAssembly
*assembly
= assemblyImage
->assembly
;
92 // Assembly currently assigned
93 MonoAssembly
*assemblyOld
= image
->assembly
;
95 if (assemblyOld
== assembly
)
97 mono_error_set_bad_image (error
, assemblyImage
, "Attempted to load module %s which has already been loaded by assembly %s. This is not supported in Mono.", image
->name
, assemblyOld
->image
->name
);
100 gpointer result
= InterlockedExchangePointer((gpointer
*)&image
->assembly
, assembly
);
101 if (result
== assembly
)
106 static gboolean debug_assembly_unload
= FALSE
;
108 #define mono_images_lock() if (mutex_inited) mono_os_mutex_lock (&images_mutex)
109 #define mono_images_unlock() if (mutex_inited) mono_os_mutex_unlock (&images_mutex)
110 static gboolean mutex_inited
;
111 static mono_mutex_t images_mutex
;
113 static void install_pe_loader (void);
115 typedef struct ImageUnloadHook ImageUnloadHook
;
116 struct ImageUnloadHook
{
117 MonoImageUnloadFunc func
;
121 static GSList
*image_unload_hooks
;
124 mono_install_image_unload_hook (MonoImageUnloadFunc func
, gpointer user_data
)
126 ImageUnloadHook
*hook
;
128 g_return_if_fail (func
!= NULL
);
130 hook
= g_new0 (ImageUnloadHook
, 1);
132 hook
->user_data
= user_data
;
133 image_unload_hooks
= g_slist_prepend (image_unload_hooks
, hook
);
137 mono_remove_image_unload_hook (MonoImageUnloadFunc func
, gpointer user_data
)
140 ImageUnloadHook
*hook
;
142 for (l
= image_unload_hooks
; l
; l
= l
->next
) {
143 hook
= (ImageUnloadHook
*)l
->data
;
145 if (hook
->func
== func
&& hook
->user_data
== user_data
) {
147 image_unload_hooks
= g_slist_delete_link (image_unload_hooks
, l
);
154 mono_image_invoke_unload_hook (MonoImage
*image
)
157 ImageUnloadHook
*hook
;
159 for (l
= image_unload_hooks
; l
; l
= l
->next
) {
160 hook
= (ImageUnloadHook
*)l
->data
;
162 hook
->func (image
, hook
->user_data
);
166 static GSList
*image_loaders
;
169 mono_install_image_loader (const MonoImageLoader
*loader
)
171 image_loaders
= g_slist_prepend (image_loaders
, (MonoImageLoader
*)loader
);
174 /* returns offset relative to image->raw_data */
176 mono_cli_rva_image_map (MonoImage
*image
, guint32 addr
)
178 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
179 const int top
= iinfo
->cli_section_count
;
180 MonoSectionTable
*tables
= iinfo
->cli_section_tables
;
183 if (image
->metadata_only
)
186 for (i
= 0; i
< top
; i
++){
187 if ((addr
>= tables
->st_virtual_address
) &&
188 (addr
< tables
->st_virtual_address
+ tables
->st_raw_data_size
)){
190 if (image
->is_module_handle
)
193 return addr
- tables
->st_virtual_address
+ tables
->st_raw_data_ptr
;
197 return INVALID_ADDRESS
;
201 * mono_images_rva_map:
202 * @image: a MonoImage
203 * @addr: relative virtual address (RVA)
205 * This is a low-level routine used by the runtime to map relative
206 * virtual address (RVA) into their location in memory.
208 * Returns: the address in memory for the given RVA, or NULL if the
209 * RVA is not valid for this image.
212 mono_image_rva_map (MonoImage
*image
, guint32 addr
)
214 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
215 const int top
= iinfo
->cli_section_count
;
216 MonoSectionTable
*tables
= iinfo
->cli_section_tables
;
220 if (image
->is_module_handle
) {
221 if (addr
&& addr
< image
->raw_data_len
)
222 return image
->raw_data
+ addr
;
228 for (i
= 0; i
< top
; i
++){
229 if ((addr
>= tables
->st_virtual_address
) &&
230 (addr
< tables
->st_virtual_address
+ tables
->st_raw_data_size
)){
231 if (!iinfo
->cli_sections
[i
]) {
232 if (!mono_image_ensure_section_idx (image
, i
))
235 return (char*)iinfo
->cli_sections
[i
] +
236 (addr
- tables
->st_virtual_address
);
246 * Initialize the global variables used by this module.
249 mono_images_init (void)
251 mono_os_mutex_init_recursive (&images_mutex
);
254 for(hash_idx
= 0; hash_idx
< IMAGES_HASH_COUNT
; hash_idx
++)
255 loaded_images_hashes
[hash_idx
] = g_hash_table_new (g_str_hash
, g_str_equal
);
257 debug_assembly_unload
= g_getenv ("MONO_DEBUG_ASSEMBLY_UNLOAD") != NULL
;
259 install_pe_loader ();
265 * mono_images_cleanup:
267 * Free all resources used by this module.
270 mono_images_cleanup (void)
275 mono_os_mutex_destroy (&images_mutex
);
277 // If an assembly image is still loaded at shutdown, this could indicate managed code is still running.
278 // Reflection-only images being still loaded doesn't indicate anything as harmful, so we don't check for it.
279 g_hash_table_iter_init (&iter
, get_loaded_images_hash (FALSE
));
280 while (g_hash_table_iter_next (&iter
, NULL
, (void**)&image
))
281 mono_trace (G_LOG_LEVEL_INFO
, MONO_TRACE_ASSEMBLY
, "Assembly image '%s' still loaded at shutdown.", image
->name
);
284 for(hash_idx
= 0; hash_idx
< IMAGES_HASH_COUNT
; hash_idx
++)
285 g_hash_table_destroy (loaded_images_hashes
[hash_idx
]);
287 mutex_inited
= FALSE
;
291 * mono_image_ensure_section_idx:
292 * @image: The image we are operating on
293 * @section: section number that we will load/map into memory
295 * This routine makes sure that we have an in-memory copy of
296 * an image section (.text, .rsrc, .data).
298 * Returns: TRUE on success
301 mono_image_ensure_section_idx (MonoImage
*image
, int section
)
303 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
304 MonoSectionTable
*sect
;
306 g_return_val_if_fail (section
< iinfo
->cli_section_count
, FALSE
);
308 if (iinfo
->cli_sections
[section
] != NULL
)
311 sect
= &iinfo
->cli_section_tables
[section
];
313 if (sect
->st_raw_data_ptr
+ sect
->st_raw_data_size
> image
->raw_data_len
)
316 if (image
->is_module_handle
)
317 iinfo
->cli_sections
[section
] = image
->raw_data
+ sect
->st_virtual_address
;
320 /* FIXME: we ignore the writable flag since we don't patch the binary */
321 iinfo
->cli_sections
[section
] = image
->raw_data
+ sect
->st_raw_data_ptr
;
326 * mono_image_ensure_section:
327 * @image: The image we are operating on
328 * @section: section name that we will load/map into memory
330 * This routine makes sure that we have an in-memory copy of
331 * an image section (.text, .rsrc, .data).
333 * Returns: TRUE on success
336 mono_image_ensure_section (MonoImage
*image
, const char *section
)
338 MonoCLIImageInfo
*ii
= (MonoCLIImageInfo
*)image
->image_info
;
341 for (i
= 0; i
< ii
->cli_section_count
; i
++){
342 if (strncmp (ii
->cli_section_tables
[i
].st_name
, section
, 8) != 0)
345 return mono_image_ensure_section_idx (image
, i
);
351 load_section_tables (MonoImage
*image
, MonoCLIImageInfo
*iinfo
, guint32 offset
)
353 const int top
= iinfo
->cli_header
.coff
.coff_sections
;
356 iinfo
->cli_section_count
= top
;
357 iinfo
->cli_section_tables
= g_new0 (MonoSectionTable
, top
);
358 iinfo
->cli_sections
= g_new0 (void *, top
);
360 for (i
= 0; i
< top
; i
++){
361 MonoSectionTable
*t
= &iinfo
->cli_section_tables
[i
];
363 if (offset
+ sizeof (MonoSectionTable
) > image
->raw_data_len
)
365 memcpy (t
, image
->raw_data
+ offset
, sizeof (MonoSectionTable
));
366 offset
+= sizeof (MonoSectionTable
);
368 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
369 t
->st_virtual_size
= GUINT32_FROM_LE (t
->st_virtual_size
);
370 t
->st_virtual_address
= GUINT32_FROM_LE (t
->st_virtual_address
);
371 t
->st_raw_data_size
= GUINT32_FROM_LE (t
->st_raw_data_size
);
372 t
->st_raw_data_ptr
= GUINT32_FROM_LE (t
->st_raw_data_ptr
);
373 t
->st_reloc_ptr
= GUINT32_FROM_LE (t
->st_reloc_ptr
);
374 t
->st_lineno_ptr
= GUINT32_FROM_LE (t
->st_lineno_ptr
);
375 t
->st_reloc_count
= GUINT16_FROM_LE (t
->st_reloc_count
);
376 t
->st_line_count
= GUINT16_FROM_LE (t
->st_line_count
);
377 t
->st_flags
= GUINT32_FROM_LE (t
->st_flags
);
379 /* consistency checks here */
386 mono_image_load_cli_header (MonoImage
*image
, MonoCLIImageInfo
*iinfo
)
390 offset
= mono_cli_rva_image_map (image
, iinfo
->cli_header
.datadir
.pe_cli_header
.rva
);
391 if (offset
== INVALID_ADDRESS
)
394 if (offset
+ sizeof (MonoCLIHeader
) > image
->raw_data_len
)
396 memcpy (&iinfo
->cli_cli_header
, image
->raw_data
+ offset
, sizeof (MonoCLIHeader
));
398 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
399 #define SWAP32(x) (x) = GUINT32_FROM_LE ((x))
400 #define SWAP16(x) (x) = GUINT16_FROM_LE ((x))
401 #define SWAPPDE(x) do { (x).rva = GUINT32_FROM_LE ((x).rva); (x).size = GUINT32_FROM_LE ((x).size);} while (0)
402 SWAP32 (iinfo
->cli_cli_header
.ch_size
);
403 SWAP32 (iinfo
->cli_cli_header
.ch_flags
);
404 SWAP32 (iinfo
->cli_cli_header
.ch_entry_point
);
405 SWAP16 (iinfo
->cli_cli_header
.ch_runtime_major
);
406 SWAP16 (iinfo
->cli_cli_header
.ch_runtime_minor
);
407 SWAPPDE (iinfo
->cli_cli_header
.ch_metadata
);
408 SWAPPDE (iinfo
->cli_cli_header
.ch_resources
);
409 SWAPPDE (iinfo
->cli_cli_header
.ch_strong_name
);
410 SWAPPDE (iinfo
->cli_cli_header
.ch_code_manager_table
);
411 SWAPPDE (iinfo
->cli_cli_header
.ch_vtable_fixups
);
412 SWAPPDE (iinfo
->cli_cli_header
.ch_export_address_table_jumps
);
413 SWAPPDE (iinfo
->cli_cli_header
.ch_eeinfo_table
);
414 SWAPPDE (iinfo
->cli_cli_header
.ch_helper_table
);
415 SWAPPDE (iinfo
->cli_cli_header
.ch_dynamic_info
);
416 SWAPPDE (iinfo
->cli_cli_header
.ch_delay_load_info
);
417 SWAPPDE (iinfo
->cli_cli_header
.ch_module_image
);
418 SWAPPDE (iinfo
->cli_cli_header
.ch_external_fixups
);
419 SWAPPDE (iinfo
->cli_cli_header
.ch_ridmap
);
420 SWAPPDE (iinfo
->cli_cli_header
.ch_debug_map
);
421 SWAPPDE (iinfo
->cli_cli_header
.ch_ip_map
);
426 /* Catch new uses of the fields that are supposed to be zero */
428 if ((iinfo
->cli_cli_header
.ch_eeinfo_table
.rva
!= 0) ||
429 (iinfo
->cli_cli_header
.ch_helper_table
.rva
!= 0) ||
430 (iinfo
->cli_cli_header
.ch_dynamic_info
.rva
!= 0) ||
431 (iinfo
->cli_cli_header
.ch_delay_load_info
.rva
!= 0) ||
432 (iinfo
->cli_cli_header
.ch_module_image
.rva
!= 0) ||
433 (iinfo
->cli_cli_header
.ch_external_fixups
.rva
!= 0) ||
434 (iinfo
->cli_cli_header
.ch_ridmap
.rva
!= 0) ||
435 (iinfo
->cli_cli_header
.ch_debug_map
.rva
!= 0) ||
436 (iinfo
->cli_cli_header
.ch_ip_map
.rva
!= 0)){
439 * No need to scare people who are testing this, I am just
440 * labelling this as a LAMESPEC
442 /* g_warning ("Some fields in the CLI header which should have been zero are not zero"); */
450 load_metadata_ptrs (MonoImage
*image
, MonoCLIImageInfo
*iinfo
)
452 guint32 offset
, size
;
458 offset
= mono_cli_rva_image_map (image
, iinfo
->cli_cli_header
.ch_metadata
.rva
);
459 if (offset
== INVALID_ADDRESS
)
462 size
= iinfo
->cli_cli_header
.ch_metadata
.size
;
464 if (offset
+ size
> image
->raw_data_len
)
466 image
->raw_metadata
= image
->raw_data
+ offset
;
468 /* 24.2.1: Metadata root starts here */
469 ptr
= image
->raw_metadata
;
471 if (strncmp (ptr
, "BSJB", 4) == 0){
472 guint32 version_string_len
;
475 image
->md_version_major
= read16 (ptr
);
477 image
->md_version_minor
= read16 (ptr
);
480 version_string_len
= read32 (ptr
);
482 image
->version
= g_strndup (ptr
, version_string_len
);
483 ptr
+= version_string_len
;
484 pad
= ptr
- image
->raw_metadata
;
486 ptr
+= 4 - (pad
% 4);
490 /* skip over flags */
493 streams
= read16 (ptr
);
496 for (i
= 0; i
< streams
; i
++){
497 if (strncmp (ptr
+ 8, "#~", 3) == 0){
498 image
->heap_tables
.data
= image
->raw_metadata
+ read32 (ptr
);
499 image
->heap_tables
.size
= read32 (ptr
+ 4);
501 } else if (strncmp (ptr
+ 8, "#Strings", 9) == 0){
502 image
->heap_strings
.data
= image
->raw_metadata
+ read32 (ptr
);
503 image
->heap_strings
.size
= read32 (ptr
+ 4);
505 } else if (strncmp (ptr
+ 8, "#US", 4) == 0){
506 image
->heap_us
.data
= image
->raw_metadata
+ read32 (ptr
);
507 image
->heap_us
.size
= read32 (ptr
+ 4);
509 } else if (strncmp (ptr
+ 8, "#Blob", 6) == 0){
510 image
->heap_blob
.data
= image
->raw_metadata
+ read32 (ptr
);
511 image
->heap_blob
.size
= read32 (ptr
+ 4);
513 } else if (strncmp (ptr
+ 8, "#GUID", 6) == 0){
514 image
->heap_guid
.data
= image
->raw_metadata
+ read32 (ptr
);
515 image
->heap_guid
.size
= read32 (ptr
+ 4);
517 } else if (strncmp (ptr
+ 8, "#-", 3) == 0) {
518 image
->heap_tables
.data
= image
->raw_metadata
+ read32 (ptr
);
519 image
->heap_tables
.size
= read32 (ptr
+ 4);
521 image
->uncompressed_metadata
= TRUE
;
522 mono_trace (G_LOG_LEVEL_INFO
, MONO_TRACE_ASSEMBLY
, "Assembly '%s' has the non-standard metadata heap #-.\nRecompile it correctly (without the /incremental switch or in Release mode).\n", image
->name
);
523 } else if (strncmp (ptr
+ 8, "#Pdb", 5) == 0) {
524 image
->heap_pdb
.data
= image
->raw_metadata
+ read32 (ptr
);
525 image
->heap_pdb
.size
= read32 (ptr
+ 4);
528 g_message ("Unknown heap type: %s\n", ptr
+ 8);
529 ptr
+= 8 + strlen (ptr
+ 8) + 1;
531 pad
= ptr
- image
->raw_metadata
;
533 ptr
+= 4 - (pad
% 4);
536 i
= ((MonoImageLoader
*)image
->loader
)->load_tables (image
);
537 g_assert (image
->heap_guid
.data
);
539 if (!image
->metadata_only
) {
540 g_assert (image
->heap_guid
.size
>= 16);
542 image
->guid
= mono_guid_to_string ((guint8
*)image
->heap_guid
.data
);
544 /* PPDB files have no guid */
545 guint8 empty_guid
[16];
547 memset (empty_guid
, 0, sizeof (empty_guid
));
549 image
->guid
= mono_guid_to_string (empty_guid
);
556 * Load representation of logical metadata tables, from the "#~" stream
559 load_tables (MonoImage
*image
)
561 const char *heap_tables
= image
->heap_tables
.data
;
564 int valid
= 0, table
;
567 heap_sizes
= heap_tables
[6];
568 image
->idx_string_wide
= ((heap_sizes
& 0x01) == 1);
569 image
->idx_guid_wide
= ((heap_sizes
& 0x02) == 2);
570 image
->idx_blob_wide
= ((heap_sizes
& 0x04) == 4);
572 valid_mask
= read64 (heap_tables
+ 8);
573 rows
= (const guint32
*) (heap_tables
+ 24);
575 for (table
= 0; table
< 64; table
++){
576 if ((valid_mask
& ((guint64
) 1 << table
)) == 0){
577 if (table
> MONO_TABLE_LAST
)
579 image
->tables
[table
].rows
= 0;
582 if (table
> MONO_TABLE_LAST
) {
583 g_warning("bits in valid must be zero above 0x37 (II - 23.1.6)");
585 image
->tables
[table
].rows
= read32 (rows
);
591 image
->tables_base
= (heap_tables
+ 24) + (4 * valid
);
593 /* They must be the same */
594 g_assert ((const void *) image
->tables_base
== (const void *) rows
);
596 mono_metadata_compute_table_bases (image
);
601 mono_image_load_metadata (MonoImage
*image
, MonoCLIImageInfo
*iinfo
)
603 if (!load_metadata_ptrs (image
, iinfo
))
606 return load_tables (image
);
610 mono_image_check_for_module_cctor (MonoImage
*image
)
612 MonoTableInfo
*t
, *mt
;
613 t
= &image
->tables
[MONO_TABLE_TYPEDEF
];
614 mt
= &image
->tables
[MONO_TABLE_METHOD
];
615 if (image_is_dynamic (image
)) {
617 image
->checked_module_cctor
= TRUE
;
621 guint32 nameidx
= mono_metadata_decode_row_col (t
, 0, MONO_TYPEDEF_NAME
);
622 const char *name
= mono_metadata_string_heap (image
, nameidx
);
623 if (strcmp (name
, "<Module>") == 0) {
624 guint32 first_method
= mono_metadata_decode_row_col (t
, 0, MONO_TYPEDEF_METHOD_LIST
) - 1;
627 last_method
= mono_metadata_decode_row_col (t
, 1, MONO_TYPEDEF_METHOD_LIST
) - 1;
629 last_method
= mt
->rows
;
630 for (; first_method
< last_method
; first_method
++) {
631 nameidx
= mono_metadata_decode_row_col (mt
, first_method
, MONO_METHOD_NAME
);
632 name
= mono_metadata_string_heap (image
, nameidx
);
633 if (strcmp (name
, ".cctor") == 0) {
634 image
->has_module_cctor
= TRUE
;
635 image
->checked_module_cctor
= TRUE
;
641 image
->has_module_cctor
= FALSE
;
642 image
->checked_module_cctor
= TRUE
;
646 load_modules (MonoImage
*image
)
653 t
= &image
->tables
[MONO_TABLE_MODULEREF
];
654 image
->modules
= g_new0 (MonoImage
*, t
->rows
);
655 image
->modules_loaded
= g_new0 (gboolean
, t
->rows
);
656 image
->module_count
= t
->rows
;
660 * mono_image_load_module_checked:
662 * Load the module with the one-based index IDX from IMAGE and return it. Return NULL if
663 * it cannot be loaded. NULL without MonoError being set will be interpreted as "not found".
666 mono_image_load_module_checked (MonoImage
*image
, int idx
, MonoError
*error
)
669 MonoTableInfo
*file_table
;
672 gboolean refonly
= image
->ref_only
;
673 GList
*list_iter
, *valid_modules
= NULL
;
674 MonoImageOpenStatus status
;
676 if ((image
->module_count
== 0) || (idx
> image
->module_count
|| idx
<= 0))
678 if (image
->modules_loaded
[idx
- 1])
679 return image
->modules
[idx
- 1];
681 file_table
= &image
->tables
[MONO_TABLE_FILE
];
682 for (i
= 0; i
< file_table
->rows
; i
++) {
683 guint32 cols
[MONO_FILE_SIZE
];
684 mono_metadata_decode_row (file_table
, i
, cols
, MONO_FILE_SIZE
);
685 if (cols
[MONO_FILE_FLAGS
] == FILE_CONTAINS_NO_METADATA
)
687 valid_modules
= g_list_prepend (valid_modules
, (char*)mono_metadata_string_heap (image
, cols
[MONO_FILE_NAME
]));
690 t
= &image
->tables
[MONO_TABLE_MODULEREF
];
691 base_dir
= g_path_get_dirname (image
->name
);
696 guint32 cols
[MONO_MODULEREF_SIZE
];
697 /* if there is no file table, we try to load the module... */
698 int valid
= file_table
->rows
== 0;
700 mono_metadata_decode_row (t
, idx
- 1, cols
, MONO_MODULEREF_SIZE
);
701 name
= mono_metadata_string_heap (image
, cols
[MONO_MODULEREF_NAME
]);
702 for (list_iter
= valid_modules
; list_iter
; list_iter
= list_iter
->next
) {
703 /* be safe with string dups, but we could just compare string indexes */
704 if (strcmp (list_iter
->data
, name
) == 0) {
710 module_ref
= g_build_filename (base_dir
, name
, NULL
);
711 MonoImage
*moduleImage
= mono_image_open_full (module_ref
, &status
, refonly
);
712 if (image
->modules
[idx
- 1]) {
713 g_assert(!image
->modules
[idx
- 1]->assembly
|| image
->modules
[idx
- 1]->assembly
== image
->assembly
);
714 image
->modules
[idx
- 1]->assembly
= image
->assembly
;
716 if (!assign_assembly_parent_for_netmodule (moduleImage
, image
, error
)) {
717 mono_image_close (moduleImage
);
720 g_list_free (valid_modules
);
724 image
->modules
[idx
- 1] = image
;
727 if (image
->modules
[idx
- 1]->is_module_handle
)
728 mono_image_fixup_vtable (image
->modules
[idx
- 1]);
730 /* g_print ("loaded module %s from %s (%p)\n", module_ref, image->name, image->assembly); */
736 image
->modules_loaded
[idx
- 1] = TRUE
;
739 g_list_free (valid_modules
);
741 return image
->modules
[idx
- 1];
745 mono_image_load_module (MonoImage
*image
, int idx
)
748 mono_error_init (&error
);
749 MonoImage
*result
= mono_image_load_module_checked (image
, idx
, &error
);
750 mono_error_assert_ok (&error
);
751 mono_error_cleanup (&error
);
756 class_key_extract (gpointer value
)
758 MonoClass
*klass
= (MonoClass
*)value
;
760 return GUINT_TO_POINTER (klass
->type_token
);
764 class_next_value (gpointer value
)
766 MonoClass
*klass
= (MonoClass
*)value
;
768 return (gpointer
*)&klass
->next_class_cache
;
772 mono_image_init (MonoImage
*image
)
774 mono_os_mutex_init_recursive (&image
->lock
);
775 mono_os_mutex_init_recursive (&image
->szarray_cache_lock
);
777 image
->mempool
= mono_mempool_new_size (INITIAL_IMAGE_SIZE
);
778 mono_internal_hash_table_init (&image
->class_cache
,
782 image
->field_cache
= mono_conc_hashtable_new (NULL
, NULL
);
784 image
->typespec_cache
= g_hash_table_new (NULL
, NULL
);
785 image
->memberref_signatures
= g_hash_table_new (NULL
, NULL
);
786 image
->helper_signatures
= g_hash_table_new (g_str_hash
, g_str_equal
);
787 image
->method_signatures
= g_hash_table_new (NULL
, NULL
);
789 image
->property_hash
= mono_property_hash_new ();
792 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
793 #define SWAP64(x) (x) = GUINT64_FROM_LE ((x))
794 #define SWAP32(x) (x) = GUINT32_FROM_LE ((x))
795 #define SWAP16(x) (x) = GUINT16_FROM_LE ((x))
796 #define SWAPPDE(x) do { (x).rva = GUINT32_FROM_LE ((x).rva); (x).size = GUINT32_FROM_LE ((x).size);} while (0)
805 * Returns < 0 to indicate an error.
808 do_load_header (MonoImage
*image
, MonoDotNetHeader
*header
, int offset
)
810 MonoDotNetHeader64 header64
;
813 if (!image
->is_module_handle
)
815 if (offset
+ sizeof (MonoDotNetHeader32
) > image
->raw_data_len
)
818 memcpy (header
, image
->raw_data
+ offset
, sizeof (MonoDotNetHeader
));
820 if (header
->pesig
[0] != 'P' || header
->pesig
[1] != 'E')
823 /* endian swap the fields common between PE and PE+ */
824 SWAP32 (header
->coff
.coff_time
);
825 SWAP32 (header
->coff
.coff_symptr
);
826 SWAP32 (header
->coff
.coff_symcount
);
827 SWAP16 (header
->coff
.coff_machine
);
828 SWAP16 (header
->coff
.coff_sections
);
829 SWAP16 (header
->coff
.coff_opt_header_size
);
830 SWAP16 (header
->coff
.coff_attributes
);
832 SWAP32 (header
->pe
.pe_code_size
);
833 SWAP32 (header
->pe
.pe_uninit_data_size
);
834 SWAP32 (header
->pe
.pe_rva_entry_point
);
835 SWAP32 (header
->pe
.pe_rva_code_base
);
836 SWAP32 (header
->pe
.pe_rva_data_base
);
837 SWAP16 (header
->pe
.pe_magic
);
839 /* now we are ready for the basic tests */
841 if (header
->pe
.pe_magic
== 0x10B) {
842 offset
+= sizeof (MonoDotNetHeader
);
843 SWAP32 (header
->pe
.pe_data_size
);
844 if (header
->coff
.coff_opt_header_size
!= (sizeof (MonoDotNetHeader
) - sizeof (MonoCOFFHeader
) - 4))
847 SWAP32 (header
->nt
.pe_image_base
); /* must be 0x400000 */
848 SWAP32 (header
->nt
.pe_stack_reserve
);
849 SWAP32 (header
->nt
.pe_stack_commit
);
850 SWAP32 (header
->nt
.pe_heap_reserve
);
851 SWAP32 (header
->nt
.pe_heap_commit
);
852 } else if (header
->pe
.pe_magic
== 0x20B) {
853 /* PE32+ file format */
854 if (header
->coff
.coff_opt_header_size
!= (sizeof (MonoDotNetHeader64
) - sizeof (MonoCOFFHeader
) - 4))
856 memcpy (&header64
, image
->raw_data
+ offset
, sizeof (MonoDotNetHeader64
));
857 offset
+= sizeof (MonoDotNetHeader64
);
858 /* copy the fields already swapped. the last field, pe_data_size, is missing */
859 memcpy (&header64
, header
, sizeof (MonoDotNetHeader
) - 4);
860 /* FIXME: we lose bits here, but we don't use this stuff internally, so we don't care much.
861 * will be fixed when we change MonoDotNetHeader to not match the 32 bit variant
863 SWAP64 (header64
.nt
.pe_image_base
);
864 header
->nt
.pe_image_base
= header64
.nt
.pe_image_base
;
865 SWAP64 (header64
.nt
.pe_stack_reserve
);
866 header
->nt
.pe_stack_reserve
= header64
.nt
.pe_stack_reserve
;
867 SWAP64 (header64
.nt
.pe_stack_commit
);
868 header
->nt
.pe_stack_commit
= header64
.nt
.pe_stack_commit
;
869 SWAP64 (header64
.nt
.pe_heap_reserve
);
870 header
->nt
.pe_heap_reserve
= header64
.nt
.pe_heap_reserve
;
871 SWAP64 (header64
.nt
.pe_heap_commit
);
872 header
->nt
.pe_heap_commit
= header64
.nt
.pe_heap_commit
;
874 header
->nt
.pe_section_align
= header64
.nt
.pe_section_align
;
875 header
->nt
.pe_file_alignment
= header64
.nt
.pe_file_alignment
;
876 header
->nt
.pe_os_major
= header64
.nt
.pe_os_major
;
877 header
->nt
.pe_os_minor
= header64
.nt
.pe_os_minor
;
878 header
->nt
.pe_user_major
= header64
.nt
.pe_user_major
;
879 header
->nt
.pe_user_minor
= header64
.nt
.pe_user_minor
;
880 header
->nt
.pe_subsys_major
= header64
.nt
.pe_subsys_major
;
881 header
->nt
.pe_subsys_minor
= header64
.nt
.pe_subsys_minor
;
882 header
->nt
.pe_reserved_1
= header64
.nt
.pe_reserved_1
;
883 header
->nt
.pe_image_size
= header64
.nt
.pe_image_size
;
884 header
->nt
.pe_header_size
= header64
.nt
.pe_header_size
;
885 header
->nt
.pe_checksum
= header64
.nt
.pe_checksum
;
886 header
->nt
.pe_subsys_required
= header64
.nt
.pe_subsys_required
;
887 header
->nt
.pe_dll_flags
= header64
.nt
.pe_dll_flags
;
888 header
->nt
.pe_loader_flags
= header64
.nt
.pe_loader_flags
;
889 header
->nt
.pe_data_dir_count
= header64
.nt
.pe_data_dir_count
;
891 /* copy the datadir */
892 memcpy (&header
->datadir
, &header64
.datadir
, sizeof (MonoPEDatadir
));
897 /* MonoPEHeaderNT: not used yet */
898 SWAP32 (header
->nt
.pe_section_align
); /* must be 8192 */
899 SWAP32 (header
->nt
.pe_file_alignment
); /* must be 512 or 4096 */
900 SWAP16 (header
->nt
.pe_os_major
); /* must be 4 */
901 SWAP16 (header
->nt
.pe_os_minor
); /* must be 0 */
902 SWAP16 (header
->nt
.pe_user_major
);
903 SWAP16 (header
->nt
.pe_user_minor
);
904 SWAP16 (header
->nt
.pe_subsys_major
);
905 SWAP16 (header
->nt
.pe_subsys_minor
);
906 SWAP32 (header
->nt
.pe_reserved_1
);
907 SWAP32 (header
->nt
.pe_image_size
);
908 SWAP32 (header
->nt
.pe_header_size
);
909 SWAP32 (header
->nt
.pe_checksum
);
910 SWAP16 (header
->nt
.pe_subsys_required
);
911 SWAP16 (header
->nt
.pe_dll_flags
);
912 SWAP32 (header
->nt
.pe_loader_flags
);
913 SWAP32 (header
->nt
.pe_data_dir_count
);
915 /* MonoDotNetHeader: mostly unused */
916 SWAPPDE (header
->datadir
.pe_export_table
);
917 SWAPPDE (header
->datadir
.pe_import_table
);
918 SWAPPDE (header
->datadir
.pe_resource_table
);
919 SWAPPDE (header
->datadir
.pe_exception_table
);
920 SWAPPDE (header
->datadir
.pe_certificate_table
);
921 SWAPPDE (header
->datadir
.pe_reloc_table
);
922 SWAPPDE (header
->datadir
.pe_debug
);
923 SWAPPDE (header
->datadir
.pe_copyright
);
924 SWAPPDE (header
->datadir
.pe_global_ptr
);
925 SWAPPDE (header
->datadir
.pe_tls_table
);
926 SWAPPDE (header
->datadir
.pe_load_config_table
);
927 SWAPPDE (header
->datadir
.pe_bound_import
);
928 SWAPPDE (header
->datadir
.pe_iat
);
929 SWAPPDE (header
->datadir
.pe_delay_import_desc
);
930 SWAPPDE (header
->datadir
.pe_cli_header
);
931 SWAPPDE (header
->datadir
.pe_reserved
);
934 if (image
->is_module_handle
)
935 image
->raw_data_len
= header
->nt
.pe_image_size
;
942 mono_image_load_pe_data (MonoImage
*image
)
944 return ((MonoImageLoader
*)image
->loader
)->load_pe_data (image
);
948 pe_image_load_pe_data (MonoImage
*image
)
950 MonoCLIImageInfo
*iinfo
;
951 MonoDotNetHeader
*header
;
952 MonoMSDOSHeader msdos
;
955 iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
956 header
= &iinfo
->cli_header
;
959 if (!image
->is_module_handle
)
961 if (offset
+ sizeof (msdos
) > image
->raw_data_len
)
963 memcpy (&msdos
, image
->raw_data
+ offset
, sizeof (msdos
));
965 if (!(msdos
.msdos_sig
[0] == 'M' && msdos
.msdos_sig
[1] == 'Z'))
968 msdos
.pe_offset
= GUINT32_FROM_LE (msdos
.pe_offset
);
970 offset
= msdos
.pe_offset
;
972 offset
= do_load_header (image
, header
, offset
);
977 * this tests for a x86 machine type, but itanium, amd64 and others could be used, too.
979 if (header->coff.coff_machine != 0x14c)
985 * The spec says that this field should contain 6.0, but Visual Studio includes a new compiler,
986 * which produces binaries with 7.0. From Sergey:
988 * The reason is that MSVC7 uses traditional compile/link
989 * sequence for CIL executables, and VS.NET (and Framework
990 * SDK) includes linker version 7, that puts 7.0 in this
991 * field. That's why it's currently not possible to load VC
992 * binaries with Mono. This field is pretty much meaningless
993 * anyway (what linker?).
995 if (header
->pe
.pe_major
!= 6 || header
->pe
.pe_minor
!= 0)
1000 * FIXME: byte swap all addresses here for header.
1003 if (!load_section_tables (image
, iinfo
, offset
))
1013 mono_image_load_cli_data (MonoImage
*image
)
1015 return ((MonoImageLoader
*)image
->loader
)->load_cli_data (image
);
1019 pe_image_load_cli_data (MonoImage
*image
)
1021 MonoCLIImageInfo
*iinfo
;
1022 MonoDotNetHeader
*header
;
1024 iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
1025 header
= &iinfo
->cli_header
;
1027 /* Load the CLI header */
1028 if (!mono_image_load_cli_header (image
, iinfo
))
1031 if (!mono_image_load_metadata (image
, iinfo
))
1038 mono_image_load_names (MonoImage
*image
)
1040 /* modules don't have an assembly table row */
1041 if (image
->tables
[MONO_TABLE_ASSEMBLY
].rows
) {
1042 image
->assembly_name
= mono_metadata_string_heap (image
,
1043 mono_metadata_decode_row_col (&image
->tables
[MONO_TABLE_ASSEMBLY
],
1044 0, MONO_ASSEMBLY_NAME
));
1047 /* Portable pdb images don't have a MODULE row */
1048 if (image
->tables
[MONO_TABLE_MODULE
].rows
) {
1049 image
->module_name
= mono_metadata_string_heap (image
,
1050 mono_metadata_decode_row_col (&image
->tables
[MONO_TABLE_MODULE
],
1051 0, MONO_MODULE_NAME
));
1056 pe_image_load_tables (MonoImage
*image
)
1062 pe_image_match (MonoImage
*image
)
1064 if (image
->raw_data
[0] == 'M' && image
->raw_data
[1] == 'Z')
1069 static const MonoImageLoader pe_loader
= {
1071 pe_image_load_pe_data
,
1072 pe_image_load_cli_data
,
1073 pe_image_load_tables
,
1077 install_pe_loader (void)
1079 mono_install_image_loader (&pe_loader
);
1083 do_mono_image_load (MonoImage
*image
, MonoImageOpenStatus
*status
,
1084 gboolean care_about_cli
, gboolean care_about_pecoff
)
1086 MonoCLIImageInfo
*iinfo
;
1087 MonoDotNetHeader
*header
;
1088 GSList
*errors
= NULL
;
1091 mono_profiler_module_event (image
, MONO_PROFILE_START_LOAD
);
1093 mono_image_init (image
);
1095 iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
1096 header
= &iinfo
->cli_header
;
1098 if (!image
->metadata_only
) {
1099 for (l
= image_loaders
; l
; l
= l
->next
) {
1100 MonoImageLoader
*loader
= (MonoImageLoader
*)l
->data
;
1101 if (loader
->match (image
)) {
1102 image
->loader
= loader
;
1106 if (!image
->loader
) {
1108 *status
= MONO_IMAGE_IMAGE_INVALID
;
1113 *status
= MONO_IMAGE_IMAGE_INVALID
;
1115 if (care_about_pecoff
== FALSE
)
1118 if (image
->loader
== &pe_loader
&& !mono_verifier_verify_pe_data (image
, &errors
))
1121 if (!mono_image_load_pe_data (image
))
1124 image
->loader
= (MonoImageLoader
*)&pe_loader
;
1127 if (care_about_cli
== FALSE
) {
1131 if (image
->loader
== &pe_loader
&& !image
->metadata_only
&& !mono_verifier_verify_cli_data (image
, &errors
))
1134 if (!mono_image_load_cli_data (image
))
1137 if (image
->loader
== &pe_loader
&& !image
->metadata_only
&& !mono_verifier_verify_table_data (image
, &errors
))
1140 mono_image_load_names (image
);
1142 load_modules (image
);
1145 mono_profiler_module_loaded (image
, MONO_PROFILE_OK
);
1147 *status
= MONO_IMAGE_OK
;
1153 MonoVerifyInfo
*info
= (MonoVerifyInfo
*)errors
->data
;
1154 g_warning ("Could not load image %s due to %s", image
->name
, info
->message
);
1155 mono_free_verify_list (errors
);
1157 mono_profiler_module_loaded (image
, MONO_PROFILE_FAILED
);
1158 mono_image_close (image
);
1163 do_mono_image_open (const char *fname
, MonoImageOpenStatus
*status
,
1164 gboolean care_about_cli
, gboolean care_about_pecoff
, gboolean refonly
, gboolean metadata_only
)
1166 MonoCLIImageInfo
*iinfo
;
1170 if ((filed
= mono_file_map_open (fname
)) == NULL
){
1171 if (IS_PORTABILITY_SET
) {
1172 gchar
*ffname
= mono_portability_find_file (fname
, TRUE
);
1174 filed
= mono_file_map_open (ffname
);
1179 if (filed
== NULL
) {
1181 *status
= MONO_IMAGE_ERROR_ERRNO
;
1186 image
= g_new0 (MonoImage
, 1);
1187 image
->raw_buffer_used
= TRUE
;
1188 image
->raw_data_len
= mono_file_map_size (filed
);
1189 image
->raw_data
= (char *)mono_file_map (image
->raw_data_len
, MONO_MMAP_READ
|MONO_MMAP_PRIVATE
, mono_file_map_fd (filed
), 0, &image
->raw_data_handle
);
1190 #if defined(HAVE_MMAP) && !defined (HOST_WIN32)
1191 if (!image
->raw_data
) {
1192 image
->fileio_used
= TRUE
;
1193 image
->raw_data
= (char *)mono_file_map_fileio (image
->raw_data_len
, MONO_MMAP_READ
|MONO_MMAP_PRIVATE
, mono_file_map_fd (filed
), 0, &image
->raw_data_handle
);
1196 if (!image
->raw_data
) {
1197 mono_file_map_close (filed
);
1200 *status
= MONO_IMAGE_IMAGE_INVALID
;
1203 iinfo
= g_new0 (MonoCLIImageInfo
, 1);
1204 image
->image_info
= iinfo
;
1205 image
->name
= mono_path_resolve_symlinks (fname
);
1206 image
->ref_only
= refonly
;
1207 image
->metadata_only
= metadata_only
;
1208 image
->ref_count
= 1;
1209 /* if MONO_SECURITY_MODE_CORE_CLR is set then determine if this image is platform code */
1210 image
->core_clr_platform_code
= mono_security_core_clr_determine_platform_image (image
);
1212 mono_file_map_close (filed
);
1213 return do_mono_image_load (image
, status
, care_about_cli
, care_about_pecoff
);
1217 * mono_image_loaded:
1218 * @name: path or assembly name of the image to load
1219 * @refonly: Check with respect to reflection-only loads?
1221 * This routine verifies that the given image is loaded.
1222 * It checks either reflection-only loads only, or normal loads only, as specified by parameter.
1224 * Returns: the loaded MonoImage, or NULL on failure.
1227 mono_image_loaded_full (const char *name
, gboolean refonly
)
1231 mono_images_lock ();
1232 res
= (MonoImage
*)g_hash_table_lookup (get_loaded_images_hash (refonly
), name
);
1234 res
= (MonoImage
*)g_hash_table_lookup (get_loaded_images_by_name_hash (refonly
), name
);
1235 mono_images_unlock ();
1241 * mono_image_loaded:
1242 * @name: path or assembly name of the image to load
1244 * This routine verifies that the given image is loaded. Reflection-only loads do not count.
1246 * Returns: the loaded MonoImage, or NULL on failure.
1249 mono_image_loaded (const char *name
)
1251 return mono_image_loaded_full (name
, FALSE
);
1260 find_by_guid (gpointer key
, gpointer val
, gpointer user_data
)
1262 GuidData
*data
= (GuidData
*)user_data
;
1267 image
= (MonoImage
*)val
;
1268 if (strcmp (data
->guid
, mono_image_get_guid (image
)) == 0)
1273 mono_image_loaded_by_guid_full (const char *guid
, gboolean refonly
)
1276 GHashTable
*loaded_images
= get_loaded_images_hash (refonly
);
1280 mono_images_lock ();
1281 g_hash_table_foreach (loaded_images
, find_by_guid
, &data
);
1282 mono_images_unlock ();
1287 mono_image_loaded_by_guid (const char *guid
)
1289 return mono_image_loaded_by_guid_full (guid
, FALSE
);
1293 register_image (MonoImage
*image
)
1296 GHashTable
*loaded_images
= get_loaded_images_hash (image
->ref_only
);
1298 mono_images_lock ();
1299 image2
= (MonoImage
*)g_hash_table_lookup (loaded_images
, image
->name
);
1302 /* Somebody else beat us to it */
1303 mono_image_addref (image2
);
1304 mono_images_unlock ();
1305 mono_image_close (image
);
1309 GHashTable
*loaded_images_by_name
= get_loaded_images_by_name_hash (image
->ref_only
);
1310 g_hash_table_insert (loaded_images
, image
->name
, image
);
1311 if (image
->assembly_name
&& (g_hash_table_lookup (loaded_images_by_name
, image
->assembly_name
) == NULL
))
1312 g_hash_table_insert (loaded_images_by_name
, (char *) image
->assembly_name
, image
);
1313 mono_images_unlock ();
1319 mono_image_open_from_data_internal (char *data
, guint32 data_len
, gboolean need_copy
, MonoImageOpenStatus
*status
, gboolean refonly
, gboolean metadata_only
, const char *name
)
1321 MonoCLIImageInfo
*iinfo
;
1325 if (!data
|| !data_len
) {
1327 *status
= MONO_IMAGE_IMAGE_INVALID
;
1332 datac
= (char *)g_try_malloc (data_len
);
1335 *status
= MONO_IMAGE_ERROR_ERRNO
;
1338 memcpy (datac
, data
, data_len
);
1341 image
= g_new0 (MonoImage
, 1);
1342 image
->raw_data
= datac
;
1343 image
->raw_data_len
= data_len
;
1344 image
->raw_data_allocated
= need_copy
;
1345 image
->name
= (name
== NULL
) ? g_strdup_printf ("data-%p", datac
) : g_strdup(name
);
1346 iinfo
= g_new0 (MonoCLIImageInfo
, 1);
1347 image
->image_info
= iinfo
;
1348 image
->ref_only
= refonly
;
1349 image
->metadata_only
= metadata_only
;
1350 image
->ref_count
= 1;
1352 image
= do_mono_image_load (image
, status
, TRUE
, TRUE
);
1356 return register_image (image
);
1360 mono_image_open_from_data_with_name (char *data
, guint32 data_len
, gboolean need_copy
, MonoImageOpenStatus
*status
, gboolean refonly
, const char *name
)
1362 return mono_image_open_from_data_internal (data
, data_len
, need_copy
, status
, refonly
, FALSE
, name
);
1366 mono_image_open_from_data_full (char *data
, guint32 data_len
, gboolean need_copy
, MonoImageOpenStatus
*status
, gboolean refonly
)
1368 return mono_image_open_from_data_with_name (data
, data_len
, need_copy
, status
, refonly
, NULL
);
1372 mono_image_open_from_data (char *data
, guint32 data_len
, gboolean need_copy
, MonoImageOpenStatus
*status
)
1374 return mono_image_open_from_data_full (data
, data_len
, need_copy
, status
, FALSE
);
1378 /* fname is not duplicated. */
1380 mono_image_open_from_module_handle (HMODULE module_handle
, char* fname
, gboolean has_entry_point
, MonoImageOpenStatus
* status
)
1383 MonoCLIImageInfo
* iinfo
;
1385 image
= g_new0 (MonoImage
, 1);
1386 image
->raw_data
= (char*) module_handle
;
1387 image
->is_module_handle
= TRUE
;
1388 iinfo
= g_new0 (MonoCLIImageInfo
, 1);
1389 image
->image_info
= iinfo
;
1390 image
->name
= fname
;
1391 image
->ref_count
= has_entry_point
? 0 : 1;
1392 image
->has_entry_point
= has_entry_point
;
1394 image
= do_mono_image_load (image
, status
, TRUE
, TRUE
);
1398 return register_image (image
);
1403 mono_image_open_full (const char *fname
, MonoImageOpenStatus
*status
, gboolean refonly
)
1406 GHashTable
*loaded_images
= get_loaded_images_hash (refonly
);
1409 g_return_val_if_fail (fname
!= NULL
, NULL
);
1412 // Win32 path: If we are running with mixed-mode assemblies enabled (ie have loaded mscoree.dll),
1413 // then assemblies need to be loaded with LoadLibrary:
1414 if (!refonly
&& coree_module_handle
) {
1415 HMODULE module_handle
;
1416 guint16
*fname_utf16
;
1419 absfname
= mono_path_resolve_symlinks (fname
);
1422 /* There is little overhead because the OS loader lock is held by LoadLibrary. */
1423 mono_images_lock ();
1424 image
= g_hash_table_lookup (loaded_images
, absfname
);
1425 if (image
) { // Image already loaded
1426 g_assert (image
->is_module_handle
);
1427 if (image
->has_entry_point
&& image
->ref_count
== 0) {
1428 /* Increment reference count on images loaded outside of the runtime. */
1429 fname_utf16
= g_utf8_to_utf16 (absfname
, -1, NULL
, NULL
, NULL
);
1430 /* The image is already loaded because _CorDllMain removes images from the hash. */
1431 module_handle
= LoadLibrary (fname_utf16
);
1432 g_assert (module_handle
== (HMODULE
) image
->raw_data
);
1434 mono_image_addref (image
);
1435 mono_images_unlock ();
1437 g_free (fname_utf16
);
1442 // Image not loaded, load it now
1443 fname_utf16
= g_utf8_to_utf16 (absfname
, -1, NULL
, NULL
, NULL
);
1444 module_handle
= MonoLoadImage (fname_utf16
);
1445 if (status
&& module_handle
== NULL
)
1446 last_error
= GetLastError ();
1448 /* mono_image_open_from_module_handle is called by _CorDllMain. */
1449 image
= g_hash_table_lookup (loaded_images
, absfname
);
1451 mono_image_addref (image
);
1452 mono_images_unlock ();
1454 g_free (fname_utf16
);
1456 if (module_handle
== NULL
) {
1460 if (last_error
== ERROR_BAD_EXE_FORMAT
|| last_error
== STATUS_INVALID_IMAGE_FORMAT
)
1461 *status
= MONO_IMAGE_IMAGE_INVALID
;
1463 if (last_error
== ERROR_FILE_NOT_FOUND
|| last_error
== ERROR_PATH_NOT_FOUND
)
1473 g_assert (image
->is_module_handle
);
1474 g_assert (image
->has_entry_point
);
1479 return mono_image_open_from_module_handle (module_handle
, absfname
, FALSE
, status
);
1483 absfname
= mono_path_canonicalize (fname
);
1486 * The easiest solution would be to do all the loading inside the mutex,
1487 * but that would lead to scalability problems. So we let the loading
1488 * happen outside the mutex, and if multiple threads happen to load
1489 * the same image, we discard all but the first copy.
1491 mono_images_lock ();
1492 image
= (MonoImage
*)g_hash_table_lookup (loaded_images
, absfname
);
1495 if (image
) { // Image already loaded
1496 mono_image_addref (image
);
1497 mono_images_unlock ();
1500 mono_images_unlock ();
1502 // Image not loaded, load it now
1503 image
= do_mono_image_open (fname
, status
, TRUE
, TRUE
, refonly
, FALSE
);
1507 return register_image (image
);
1512 * @fname: filename that points to the module we want to open
1513 * @status: An error condition is returned in this field
1515 * Returns: An open image of type %MonoImage or NULL on error.
1516 * The caller holds a temporary reference to the returned image which should be cleared
1517 * when no longer needed by calling mono_image_close ().
1518 * if NULL, then check the value of @status for details on the error
1521 mono_image_open (const char *fname
, MonoImageOpenStatus
*status
)
1523 return mono_image_open_full (fname
, status
, FALSE
);
1527 * mono_pe_file_open:
1528 * @fname: filename that points to the module we want to open
1529 * @status: An error condition is returned in this field
1531 * Returns: An open image of type %MonoImage or NULL on error. if
1532 * NULL, then check the value of @status for details on the error.
1533 * This variant for mono_image_open DOES NOT SET UP CLI METADATA.
1534 * It's just a PE file loader, used for FileVersionInfo. It also does
1535 * not use the image cache.
1538 mono_pe_file_open (const char *fname
, MonoImageOpenStatus
*status
)
1540 g_return_val_if_fail (fname
!= NULL
, NULL
);
1542 return do_mono_image_open (fname
, status
, FALSE
, TRUE
, FALSE
, FALSE
);
1546 * mono_image_open_raw
1547 * @fname: filename that points to the module we want to open
1548 * @status: An error condition is returned in this field
1550 * Returns an image without loading neither pe or cli data.
1552 * Use mono_image_load_pe_data and mono_image_load_cli_data to load them.
1555 mono_image_open_raw (const char *fname
, MonoImageOpenStatus
*status
)
1557 g_return_val_if_fail (fname
!= NULL
, NULL
);
1559 return do_mono_image_open (fname
, status
, FALSE
, FALSE
, FALSE
, FALSE
);
1563 * mono_image_open_metadata_only:
1565 * Open an image which contains metadata only without a PE header.
1568 mono_image_open_metadata_only (const char *fname
, MonoImageOpenStatus
*status
)
1570 return do_mono_image_open (fname
, status
, TRUE
, TRUE
, FALSE
, TRUE
);
1574 mono_image_fixup_vtable (MonoImage
*image
)
1577 MonoCLIImageInfo
*iinfo
;
1579 MonoVTableFixup
*vtfixup
;
1585 g_assert (image
->is_module_handle
);
1587 iinfo
= image
->image_info
;
1588 de
= &iinfo
->cli_cli_header
.ch_vtable_fixups
;
1589 if (!de
->rva
|| !de
->size
)
1591 vtfixup
= (MonoVTableFixup
*) mono_image_rva_map (image
, de
->rva
);
1595 count
= de
->size
/ sizeof (MonoVTableFixup
);
1597 if (!vtfixup
->rva
|| !vtfixup
->count
)
1600 slot
= mono_image_rva_map (image
, vtfixup
->rva
);
1602 slot_type
= vtfixup
->type
;
1603 slot_count
= vtfixup
->count
;
1604 if (slot_type
& VTFIXUP_TYPE_32BIT
)
1605 while (slot_count
--) {
1606 *((guint32
*) slot
) = (guint32
) mono_marshal_get_vtfixup_ftnptr (image
, *((guint32
*) slot
), slot_type
);
1607 slot
= ((guint32
*) slot
) + 1;
1609 else if (slot_type
& VTFIXUP_TYPE_64BIT
)
1610 while (slot_count
--) {
1611 *((guint64
*) slot
) = (guint64
) mono_marshal_get_vtfixup_ftnptr (image
, *((guint64
*) slot
), slot_type
);
1612 slot
= ((guint32
*) slot
) + 1;
1615 g_assert_not_reached();
1620 g_assert_not_reached();
1625 free_hash_table (gpointer key
, gpointer val
, gpointer user_data
)
1627 g_hash_table_destroy ((GHashTable
*)val
);
1632 free_mr_signatures (gpointer key, gpointer val, gpointer user_data)
1634 mono_metadata_free_method_signature ((MonoMethodSignature*)val);
1639 free_array_cache_entry (gpointer key
, gpointer val
, gpointer user_data
)
1641 g_slist_free ((GSList
*)val
);
1645 * mono_image_addref:
1646 * @image: The image file we wish to add a reference to
1648 * Increases the reference count of an image.
1651 mono_image_addref (MonoImage
*image
)
1653 InterlockedIncrement (&image
->ref_count
);
1657 mono_dynamic_stream_reset (MonoDynamicStream
* stream
)
1659 stream
->alloc_size
= stream
->index
= stream
->offset
= 0;
1660 g_free (stream
->data
);
1661 stream
->data
= NULL
;
1663 g_hash_table_destroy (stream
->hash
);
1664 stream
->hash
= NULL
;
1669 free_hash (GHashTable
*hash
)
1672 g_hash_table_destroy (hash
);
1676 mono_wrapper_caches_free (MonoWrapperCaches
*cache
)
1678 free_hash (cache
->delegate_invoke_cache
);
1679 free_hash (cache
->delegate_begin_invoke_cache
);
1680 free_hash (cache
->delegate_end_invoke_cache
);
1681 free_hash (cache
->runtime_invoke_cache
);
1682 free_hash (cache
->runtime_invoke_vtype_cache
);
1684 free_hash (cache
->delegate_abstract_invoke_cache
);
1686 free_hash (cache
->runtime_invoke_direct_cache
);
1687 free_hash (cache
->managed_wrapper_cache
);
1689 free_hash (cache
->native_wrapper_cache
);
1690 free_hash (cache
->native_wrapper_aot_cache
);
1691 free_hash (cache
->native_wrapper_check_cache
);
1692 free_hash (cache
->native_wrapper_aot_check_cache
);
1694 free_hash (cache
->native_func_wrapper_aot_cache
);
1695 free_hash (cache
->remoting_invoke_cache
);
1696 free_hash (cache
->synchronized_cache
);
1697 free_hash (cache
->unbox_wrapper_cache
);
1698 free_hash (cache
->cominterop_invoke_cache
);
1699 free_hash (cache
->cominterop_wrapper_cache
);
1700 free_hash (cache
->thunk_invoke_cache
);
1704 mono_image_close_except_pools_all (MonoImage
**images
, int image_count
)
1706 for (int i
= 0; i
< image_count
; ++i
) {
1708 if (!mono_image_close_except_pools (images
[i
]))
1715 * Returns whether mono_image_close_finish() must be called as well.
1716 * We must unload images in two steps because clearing the domain in
1717 * SGen requires the class metadata to be intact, but we need to free
1718 * the mono_g_hash_tables in case a collection occurs during domain
1719 * unloading and the roots would trip up the GC.
1722 mono_image_close_except_pools (MonoImage
*image
)
1725 GHashTable
*loaded_images
, *loaded_images_by_name
;
1728 g_return_val_if_fail (image
!= NULL
, FALSE
);
1731 * Atomically decrement the refcount and remove ourselves from the hash tables, so
1732 * register_image () can't grab an image which is being closed.
1734 mono_images_lock ();
1736 if (InterlockedDecrement (&image
->ref_count
) > 0) {
1737 mono_images_unlock ();
1741 loaded_images
= get_loaded_images_hash (image
->ref_only
);
1742 loaded_images_by_name
= get_loaded_images_by_name_hash (image
->ref_only
);
1743 image2
= (MonoImage
*)g_hash_table_lookup (loaded_images
, image
->name
);
1744 if (image
== image2
) {
1745 /* This is not true if we are called from mono_image_open () */
1746 g_hash_table_remove (loaded_images
, image
->name
);
1748 if (image
->assembly_name
&& (g_hash_table_lookup (loaded_images_by_name
, image
->assembly_name
) == image
))
1749 g_hash_table_remove (loaded_images_by_name
, (char *) image
->assembly_name
);
1751 mono_images_unlock ();
1754 if (image
->is_module_handle
&& image
->has_entry_point
) {
1755 mono_images_lock ();
1756 if (image
->ref_count
== 0) {
1757 /* Image will be closed by _CorDllMain. */
1758 FreeLibrary ((HMODULE
) image
->raw_data
);
1759 mono_images_unlock ();
1762 mono_images_unlock ();
1766 mono_profiler_module_event (image
, MONO_PROFILE_START_UNLOAD
);
1768 mono_trace (G_LOG_LEVEL_INFO
, MONO_TRACE_ASSEMBLY
, "Unloading image %s [%p].", image
->name
, image
);
1770 mono_image_invoke_unload_hook (image
);
1772 mono_metadata_clean_for_image (image
);
1775 * The caches inside a MonoImage might refer to metadata which is stored in referenced
1776 * assemblies, so we can't release these references in mono_assembly_close () since the
1777 * MonoImage might outlive its associated MonoAssembly.
1779 if (image
->references
&& !image_is_dynamic (image
)) {
1780 for (i
= 0; i
< image
->nreferences
; i
++) {
1781 if (image
->references
[i
] && image
->references
[i
] != REFERENCE_MISSING
) {
1782 if (!mono_assembly_close_except_image_pools (image
->references
[i
]))
1783 image
->references
[i
] = NULL
;
1787 if (image
->references
) {
1788 g_free (image
->references
);
1789 image
->references
= NULL
;
1794 mono_images_lock ();
1795 if (image
->is_module_handle
&& !image
->has_entry_point
)
1796 FreeLibrary ((HMODULE
) image
->raw_data
);
1797 mono_images_unlock ();
1800 if (image
->raw_buffer_used
) {
1801 if (image
->raw_data
!= NULL
) {
1803 if (image
->fileio_used
)
1804 mono_file_unmap_fileio (image
->raw_data
, image
->raw_data_handle
);
1807 mono_file_unmap (image
->raw_data
, image
->raw_data_handle
);
1811 if (image
->raw_data_allocated
) {
1812 /* FIXME: do we need this? (image is disposed anyway) */
1813 /* image->raw_metadata and cli_sections might lie inside image->raw_data */
1814 MonoCLIImageInfo
*ii
= (MonoCLIImageInfo
*)image
->image_info
;
1816 if ((image
->raw_metadata
> image
->raw_data
) &&
1817 (image
->raw_metadata
<= (image
->raw_data
+ image
->raw_data_len
)))
1818 image
->raw_metadata
= NULL
;
1820 for (i
= 0; i
< ii
->cli_section_count
; i
++)
1821 if (((char*)(ii
->cli_sections
[i
]) > image
->raw_data
) &&
1822 ((char*)(ii
->cli_sections
[i
]) <= ((char*)image
->raw_data
+ image
->raw_data_len
)))
1823 ii
->cli_sections
[i
] = NULL
;
1825 g_free (image
->raw_data
);
1828 if (debug_assembly_unload
) {
1829 image
->name
= g_strdup_printf ("%s - UNLOADED", image
->name
);
1831 g_free (image
->name
);
1832 g_free (image
->guid
);
1833 g_free (image
->version
);
1836 if (image
->method_cache
)
1837 g_hash_table_destroy (image
->method_cache
);
1838 if (image
->methodref_cache
)
1839 g_hash_table_destroy (image
->methodref_cache
);
1840 mono_internal_hash_table_destroy (&image
->class_cache
);
1841 mono_conc_hashtable_destroy (image
->field_cache
);
1842 if (image
->array_cache
) {
1843 g_hash_table_foreach (image
->array_cache
, free_array_cache_entry
, NULL
);
1844 g_hash_table_destroy (image
->array_cache
);
1846 if (image
->szarray_cache
)
1847 g_hash_table_destroy (image
->szarray_cache
);
1848 if (image
->ptr_cache
)
1849 g_hash_table_destroy (image
->ptr_cache
);
1850 if (image
->name_cache
) {
1851 g_hash_table_foreach (image
->name_cache
, free_hash_table
, NULL
);
1852 g_hash_table_destroy (image
->name_cache
);
1855 free_hash (image
->delegate_bound_static_invoke_cache
);
1856 free_hash (image
->runtime_invoke_vcall_cache
);
1857 free_hash (image
->ldfld_wrapper_cache
);
1858 free_hash (image
->ldflda_wrapper_cache
);
1859 free_hash (image
->stfld_wrapper_cache
);
1860 free_hash (image
->isinst_cache
);
1861 free_hash (image
->castclass_cache
);
1862 free_hash (image
->icall_wrapper_cache
);
1863 free_hash (image
->proxy_isinst_cache
);
1864 free_hash (image
->var_cache_slow
);
1865 free_hash (image
->mvar_cache_slow
);
1866 free_hash (image
->var_cache_constrained
);
1867 free_hash (image
->mvar_cache_constrained
);
1868 free_hash (image
->wrapper_param_names
);
1869 free_hash (image
->pinvoke_scopes
);
1870 free_hash (image
->pinvoke_scope_filenames
);
1871 free_hash (image
->native_func_wrapper_cache
);
1872 free_hash (image
->typespec_cache
);
1874 mono_wrapper_caches_free (&image
->wrapper_caches
);
1876 for (i
= 0; i
< image
->gshared_types_len
; ++i
)
1877 free_hash (image
->gshared_types
[i
]);
1878 g_free (image
->gshared_types
);
1880 /* The ownership of signatures is not well defined */
1881 g_hash_table_destroy (image
->memberref_signatures
);
1882 g_hash_table_destroy (image
->helper_signatures
);
1883 g_hash_table_destroy (image
->method_signatures
);
1885 if (image
->rgctx_template_hash
)
1886 g_hash_table_destroy (image
->rgctx_template_hash
);
1888 if (image
->property_hash
)
1889 mono_property_hash_destroy (image
->property_hash
);
1892 reflection_info_unregister_classes is only required by dynamic images, which will not be properly
1893 cleared during shutdown as we don't perform regular appdomain unload for the root one.
1895 g_assert (!image
->reflection_info_unregister_classes
|| mono_runtime_is_shutting_down ());
1896 image
->reflection_info_unregister_classes
= NULL
;
1898 if (image
->interface_bitset
) {
1899 mono_unload_interface_ids (image
->interface_bitset
);
1900 mono_bitset_free (image
->interface_bitset
);
1902 if (image
->image_info
){
1903 MonoCLIImageInfo
*ii
= (MonoCLIImageInfo
*)image
->image_info
;
1905 if (ii
->cli_section_tables
)
1906 g_free (ii
->cli_section_tables
);
1907 if (ii
->cli_sections
)
1908 g_free (ii
->cli_sections
);
1909 g_free (image
->image_info
);
1912 mono_image_close_except_pools_all (image
->files
, image
->file_count
);
1913 mono_image_close_except_pools_all (image
->modules
, image
->module_count
);
1914 if (image
->modules_loaded
)
1915 g_free (image
->modules_loaded
);
1917 mono_os_mutex_destroy (&image
->szarray_cache_lock
);
1918 mono_os_mutex_destroy (&image
->lock
);
1920 /*g_print ("destroy image %p (dynamic: %d)\n", image, image->dynamic);*/
1921 if (image_is_dynamic (image
)) {
1922 /* Dynamic images are GC_MALLOCed */
1923 g_free ((char*)image
->module_name
);
1924 mono_dynamic_image_free ((MonoDynamicImage
*)image
);
1927 mono_profiler_module_event (image
, MONO_PROFILE_END_UNLOAD
);
1933 mono_image_close_all (MonoImage
**images
, int image_count
)
1935 for (int i
= 0; i
< image_count
; ++i
) {
1937 mono_image_close_finish (images
[i
]);
1944 mono_image_close_finish (MonoImage
*image
)
1948 if (image
->references
&& !image_is_dynamic (image
)) {
1949 for (i
= 0; i
< image
->nreferences
; i
++) {
1950 if (image
->references
[i
] && image
->references
[i
] != REFERENCE_MISSING
)
1951 mono_assembly_close_finish (image
->references
[i
]);
1954 g_free (image
->references
);
1955 image
->references
= NULL
;
1958 mono_image_close_all (image
->files
, image
->file_count
);
1959 mono_image_close_all (image
->modules
, image
->module_count
);
1961 #ifndef DISABLE_PERFCOUNTERS
1962 mono_perfcounters
->loader_bytes
-= mono_mempool_get_allocated (image
->mempool
);
1965 if (!image_is_dynamic (image
)) {
1966 if (debug_assembly_unload
)
1967 mono_mempool_invalidate (image
->mempool
);
1969 mono_mempool_destroy (image
->mempool
);
1973 if (debug_assembly_unload
)
1974 mono_mempool_invalidate (image
->mempool
);
1976 mono_mempool_destroy (image
->mempool
);
1977 mono_dynamic_image_free_image ((MonoDynamicImage
*)image
);
1984 * @image: The image file we wish to close
1986 * Closes an image file, deallocates all memory consumed and
1987 * unmaps all possible sections of the file
1990 mono_image_close (MonoImage
*image
)
1992 if (mono_image_close_except_pools (image
))
1993 mono_image_close_finish (image
);
1997 * mono_image_strerror:
1998 * @status: an code indicating the result from a recent operation
2000 * Returns: a string describing the error
2003 mono_image_strerror (MonoImageOpenStatus status
)
2008 case MONO_IMAGE_ERROR_ERRNO
:
2009 return strerror (errno
);
2010 case MONO_IMAGE_IMAGE_INVALID
:
2011 return "File does not contain a valid CIL image";
2012 case MONO_IMAGE_MISSING_ASSEMBLYREF
:
2013 return "An assembly was referenced, but could not be found";
2015 return "Internal error";
2019 mono_image_walk_resource_tree (MonoCLIImageInfo
*info
, guint32 res_id
,
2020 guint32 lang_id
, gunichar2
*name
,
2021 MonoPEResourceDirEntry
*entry
,
2022 MonoPEResourceDir
*root
, guint32 level
)
2024 gboolean is_string
, is_dir
;
2025 guint32 name_offset
, dir_offset
;
2027 /* Level 0 holds a directory entry for each type of resource
2028 * (identified by ID or name).
2030 * Level 1 holds a directory entry for each named resource
2031 * item, and each "anonymous" item of a particular type of
2034 * Level 2 holds a directory entry for each language pointing to
2037 is_string
= MONO_PE_RES_DIR_ENTRY_NAME_IS_STRING (*entry
);
2038 name_offset
= MONO_PE_RES_DIR_ENTRY_NAME_OFFSET (*entry
);
2040 is_dir
= MONO_PE_RES_DIR_ENTRY_IS_DIR (*entry
);
2041 dir_offset
= MONO_PE_RES_DIR_ENTRY_DIR_OFFSET (*entry
);
2046 } else if (level
==1) {
2047 if (res_id
!= name_offset
)
2051 is_string
==TRUE
&& name
!=lookup (name_offset
)) {
2055 } else if (level
==2) {
2056 if (is_string
|| (lang_id
!= 0 && name_offset
!= lang_id
))
2059 g_assert_not_reached ();
2063 MonoPEResourceDir
*res_dir
=(MonoPEResourceDir
*)(((char *)root
)+dir_offset
);
2064 MonoPEResourceDirEntry
*sub_entries
=(MonoPEResourceDirEntry
*)(res_dir
+1);
2067 entries
= GUINT16_FROM_LE (res_dir
->res_named_entries
) + GUINT16_FROM_LE (res_dir
->res_id_entries
);
2069 for(i
=0; i
<entries
; i
++) {
2070 MonoPEResourceDirEntry
*sub_entry
=&sub_entries
[i
];
2073 ret
=mono_image_walk_resource_tree (info
, res_id
,
2084 MonoPEResourceDataEntry
*data_entry
=(MonoPEResourceDataEntry
*)((char *)(root
)+dir_offset
);
2085 MonoPEResourceDataEntry
*res
;
2087 res
= g_new0 (MonoPEResourceDataEntry
, 1);
2089 res
->rde_data_offset
= GUINT32_TO_LE (data_entry
->rde_data_offset
);
2090 res
->rde_size
= GUINT32_TO_LE (data_entry
->rde_size
);
2091 res
->rde_codepage
= GUINT32_TO_LE (data_entry
->rde_codepage
);
2092 res
->rde_reserved
= GUINT32_TO_LE (data_entry
->rde_reserved
);
2099 * mono_image_lookup_resource:
2100 * @image: the image to look up the resource in
2101 * @res_id: A MONO_PE_RESOURCE_ID_ that represents the resource ID to lookup.
2102 * @lang_id: The language id.
2103 * @name: the resource name to lookup.
2105 * Returns: NULL if not found, otherwise a pointer to the in-memory representation
2106 * of the given resource. The caller should free it using g_free () when no longer
2110 mono_image_lookup_resource (MonoImage
*image
, guint32 res_id
, guint32 lang_id
, gunichar2
*name
)
2112 MonoCLIImageInfo
*info
;
2113 MonoDotNetHeader
*header
;
2114 MonoPEDatadir
*datadir
;
2115 MonoPEDirEntry
*rsrc
;
2116 MonoPEResourceDir
*resource_dir
;
2117 MonoPEResourceDirEntry
*res_entries
;
2124 mono_image_ensure_section_idx (image
, MONO_SECTION_RSRC
);
2126 info
= (MonoCLIImageInfo
*)image
->image_info
;
2131 header
=&info
->cli_header
;
2136 datadir
=&header
->datadir
;
2141 rsrc
=&datadir
->pe_resource_table
;
2146 resource_dir
=(MonoPEResourceDir
*)mono_image_rva_map (image
, rsrc
->rva
);
2147 if(resource_dir
==NULL
) {
2151 entries
= GUINT16_FROM_LE (resource_dir
->res_named_entries
) + GUINT16_FROM_LE (resource_dir
->res_id_entries
);
2152 res_entries
=(MonoPEResourceDirEntry
*)(resource_dir
+1);
2154 for(i
=0; i
<entries
; i
++) {
2155 MonoPEResourceDirEntry
*entry
=&res_entries
[i
];
2158 ret
=mono_image_walk_resource_tree (info
, res_id
, lang_id
,
2159 name
, entry
, resource_dir
,
2170 * mono_image_get_entry_point:
2171 * @image: the image where the entry point will be looked up.
2173 * Use this routine to determine the metadata token for method that
2174 * has been flagged as the entry point.
2176 * Returns: the token for the entry point method in the image
2179 mono_image_get_entry_point (MonoImage
*image
)
2181 return ((MonoCLIImageInfo
*)image
->image_info
)->cli_cli_header
.ch_entry_point
;
2185 * mono_image_get_resource:
2186 * @image: the image where the resource will be looked up.
2187 * @offset: The offset to add to the resource
2188 * @size: a pointer to an int where the size of the resource will be stored
2190 * This is a low-level routine that fetches a resource from the
2191 * metadata that starts at a given @offset. The @size parameter is
2192 * filled with the data field as encoded in the metadata.
2194 * Returns: the pointer to the resource whose offset is @offset.
2197 mono_image_get_resource (MonoImage
*image
, guint32 offset
, guint32
*size
)
2199 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
2200 MonoCLIHeader
*ch
= &iinfo
->cli_cli_header
;
2203 if (!ch
->ch_resources
.rva
|| offset
+ 4 > ch
->ch_resources
.size
)
2206 data
= mono_image_rva_map (image
, ch
->ch_resources
.rva
);
2211 *size
= read32 (data
);
2216 // Returning NULL with no error set will be interpeted as "not found"
2218 mono_image_load_file_for_image_checked (MonoImage
*image
, int fileidx
, MonoError
*error
)
2220 char *base_dir
, *name
;
2222 MonoTableInfo
*t
= &image
->tables
[MONO_TABLE_FILE
];
2226 if (fileidx
< 1 || fileidx
> t
->rows
)
2229 mono_image_lock (image
);
2230 if (image
->files
&& image
->files
[fileidx
- 1]) {
2231 mono_image_unlock (image
);
2232 return image
->files
[fileidx
- 1];
2234 mono_image_unlock (image
);
2236 fname_id
= mono_metadata_decode_row_col (t
, fileidx
- 1, MONO_FILE_NAME
);
2237 fname
= mono_metadata_string_heap (image
, fname_id
);
2238 base_dir
= g_path_get_dirname (image
->name
);
2239 name
= g_build_filename (base_dir
, fname
, NULL
);
2240 res
= mono_image_open (name
, NULL
);
2244 mono_image_lock (image
);
2245 if (image
->files
&& image
->files
[fileidx
- 1]) {
2246 MonoImage
*old
= res
;
2247 res
= image
->files
[fileidx
- 1];
2248 mono_image_unlock (image
);
2249 mono_image_close (old
);
2252 /* g_print ("loaded file %s from %s (%p)\n", name, image->name, image->assembly); */
2253 if (!assign_assembly_parent_for_netmodule (res
, image
, error
)) {
2254 mono_image_unlock (image
);
2255 mono_image_close (res
);
2259 for (i
= 0; i
< res
->module_count
; ++i
) {
2260 if (res
->modules
[i
] && !res
->modules
[i
]->assembly
)
2261 res
->modules
[i
]->assembly
= image
->assembly
;
2264 if (!image
->files
) {
2265 image
->files
= g_new0 (MonoImage
*, t
->rows
);
2266 image
->file_count
= t
->rows
;
2268 image
->files
[fileidx
- 1] = res
;
2269 mono_image_unlock (image
);
2270 /* vtable fixup can't happen with the image lock held */
2272 if (res
->is_module_handle
)
2273 mono_image_fixup_vtable (res
);
2284 mono_image_load_file_for_image (MonoImage
*image
, int fileidx
)
2287 mono_error_init (&error
);
2288 MonoImage
*result
= mono_image_load_file_for_image_checked (image
, fileidx
, &error
);
2289 mono_error_assert_ok (&error
);
2290 mono_error_cleanup (&error
);
2295 * mono_image_get_strong_name:
2296 * @image: a MonoImage
2297 * @size: a guint32 pointer, or NULL.
2299 * If the image has a strong name, and @size is not NULL, the value
2300 * pointed to by size will have the size of the strong name.
2302 * Returns: NULL if the image does not have a strong name, or a
2303 * pointer to the public key.
2306 mono_image_get_strong_name (MonoImage
*image
, guint32
*size
)
2308 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
2309 MonoPEDirEntry
*de
= &iinfo
->cli_cli_header
.ch_strong_name
;
2312 if (!de
->size
|| !de
->rva
)
2314 data
= mono_image_rva_map (image
, de
->rva
);
2323 * mono_image_strong_name_position:
2324 * @image: a MonoImage
2325 * @size: a guint32 pointer, or NULL.
2327 * If the image has a strong name, and @size is not NULL, the value
2328 * pointed to by size will have the size of the strong name.
2330 * Returns: the position within the image file where the strong name
2334 mono_image_strong_name_position (MonoImage
*image
, guint32
*size
)
2336 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
2337 MonoPEDirEntry
*de
= &iinfo
->cli_cli_header
.ch_strong_name
;
2342 if (!de
->size
|| !de
->rva
)
2344 pos
= mono_cli_rva_image_map (image
, de
->rva
);
2345 return pos
== INVALID_ADDRESS
? 0 : pos
;
2349 * mono_image_get_public_key:
2350 * @image: a MonoImage
2351 * @size: a guint32 pointer, or NULL.
2353 * This is used to obtain the public key in the @image.
2355 * If the image has a public key, and @size is not NULL, the value
2356 * pointed to by size will have the size of the public key.
2358 * Returns: NULL if the image does not have a public key, or a pointer
2359 * to the public key.
2362 mono_image_get_public_key (MonoImage
*image
, guint32
*size
)
2367 if (image_is_dynamic (image
)) {
2369 *size
= ((MonoDynamicImage
*)image
)->public_key_len
;
2370 return (char*)((MonoDynamicImage
*)image
)->public_key
;
2372 if (image
->tables
[MONO_TABLE_ASSEMBLY
].rows
!= 1)
2374 tok
= mono_metadata_decode_row_col (&image
->tables
[MONO_TABLE_ASSEMBLY
], 0, MONO_ASSEMBLY_PUBLIC_KEY
);
2377 pubkey
= mono_metadata_blob_heap (image
, tok
);
2378 len
= mono_metadata_decode_blob_size (pubkey
, &pubkey
);
2385 * mono_image_get_name:
2386 * @name: a MonoImage
2388 * Returns: the name of the assembly.
2391 mono_image_get_name (MonoImage
*image
)
2393 return image
->assembly_name
;
2397 * mono_image_get_filename:
2398 * @image: a MonoImage
2400 * Used to get the filename that hold the actual MonoImage
2402 * Returns: the filename.
2405 mono_image_get_filename (MonoImage
*image
)
2411 mono_image_get_guid (MonoImage
*image
)
2416 const MonoTableInfo
*
2417 mono_image_get_table_info (MonoImage
*image
, int table_id
)
2419 if (table_id
< 0 || table_id
>= MONO_TABLE_NUM
)
2421 return &image
->tables
[table_id
];
2425 mono_image_get_table_rows (MonoImage
*image
, int table_id
)
2427 if (table_id
< 0 || table_id
>= MONO_TABLE_NUM
)
2429 return image
->tables
[table_id
].rows
;
2433 mono_table_info_get_rows (const MonoTableInfo
*table
)
2439 * mono_image_get_assembly:
2440 * @image: the MonoImage.
2442 * Use this routine to get the assembly that owns this image.
2444 * Returns: the assembly that holds this image.
2447 mono_image_get_assembly (MonoImage
*image
)
2449 return image
->assembly
;
2453 * mono_image_is_dynamic:
2454 * @image: the MonoImage
2456 * Determines if the given image was created dynamically through the
2457 * System.Reflection.Emit API
2459 * Returns: TRUE if the image was created dynamically, FALSE if not.
2462 mono_image_is_dynamic (MonoImage
*image
)
2464 return image_is_dynamic (image
);
2468 * mono_image_has_authenticode_entry:
2469 * @image: the MonoImage
2471 * Use this routine to determine if the image has a Authenticode
2472 * Certificate Table.
2474 * Returns: TRUE if the image contains an authenticode entry in the PE
2478 mono_image_has_authenticode_entry (MonoImage
*image
)
2480 MonoCLIImageInfo
*iinfo
= (MonoCLIImageInfo
*)image
->image_info
;
2481 MonoDotNetHeader
*header
= &iinfo
->cli_header
;
2482 MonoPEDirEntry
*de
= &header
->datadir
.pe_certificate_table
;
2483 // the Authenticode "pre" (non ASN.1) header is 8 bytes long
2484 return ((de
->rva
!= 0) && (de
->size
> 8));
2488 mono_image_alloc (MonoImage
*image
, guint size
)
2492 #ifndef DISABLE_PERFCOUNTERS
2493 mono_perfcounters
->loader_bytes
+= size
;
2495 mono_image_lock (image
);
2496 res
= mono_mempool_alloc (image
->mempool
, size
);
2497 mono_image_unlock (image
);
2503 mono_image_alloc0 (MonoImage
*image
, guint size
)
2507 #ifndef DISABLE_PERFCOUNTERS
2508 mono_perfcounters
->loader_bytes
+= size
;
2510 mono_image_lock (image
);
2511 res
= mono_mempool_alloc0 (image
->mempool
, size
);
2512 mono_image_unlock (image
);
2518 mono_image_strdup (MonoImage
*image
, const char *s
)
2522 #ifndef DISABLE_PERFCOUNTERS
2523 mono_perfcounters
->loader_bytes
+= strlen (s
);
2525 mono_image_lock (image
);
2526 res
= mono_mempool_strdup (image
->mempool
, s
);
2527 mono_image_unlock (image
);
2533 g_list_prepend_image (MonoImage
*image
, GList
*list
, gpointer data
)
2537 new_list
= (GList
*)mono_image_alloc (image
, sizeof (GList
));
2538 new_list
->data
= data
;
2539 new_list
->prev
= list
? list
->prev
: NULL
;
2540 new_list
->next
= list
;
2543 new_list
->prev
->next
= new_list
;
2545 list
->prev
= new_list
;
2551 g_slist_append_image (MonoImage
*image
, GSList
*list
, gpointer data
)
2555 new_list
= (GSList
*)mono_image_alloc (image
, sizeof (GSList
));
2556 new_list
->data
= data
;
2557 new_list
->next
= NULL
;
2559 return g_slist_concat (list
, new_list
);
2563 mono_image_lock (MonoImage
*image
)
2565 mono_locks_os_acquire (&image
->lock
, ImageDataLock
);
2569 mono_image_unlock (MonoImage
*image
)
2571 mono_locks_os_release (&image
->lock
, ImageDataLock
);
2576 * mono_image_property_lookup:
2578 * Lookup a property on @image. Used to store very rare fields of MonoClass and MonoMethod.
2580 * LOCKING: Takes the image lock
2583 mono_image_property_lookup (MonoImage
*image
, gpointer subject
, guint32 property
)
2587 mono_image_lock (image
);
2588 res
= mono_property_hash_lookup (image
->property_hash
, subject
, property
);
2589 mono_image_unlock (image
);
2595 * mono_image_property_insert:
2597 * Insert a new property @property with value @value on @subject in @image. Used to store very rare fields of MonoClass and MonoMethod.
2599 * LOCKING: Takes the image lock
2602 mono_image_property_insert (MonoImage
*image
, gpointer subject
, guint32 property
, gpointer value
)
2604 mono_image_lock (image
);
2605 mono_property_hash_insert (image
->property_hash
, subject
, property
, value
);
2606 mono_image_unlock (image
);
2610 * mono_image_property_remove:
2612 * Remove all properties associated with @subject in @image. Used to store very rare fields of MonoClass and MonoMethod.
2614 * LOCKING: Takes the image lock
2617 mono_image_property_remove (MonoImage
*image
, gpointer subject
)
2619 mono_image_lock (image
);
2620 mono_property_hash_remove_object (image
->property_hash
, subject
);
2621 mono_image_unlock (image
);
2625 mono_image_append_class_to_reflection_info_set (MonoClass
*klass
)
2627 MonoImage
*image
= klass
->image
;
2628 g_assert (image_is_dynamic (image
));
2629 mono_image_lock (image
);
2630 image
->reflection_info_unregister_classes
= g_slist_prepend_mempool (image
->mempool
, image
->reflection_info_unregister_classes
, klass
);
2631 mono_image_unlock (image
);
2634 // This is support for the mempool reference tracking feature in checked-build, but lives in image.c due to use of static variables of this file.
2637 * mono_find_image_owner:
2639 * Find the image, if any, which a given pointer is located in the memory of.
2642 mono_find_image_owner (void *ptr
)
2644 mono_images_lock ();
2646 MonoImage
*owner
= NULL
;
2648 // Iterate over both by-path image hashes
2649 const int hash_candidates
[] = {IMAGES_HASH_PATH
, IMAGES_HASH_PATH_REFONLY
};
2651 for (hash_idx
= 0; !owner
&& hash_idx
< G_N_ELEMENTS (hash_candidates
); hash_idx
++)
2653 GHashTable
*target
= loaded_images_hashes
[hash_candidates
[hash_idx
]];
2654 GHashTableIter iter
;
2657 // Iterate over images within a hash
2658 g_hash_table_iter_init (&iter
, target
);
2659 while (!owner
&& g_hash_table_iter_next(&iter
, NULL
, (gpointer
*)&image
))
2661 mono_image_lock (image
);
2662 if (mono_mempool_contains_addr (image
->mempool
, ptr
))
2664 mono_image_unlock (image
);
2668 mono_images_unlock ();