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 * (C) 2001-2003 Ximian, Inc. http://www.ximian.com
20 #include "rawbuffer.h"
21 #include "mono-endian.h"
23 #include "tabledefs.h"
24 #include "tokentype.h"
25 #include <mono/io-layer/io-layer.h>
27 #define INVALID_ADDRESS 0xffffffff
30 * Keeps track of the various assemblies loaded
32 static GHashTable *loaded_images_hash;
33 static GHashTable *loaded_images_guid_hash;
35 static CRITICAL_SECTION images_mutex;
38 mono_cli_rva_image_map (MonoCLIImageInfo *iinfo, guint32 addr)
40 const int top = iinfo->cli_section_count;
41 MonoSectionTable *tables = iinfo->cli_section_tables;
44 for (i = 0; i < top; i++){
45 if ((addr >= tables->st_virtual_address) &&
46 (addr < tables->st_virtual_address + tables->st_raw_data_size)){
47 return addr - tables->st_virtual_address + tables->st_raw_data_ptr;
51 return INVALID_ADDRESS;
55 mono_cli_rva_map (MonoCLIImageInfo *iinfo, guint32 addr)
57 const int top = iinfo->cli_section_count;
58 MonoSectionTable *tables = iinfo->cli_section_tables;
61 for (i = 0; i < top; i++){
62 if ((addr >= tables->st_virtual_address) &&
63 (addr < tables->st_virtual_address + tables->st_raw_data_size)){
64 return (char*)iinfo->cli_sections [i] +
65 (addr - tables->st_virtual_address);
75 * Initialize the global variables used by this module.
78 mono_images_init (void)
80 InitializeCriticalSection (&images_mutex);
82 loaded_images_hash = g_hash_table_new (g_str_hash, g_str_equal);
83 loaded_images_guid_hash = g_hash_table_new (g_str_hash, g_str_equal);
87 * mono_image_ensure_section_idx:
88 * @image: The image we are operating on
89 * @section: section number that we will load/map into memory
91 * This routine makes sure that we have an in-memory copy of
92 * an image section (.text, .rsrc, .data).
94 * Returns: TRUE on success
97 mono_image_ensure_section_idx (MonoImage *image, int section)
99 MonoCLIImageInfo *iinfo = image->image_info;
100 MonoSectionTable *sect;
103 g_return_val_if_fail (section < iinfo->cli_section_count, FALSE);
105 if (iinfo->cli_sections [section] != NULL)
108 sect = &iinfo->cli_section_tables [section];
110 writable = sect->st_flags & SECT_FLAGS_MEM_WRITE;
113 if (sect->st_raw_data_ptr + sect->st_raw_data_size > image->raw_data_len)
115 /* FIXME: we ignore the writable flag since we don't patch the binary */
116 iinfo->cli_sections [section] = image->raw_data + sect->st_raw_data_ptr;
119 iinfo->cli_sections [section] = mono_raw_buffer_load (
120 fileno (image->f), writable,
121 sect->st_raw_data_ptr, sect->st_raw_data_size);
123 if (iinfo->cli_sections [section] == NULL)
130 * mono_image_ensure_section:
131 * @image: The image we are operating on
132 * @section: section name that we will load/map into memory
134 * This routine makes sure that we have an in-memory copy of
135 * an image section (.text, .rsrc, .data).
137 * Returns: TRUE on success
140 mono_image_ensure_section (MonoImage *image, const char *section)
142 MonoCLIImageInfo *ii = image->image_info;
145 for (i = 0; i < ii->cli_section_count; i++){
146 if (strncmp (ii->cli_section_tables [i].st_name, section, 8) != 0)
149 return mono_image_ensure_section_idx (image, i);
155 load_section_tables (MonoImage *image, MonoCLIImageInfo *iinfo, guint32 offset)
157 const int top = iinfo->cli_header.coff.coff_sections;
160 iinfo->cli_section_count = top;
161 iinfo->cli_section_tables = g_new0 (MonoSectionTable, top);
162 iinfo->cli_sections = g_new0 (void *, top);
164 for (i = 0; i < top; i++){
165 MonoSectionTable *t = &iinfo->cli_section_tables [i];
168 if (offset + sizeof (MonoSectionTable) > image->raw_data_len)
170 memcpy (t, image->raw_data + offset, sizeof (MonoSectionTable));
171 offset += sizeof (MonoSectionTable);
173 if (fread (t, sizeof (MonoSectionTable), 1, image->f) != 1)
177 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
178 t->st_virtual_size = GUINT32_FROM_LE (t->st_virtual_size);
179 t->st_virtual_address = GUINT32_FROM_LE (t->st_virtual_address);
180 t->st_raw_data_size = GUINT32_FROM_LE (t->st_raw_data_size);
181 t->st_raw_data_ptr = GUINT32_FROM_LE (t->st_raw_data_ptr);
182 t->st_reloc_ptr = GUINT32_FROM_LE (t->st_reloc_ptr);
183 t->st_lineno_ptr = GUINT32_FROM_LE (t->st_lineno_ptr);
184 t->st_reloc_count = GUINT16_FROM_LE (t->st_reloc_count);
185 t->st_line_count = GUINT16_FROM_LE (t->st_line_count);
186 t->st_flags = GUINT32_FROM_LE (t->st_flags);
188 /* consistency checks here */
191 for (i = 0; i < top; i++)
192 if (!mono_image_ensure_section_idx (image, i))
199 load_cli_header (MonoImage *image, MonoCLIImageInfo *iinfo)
204 offset = mono_cli_rva_image_map (iinfo, iinfo->cli_header.datadir.pe_cli_header.rva);
205 if (offset == INVALID_ADDRESS)
209 if (offset + sizeof (MonoCLIHeader) > image->raw_data_len)
211 memcpy (&iinfo->cli_cli_header, image->raw_data + offset, sizeof (MonoCLIHeader));
213 if (fseek (image->f, offset, SEEK_SET) != 0)
216 if ((n = fread (&iinfo->cli_cli_header, sizeof (MonoCLIHeader), 1, image->f)) != 1)
220 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
221 #define SWAP32(x) (x) = GUINT32_FROM_LE ((x))
222 #define SWAP16(x) (x) = GUINT16_FROM_LE ((x))
223 #define SWAPPDE(x) do { (x).rva = GUINT32_FROM_LE ((x).rva); (x).size = GUINT32_FROM_LE ((x).size);} while (0)
224 SWAP32 (iinfo->cli_cli_header.ch_size);
225 SWAP32 (iinfo->cli_cli_header.ch_flags);
226 SWAP32 (iinfo->cli_cli_header.ch_entry_point);
227 SWAP16 (iinfo->cli_cli_header.ch_runtime_major);
228 SWAP16 (iinfo->cli_cli_header.ch_runtime_minor);
229 SWAPPDE (iinfo->cli_cli_header.ch_metadata);
230 SWAPPDE (iinfo->cli_cli_header.ch_resources);
231 SWAPPDE (iinfo->cli_cli_header.ch_strong_name);
232 SWAPPDE (iinfo->cli_cli_header.ch_code_manager_table);
233 SWAPPDE (iinfo->cli_cli_header.ch_vtable_fixups);
234 SWAPPDE (iinfo->cli_cli_header.ch_export_address_table_jumps);
235 SWAPPDE (iinfo->cli_cli_header.ch_eeinfo_table);
236 SWAPPDE (iinfo->cli_cli_header.ch_helper_table);
237 SWAPPDE (iinfo->cli_cli_header.ch_dynamic_info);
238 SWAPPDE (iinfo->cli_cli_header.ch_delay_load_info);
239 SWAPPDE (iinfo->cli_cli_header.ch_module_image);
240 SWAPPDE (iinfo->cli_cli_header.ch_external_fixups);
241 SWAPPDE (iinfo->cli_cli_header.ch_ridmap);
242 SWAPPDE (iinfo->cli_cli_header.ch_debug_map);
243 SWAPPDE (iinfo->cli_cli_header.ch_ip_map);
248 /* Catch new uses of the fields that are supposed to be zero */
250 if ((iinfo->cli_cli_header.ch_eeinfo_table.rva != 0) ||
251 (iinfo->cli_cli_header.ch_helper_table.rva != 0) ||
252 (iinfo->cli_cli_header.ch_dynamic_info.rva != 0) ||
253 (iinfo->cli_cli_header.ch_delay_load_info.rva != 0) ||
254 (iinfo->cli_cli_header.ch_module_image.rva != 0) ||
255 (iinfo->cli_cli_header.ch_external_fixups.rva != 0) ||
256 (iinfo->cli_cli_header.ch_ridmap.rva != 0) ||
257 (iinfo->cli_cli_header.ch_debug_map.rva != 0) ||
258 (iinfo->cli_cli_header.ch_ip_map.rva != 0)){
261 * No need to scare people who are testing this, I am just
262 * labelling this as a LAMESPEC
264 /* g_warning ("Some fields in the CLI header which should have been zero are not zero"); */
272 load_metadata_ptrs (MonoImage *image, MonoCLIImageInfo *iinfo)
274 guint32 offset, size;
280 offset = mono_cli_rva_image_map (iinfo, iinfo->cli_cli_header.ch_metadata.rva);
281 size = iinfo->cli_cli_header.ch_metadata.size;
284 if (offset + size > image->raw_data_len)
286 image->raw_metadata = image->raw_data + offset;
288 image->raw_metadata = mono_raw_buffer_load (fileno (image->f), FALSE, offset, size);
289 if (image->raw_metadata == NULL)
293 ptr = image->raw_metadata;
295 if (strncmp (ptr, "BSJB", 4) == 0){
296 guint32 version_string_len;
299 version_string_len = read32 (ptr);
301 image->version = g_strndup (ptr, version_string_len);
302 ptr += version_string_len;
303 pad = ptr - image->raw_metadata;
305 ptr += 4 - (pad % 4);
309 /* skip over flags */
312 streams = read16 (ptr);
315 for (i = 0; i < streams; i++){
316 if (strncmp (ptr + 8, "#~", 3) == 0){
317 image->heap_tables.data = image->raw_metadata + read32 (ptr);
318 image->heap_tables.size = read32 (ptr + 4);
320 } else if (strncmp (ptr + 8, "#Strings", 9) == 0){
321 image->heap_strings.data = image->raw_metadata + read32 (ptr);
322 image->heap_strings.size = read32 (ptr + 4);
324 } else if (strncmp (ptr + 8, "#US", 4) == 0){
325 image->heap_us.data = image->raw_metadata + read32 (ptr);
326 image->heap_us.size = read32 (ptr + 4);
328 } else if (strncmp (ptr + 8, "#Blob", 6) == 0){
329 image->heap_blob.data = image->raw_metadata + read32 (ptr);
330 image->heap_blob.size = read32 (ptr + 4);
332 } else if (strncmp (ptr + 8, "#GUID", 6) == 0){
333 image->heap_guid.data = image->raw_metadata + read32 (ptr);
334 image->heap_guid.size = read32 (ptr + 4);
336 } else if (strncmp (ptr + 8, "#-", 3) == 0) {
337 g_print ("Assembly '%s' has the non-standard metadata heap #-.\nRecompile it correctly (without the /incremental switch or in Release mode).", image->name);
340 g_message ("Unknown heap type: %s\n", ptr + 8);
341 ptr += 8 + strlen (ptr) + 1;
343 pad = ptr - image->raw_metadata;
345 ptr += 4 - (pad % 4);
348 g_assert (image->heap_guid.data);
349 g_assert (image->heap_guid.size >= 16);
351 image->guid = mono_guid_to_string (image->heap_guid.data);
357 * Load representation of logical metadata tables, from the "#~" stream
360 load_tables (MonoImage *image)
362 const char *heap_tables = image->heap_tables.data;
364 guint64 valid_mask, sorted_mask;
365 int valid = 0, table;
368 heap_sizes = heap_tables [6];
369 image->idx_string_wide = ((heap_sizes & 0x01) == 1);
370 image->idx_guid_wide = ((heap_sizes & 0x02) == 2);
371 image->idx_blob_wide = ((heap_sizes & 0x04) == 4);
373 valid_mask = read64 (heap_tables + 8);
374 sorted_mask = read64 (heap_tables + 16);
375 rows = (const guint32 *) (heap_tables + 24);
377 for (table = 0; table < 64; table++){
378 if ((valid_mask & ((guint64) 1 << table)) == 0){
379 image->tables [table].rows = 0;
382 if (table > MONO_TABLE_LAST) {
383 g_warning("bits in valid must be zero above 0x2d (II - 23.1.6)");
385 /*if ((sorted_mask & ((guint64) 1 << table)) == 0){
386 g_print ("table %s (0x%02x) is sorted\n", mono_meta_table_name (table), table);
388 image->tables [table].rows = read32 (rows);
393 image->tables_base = (heap_tables + 24) + (4 * valid);
395 /* They must be the same */
396 g_assert ((const void *) image->tables_base == (const void *) rows);
398 mono_metadata_compute_table_bases (image);
403 load_metadata (MonoImage *image, MonoCLIImageInfo *iinfo)
405 if (!load_metadata_ptrs (image, iinfo))
408 return load_tables (image);
412 mono_image_add_to_name_cache (MonoImage *image, const char *nspace,
413 const char *name, guint32 index)
415 GHashTable *nspace_table;
416 GHashTable *name_cache = image->name_cache;
418 if (!(nspace_table = g_hash_table_lookup (name_cache, nspace))) {
419 nspace_table = g_hash_table_new (g_str_hash, g_str_equal);
420 g_hash_table_insert (name_cache, (char *)nspace, (char *)nspace_table);
422 g_hash_table_insert (nspace_table, (char *) name, GUINT_TO_POINTER (index));
426 load_modules (MonoImage *image, MonoImageOpenStatus *status)
435 t = &image->tables [MONO_TABLE_MODULEREF];
436 image->modules = g_new0 (MonoImage *, t->rows);
437 base_dir = g_path_get_dirname (image->name);
438 for (i = 0; i < t->rows; i++){
441 guint32 cols [MONO_MODULEREF_SIZE];
443 mono_metadata_decode_row (t, i, cols, MONO_MODULEREF_SIZE);
444 name = mono_metadata_string_heap (image, cols [MONO_MODULEREF_NAME]);
445 module_ref = g_build_filename (base_dir, name, NULL);
446 image->modules [i] = mono_image_open (module_ref, status);
447 if (image->modules [i]) {
448 //g_print ("loaded module %s from %s (%p)\n", module_ref, image->name, image->assembly);
451 * FIXME: what do we do here? it could be a native dll...
452 * We should probably do lazy-loading of modules.
455 *status = MONO_IMAGE_OK;
463 load_class_names (MonoImage *image)
465 MonoTableInfo *t = &image->tables [MONO_TABLE_TYPEDEF];
466 guint32 cols [MONO_TYPEDEF_SIZE];
469 guint32 i, visib, nspace_index;
470 GHashTable *name_cache2, *nspace_table;
472 /* Temporary hash table to avoid lookups in the nspace_table */
473 name_cache2 = g_hash_table_new (NULL, NULL);
475 for (i = 1; i <= t->rows; ++i) {
476 mono_metadata_decode_row (t, i - 1, cols, MONO_TYPEDEF_SIZE);
477 /* nested types are accessed from the nesting name */
478 visib = cols [MONO_TYPEDEF_FLAGS] & TYPE_ATTRIBUTE_VISIBILITY_MASK;
479 if (visib > TYPE_ATTRIBUTE_PUBLIC && visib <= TYPE_ATTRIBUTE_NESTED_ASSEMBLY)
481 name = mono_metadata_string_heap (image, cols [MONO_TYPEDEF_NAME]);
482 nspace = mono_metadata_string_heap (image, cols [MONO_TYPEDEF_NAMESPACE]);
484 nspace_index = cols [MONO_TYPEDEF_NAMESPACE];
485 nspace_table = g_hash_table_lookup (name_cache2, GUINT_TO_POINTER (nspace_index));
487 nspace_table = g_hash_table_new (g_str_hash, g_str_equal);
488 g_hash_table_insert (image->name_cache, (char*)nspace, nspace_table);
489 g_hash_table_insert (name_cache2, GUINT_TO_POINTER (nspace_index),
492 g_hash_table_insert (nspace_table, (char *) name, GUINT_TO_POINTER (i));
495 g_hash_table_destroy (name_cache2);
499 register_guid (gpointer key, gpointer value, gpointer user_data)
501 MonoImage *image = (MonoImage*)value;
503 if (!g_hash_table_lookup (loaded_images_guid_hash, image))
504 g_hash_table_insert (loaded_images_guid_hash, image->guid, image);
508 build_guid_table (void)
510 g_hash_table_foreach (loaded_images_hash, register_guid, NULL);
514 mono_image_init (MonoImage *image)
516 image->method_cache = g_hash_table_new (NULL, NULL);
517 image->class_cache = g_hash_table_new (NULL, NULL);
518 image->name_cache = g_hash_table_new (g_str_hash, g_str_equal);
519 image->array_cache = g_hash_table_new (NULL, NULL);
521 image->delegate_begin_invoke_cache =
522 g_hash_table_new ((GHashFunc)mono_signature_hash,
523 (GCompareFunc)mono_metadata_signature_equal);
524 image->delegate_end_invoke_cache =
525 g_hash_table_new ((GHashFunc)mono_signature_hash,
526 (GCompareFunc)mono_metadata_signature_equal);
527 image->delegate_invoke_cache =
528 g_hash_table_new ((GHashFunc)mono_signature_hash,
529 (GCompareFunc)mono_metadata_signature_equal);
531 image->runtime_invoke_cache = g_hash_table_new (NULL, NULL);
532 image->managed_wrapper_cache = g_hash_table_new (NULL, NULL);
533 image->native_wrapper_cache = g_hash_table_new (NULL, NULL);
534 image->remoting_invoke_cache = g_hash_table_new (NULL, NULL);
535 image->synchronized_cache = g_hash_table_new (NULL, NULL);
537 image->generics_cache = g_hash_table_new ((GHashFunc)mono_metadata_type_hash, (GEqualFunc)mono_metadata_type_equal);
538 image->typespec_cache = g_hash_table_new (NULL, NULL);
542 do_mono_image_load (MonoImage *image, MonoImageOpenStatus *status)
544 MonoCLIImageInfo *iinfo;
545 MonoDotNetHeader *header;
546 MonoMSDOSHeader msdos;
550 mono_image_init (image);
552 iinfo = image->image_info;
553 header = &iinfo->cli_header;
556 *status = MONO_IMAGE_IMAGE_INVALID;
559 if (offset + sizeof (msdos) > image->raw_data_len)
561 memcpy (&msdos, image->raw_data + offset, sizeof (msdos));
563 if (fread (&msdos, sizeof (msdos), 1, image->f) != 1)
567 if (!(msdos.msdos_sig [0] == 'M' && msdos.msdos_sig [1] == 'Z'))
570 msdos.pe_offset = GUINT32_FROM_LE (msdos.pe_offset);
572 if (msdos.pe_offset != sizeof (msdos)) {
574 fseek (image->f, msdos.pe_offset, SEEK_SET);
576 offset = msdos.pe_offset;
579 if (offset + sizeof (MonoDotNetHeader) > image->raw_data_len)
581 memcpy (header, image->raw_data + offset, sizeof (MonoDotNetHeader));
582 offset += sizeof (MonoDotNetHeader);
584 if ((n = fread (header, sizeof (MonoDotNetHeader), 1, image->f)) != 1)
588 #if G_BYTE_ORDER != G_LITTLE_ENDIAN
589 #define SWAP32(x) (x) = GUINT32_FROM_LE ((x))
590 #define SWAP16(x) (x) = GUINT16_FROM_LE ((x))
591 #define SWAPPDE(x) do { (x).rva = GUINT32_FROM_LE ((x).rva); (x).size = GUINT32_FROM_LE ((x).size);} while (0)
592 SWAP32 (header->coff.coff_time);
593 SWAP32 (header->coff.coff_symptr);
594 SWAP32 (header->coff.coff_symcount);
595 SWAP16 (header->coff.coff_machine);
596 SWAP16 (header->coff.coff_sections);
597 SWAP16 (header->coff.coff_opt_header_size);
598 SWAP16 (header->coff.coff_attributes);
600 SWAP32 (header->pe.pe_code_size);
601 SWAP32 (header->pe.pe_data_size);
602 SWAP32 (header->pe.pe_uninit_data_size);
603 SWAP32 (header->pe.pe_rva_entry_point);
604 SWAP32 (header->pe.pe_rva_code_base);
605 SWAP32 (header->pe.pe_rva_data_base);
606 SWAP16 (header->pe.pe_magic);
608 /* MonoPEHeaderNT: not used yet */
609 SWAP32 (header->nt.pe_image_base); /* must be 0x400000 */
610 SWAP32 (header->nt.pe_section_align); /* must be 8192 */
611 SWAP32 (header->nt.pe_file_alignment); /* must be 512 or 4096 */
612 SWAP16 (header->nt.pe_os_major); /* must be 4 */
613 SWAP16 (header->nt.pe_os_minor); /* must be 0 */
614 SWAP16 (header->nt.pe_user_major);
615 SWAP16 (header->nt.pe_user_minor);
616 SWAP16 (header->nt.pe_subsys_major);
617 SWAP16 (header->nt.pe_subsys_minor);
618 SWAP32 (header->nt.pe_reserved_1);
619 SWAP32 (header->nt.pe_image_size);
620 SWAP32 (header->nt.pe_header_size);
621 SWAP32 (header->nt.pe_checksum);
622 SWAP16 (header->nt.pe_subsys_required);
623 SWAP16 (header->nt.pe_dll_flags);
624 SWAP32 (header->nt.pe_stack_reserve);
625 SWAP32 (header->nt.pe_stack_commit);
626 SWAP32 (header->nt.pe_heap_reserve);
627 SWAP32 (header->nt.pe_heap_commit);
628 SWAP32 (header->nt.pe_loader_flags);
629 SWAP32 (header->nt.pe_data_dir_count);
631 /* MonoDotNetHeader: mostly unused */
632 SWAPPDE (header->datadir.pe_export_table);
633 SWAPPDE (header->datadir.pe_import_table);
634 SWAPPDE (header->datadir.pe_resource_table);
635 SWAPPDE (header->datadir.pe_exception_table);
636 SWAPPDE (header->datadir.pe_certificate_table);
637 SWAPPDE (header->datadir.pe_reloc_table);
638 SWAPPDE (header->datadir.pe_debug);
639 SWAPPDE (header->datadir.pe_copyright);
640 SWAPPDE (header->datadir.pe_global_ptr);
641 SWAPPDE (header->datadir.pe_tls_table);
642 SWAPPDE (header->datadir.pe_load_config_table);
643 SWAPPDE (header->datadir.pe_bound_import);
644 SWAPPDE (header->datadir.pe_iat);
645 SWAPPDE (header->datadir.pe_delay_import_desc);
646 SWAPPDE (header->datadir.pe_cli_header);
647 SWAPPDE (header->datadir.pe_reserved);
654 if (header->coff.coff_machine != 0x14c)
657 if (header->coff.coff_opt_header_size != (sizeof (MonoDotNetHeader) - sizeof (MonoCOFFHeader) - 4))
660 if (header->pesig[0] != 'P' || header->pesig[1] != 'E' || header->pe.pe_magic != 0x10B)
665 * The spec says that this field should contain 6.0, but Visual Studio includes a new compiler,
666 * which produces binaries with 7.0. From Sergey:
668 * The reason is that MSVC7 uses traditional compile/link
669 * sequence for CIL executables, and VS.NET (and Framework
670 * SDK) includes linker version 7, that puts 7.0 in this
671 * field. That's why it's currently not possible to load VC
672 * binaries with Mono. This field is pretty much meaningless
673 * anyway (what linker?).
675 if (header->pe.pe_major != 6 || header->pe.pe_minor != 0)
680 * FIXME: byte swap all addresses here for header.
683 if (!load_section_tables (image, iinfo, offset))
686 /* Load the CLI header */
687 if (!load_cli_header (image, iinfo))
690 if (!load_metadata (image, iinfo))
693 load_class_names (image);
695 /* modules don't have an assembly table row */
696 if (image->tables [MONO_TABLE_ASSEMBLY].rows)
697 image->assembly_name = mono_metadata_string_heap (image,
698 mono_metadata_decode_row_col (&image->tables [MONO_TABLE_ASSEMBLY],
699 0, MONO_ASSEMBLY_NAME));
701 image->module_name = mono_metadata_string_heap (image,
702 mono_metadata_decode_row_col (&image->tables [MONO_TABLE_MODULE],
703 0, MONO_MODULE_NAME));
705 load_modules (image, status);
708 *status = MONO_IMAGE_OK;
715 mono_image_close (image);
720 do_mono_image_open (const char *fname, MonoImageOpenStatus *status)
722 MonoCLIImageInfo *iinfo;
726 if ((filed = fopen (fname, "rb")) == NULL){
728 *status = MONO_IMAGE_ERROR_ERRNO;
732 image = g_new0 (MonoImage, 1);
733 image->ref_count = 1;
735 image->name = g_strdup (fname);
736 iinfo = g_new0 (MonoCLIImageInfo, 1);
737 image->image_info = iinfo;
739 return do_mono_image_load (image, status);
743 mono_image_loaded (const char *name)
747 if (strcmp (name, "corlib") == 0)
750 EnterCriticalSection (&images_mutex);
751 res = g_hash_table_lookup (loaded_images_hash, name);
752 LeaveCriticalSection (&images_mutex);
757 mono_image_loaded_by_guid (const char *guid)
761 EnterCriticalSection (&images_mutex);
762 res = g_hash_table_lookup (loaded_images_guid_hash, guid);
763 LeaveCriticalSection (&images_mutex);
768 mono_image_open_from_data (char *data, guint32 data_len, gboolean need_copy, MonoImageOpenStatus *status)
770 MonoCLIImageInfo *iinfo;
774 if (!data || !data_len) {
776 *status = MONO_IMAGE_IMAGE_INVALID;
781 datac = g_try_malloc (data_len);
784 *status = MONO_IMAGE_ERROR_ERRNO;
787 memcpy (datac, data, data_len);
790 image = g_new0 (MonoImage, 1);
791 image->ref_count = 1;
792 image->raw_data = datac;
793 image->raw_data_len = data_len;
794 image->raw_data_allocated = need_copy;
795 image->name = g_strdup_printf ("data-%p", datac);
796 iinfo = g_new0 (MonoCLIImageInfo, 1);
797 image->image_info = iinfo;
799 return do_mono_image_load (image, status);
804 * @fname: filename that points to the module we want to open
805 * @status: An error condition is returned in this field
807 * Retuns: An open image of type %MonoImage or NULL on error.
808 * if NULL, then check the value of @status for details on the error
811 mono_image_open (const char *fname, MonoImageOpenStatus *status)
813 MonoImage *image, *image2;
815 g_return_val_if_fail (fname != NULL, NULL);
818 * The easiest solution would be to do all the loading inside the mutex,
819 * but that would lead to scalability problems. So we let the loading
820 * happen outside the mutex, and if multiple threads happen to load
821 * the same image, we discard all but the first copy.
823 EnterCriticalSection (&images_mutex);
824 image = g_hash_table_lookup (loaded_images_hash, fname);
827 LeaveCriticalSection (&images_mutex);
830 LeaveCriticalSection (&images_mutex);
832 image = do_mono_image_open (fname, status);
836 EnterCriticalSection (&images_mutex);
837 image2 = g_hash_table_lookup (loaded_images_hash, fname);
839 /* Somebody else beat us to it */
840 image2->ref_count ++;
841 LeaveCriticalSection (&images_mutex);
842 mono_image_close (image);
846 g_hash_table_insert (loaded_images_hash, image->name, image);
847 if (image->assembly_name)
848 g_hash_table_insert (loaded_images_hash, (char *) image->assembly_name, image);
849 g_hash_table_insert (loaded_images_guid_hash, image->guid, image);
850 LeaveCriticalSection (&images_mutex);
856 free_hash_table (gpointer key, gpointer val, gpointer user_data)
858 g_hash_table_destroy ((GHashTable*)val);
863 * @image: The image file we wish to close
865 * Closes an image file, deallocates all memory consumed and
866 * unmaps all possible sections of the file
869 mono_image_close (MonoImage *image)
873 g_return_if_fail (image != NULL);
875 EnterCriticalSection (&images_mutex);
876 if (--image->ref_count) {
877 LeaveCriticalSection (&images_mutex);
880 image2 = g_hash_table_lookup (loaded_images_hash, image->name);
881 if (image == image2) {
882 /* This is not true if we are called from mono_image_open () */
883 g_hash_table_remove (loaded_images_hash, image->name);
884 if (image->assembly_name)
885 g_hash_table_remove (loaded_images_hash, (char *) image->assembly_name);
886 g_hash_table_remove (loaded_images_guid_hash, image->guid);
887 /* Multiple images might have the same guid */
890 LeaveCriticalSection (&images_mutex);
894 if (image->raw_data_allocated)
895 g_free (image->raw_data);
897 g_free (image->name);
899 g_hash_table_destroy (image->method_cache);
900 g_hash_table_destroy (image->class_cache);
901 g_hash_table_destroy (image->array_cache);
902 g_hash_table_foreach (image->name_cache, free_hash_table, NULL);
903 g_hash_table_destroy (image->name_cache);
904 g_hash_table_destroy (image->native_wrapper_cache);
905 g_hash_table_destroy (image->managed_wrapper_cache);
906 g_hash_table_destroy (image->delegate_begin_invoke_cache);
907 g_hash_table_destroy (image->delegate_end_invoke_cache);
908 g_hash_table_destroy (image->delegate_invoke_cache);
909 g_hash_table_destroy (image->remoting_invoke_cache);
910 g_hash_table_destroy (image->runtime_invoke_cache);
912 if (image->raw_metadata != NULL)
913 mono_raw_buffer_free (image->raw_metadata);
915 if (image->image_info){
916 MonoCLIImageInfo *ii = image->image_info;
919 for (i = 0; i < ii->cli_section_count; i++){
920 if (!ii->cli_sections [i])
922 mono_raw_buffer_free (ii->cli_sections [i]);
924 if (ii->cli_section_tables)
925 g_free (ii->cli_section_tables);
926 if (ii->cli_sections)
927 g_free (ii->cli_sections);
928 g_free (image->image_info);
935 * mono_image_strerror:
936 * @status: an code indicating the result from a recent operation
938 * Returns: a string describing the error
941 mono_image_strerror (MonoImageOpenStatus status)
946 case MONO_IMAGE_ERROR_ERRNO:
947 return strerror (errno);
948 case MONO_IMAGE_IMAGE_INVALID:
949 return "File does not contain a valid CIL image";
950 case MONO_IMAGE_MISSING_ASSEMBLYREF:
951 return "An assembly was referenced, but could not be found";
953 return "Internal error";
957 mono_image_walk_resource_tree (MonoCLIImageInfo *info, guint32 res_id,
958 guint32 lang_id, gunichar2 *name,
959 MonoPEResourceDirEntry *entry,
960 MonoPEResourceDir *root, guint32 level)
962 gboolean is_string=entry->name_is_string;
964 /* Level 0 holds a directory entry for each type of resource
965 * (identified by ID or name).
967 * Level 1 holds a directory entry for each named resource
968 * item, and each "anonymous" item of a particular type of
971 * Level 2 holds a directory entry for each language pointing to
976 if((is_string==FALSE && entry->name_offset!=res_id) ||
980 } else if (level==1) {
983 is_string==TRUE && name!=lookup (entry->name_offset)) {
987 } else if (level==2) {
988 if((is_string==FALSE && entry->name_offset!=lang_id) ||
993 g_assert_not_reached ();
996 if(entry->is_dir==TRUE) {
997 MonoPEResourceDir *res_dir=(MonoPEResourceDir *)(((char *)root)+entry->dir_offset);
998 MonoPEResourceDirEntry *sub_entries=(MonoPEResourceDirEntry *)(res_dir+1);
1001 entries=res_dir->res_named_entries + res_dir->res_id_entries;
1003 for(i=0; i<entries; i++) {
1004 MonoPEResourceDirEntry *sub_entry=&sub_entries[i];
1007 ret=mono_image_walk_resource_tree (info, res_id,
1018 MonoPEResourceDataEntry *data_entry=(MonoPEResourceDataEntry *)((char *)(root)+entry->dir_offset);
1025 mono_image_lookup_resource (MonoImage *image, guint32 res_id, guint32 lang_id, gunichar2 *name)
1027 MonoCLIImageInfo *info;
1028 MonoDotNetHeader *header;
1029 MonoPEDatadir *datadir;
1030 MonoPEDirEntry *rsrc;
1031 MonoPEResourceDir *resource_dir;
1032 MonoPEResourceDirEntry *res_entries;
1039 info=image->image_info;
1044 header=&info->cli_header;
1049 datadir=&header->datadir;
1054 rsrc=&datadir->pe_resource_table;
1059 resource_dir=(MonoPEResourceDir *)mono_cli_rva_map (info, rsrc->rva);
1060 if(resource_dir==NULL) {
1064 entries=resource_dir->res_named_entries + resource_dir->res_id_entries;
1065 res_entries=(MonoPEResourceDirEntry *)(resource_dir+1);
1067 for(i=0; i<entries; i++) {
1068 MonoPEResourceDirEntry *entry=&res_entries[i];
1071 ret=mono_image_walk_resource_tree (info, res_id, lang_id,
1072 name, entry, resource_dir,
1083 mono_image_get_entry_point (MonoImage *image)
1085 return ((MonoCLIImageInfo*)image->image_info)->cli_cli_header.ch_entry_point;
1089 mono_image_get_resource (MonoImage *image, guint32 offset, guint32 *size)
1091 MonoCLIImageInfo *iinfo = image->image_info;
1092 MonoCLIHeader *ch = &iinfo->cli_cli_header;
1095 if (!ch->ch_resources.rva || offset + 4 > ch->ch_resources.size)
1098 data = mono_cli_rva_map (iinfo, ch->ch_resources.rva);
1103 *size = read32 (data);
1109 mono_image_load_file_for_image (MonoImage *image, int fileidx)
1111 char *base_dir, *name;
1113 MonoTableInfo *t = &image->tables [MONO_TABLE_FILE];
1117 if (fileidx < 1 || fileidx > t->rows)
1119 fname_id = mono_metadata_decode_row_col (t, fileidx - 1, MONO_FILE_NAME);
1120 fname = mono_metadata_string_heap (image, fname_id);
1121 base_dir = g_path_get_dirname (image->name);
1122 name = g_build_filename (base_dir, fname, NULL);
1123 res = mono_image_open (name, NULL);
1126 t = &res->tables [MONO_TABLE_MODULEREF];
1127 //g_print ("loaded file %s from %s (%p)\n", name, image->name, image->assembly);
1128 res->assembly = image->assembly;
1129 for (i = 0; i < t->rows; ++i) {
1130 if (res->modules [i] && !res->modules [i]->assembly)
1131 res->modules [i]->assembly = image->assembly;
1140 mono_image_get_strong_name (MonoImage *image, guint32 *size)
1142 MonoCLIImageInfo *iinfo = image->image_info;
1143 MonoPEDirEntry *de = &iinfo->cli_cli_header.ch_strong_name;
1146 if (!de->size || !de->rva)
1148 data = mono_cli_rva_map (iinfo, de->rva);
1157 mono_image_strong_name_position (MonoImage *image, guint32 *size)
1159 MonoCLIImageInfo *iinfo = image->image_info;
1160 MonoPEDirEntry *de = &iinfo->cli_cli_header.ch_strong_name;
1161 const int top = iinfo->cli_section_count;
1162 MonoSectionTable *tables = iinfo->cli_section_tables;
1164 guint32 addr = de->rva;
1168 if (!de->size || !de->rva)
1170 for (i = 0; i < top; i++){
1171 if ((addr >= tables->st_virtual_address) &&
1172 (addr < tables->st_virtual_address + tables->st_raw_data_size)){
1173 return tables->st_raw_data_ptr +
1174 (addr - tables->st_virtual_address);
1183 mono_image_get_public_key (MonoImage *image, guint32 *size)
1187 if (image->tables [MONO_TABLE_ASSEMBLY].rows != 1)
1189 tok = mono_metadata_decode_row_col (&image->tables [MONO_TABLE_ASSEMBLY], 0, MONO_ASSEMBLY_PUBLIC_KEY);
1192 pubkey = mono_metadata_blob_heap (image, tok);
1193 len = mono_metadata_decode_blob_size (pubkey, &pubkey);