mono/metadata/assembly.h

   1 /**
   2  * \file
   3  */
   4
   5 #ifndef _MONONET_METADATA_ASSEMBLY_H_
   6 #define _MONONET_METADATA_ASSEMBLY_H_
   7
   8 #include <mono/utils/mono-error.h>
   9 #include <mono/metadata/image.h>
  10
  11 MONO_BEGIN_DECLS
  12
  13 MONO_API void          mono_assemblies_init     (void);
  14 MONO_API void          mono_assemblies_cleanup  (void);
  15 MONO_API MONO_RT_EXTERNAL_ONLY
  16 MonoAssembly *mono_assembly_open       (const char *filename,
  17                                         MonoImageOpenStatus *status);
  18 MONO_API MONO_RT_EXTERNAL_ONLY
  19 MonoAssembly *mono_assembly_open_full (const char *filename,
  20                                         MonoImageOpenStatus *status,
  21                                         mono_bool refonly);
  22 MONO_API MONO_RT_EXTERNAL_ONLY
  23 MonoAssembly* mono_assembly_load       (MonoAssemblyName *aname,
  24                                         const char       *basedir,
  25                                         MonoImageOpenStatus *status);
  26 MONO_API MONO_RT_EXTERNAL_ONLY
  27 MonoAssembly* mono_assembly_load_full (MonoAssemblyName *aname,
  28                                         const char       *basedir,
  29                                         MonoImageOpenStatus *status,
  30                                         mono_bool refonly);
  31 MONO_API MONO_RT_EXTERNAL_ONLY
  32 MonoAssembly* mono_assembly_load_from  (MonoImage *image, const char *fname,
  33                                         MonoImageOpenStatus *status);
  34 MONO_API MONO_RT_EXTERNAL_ONLY
  35 MonoAssembly* mono_assembly_load_from_full  (MonoImage *image, const char *fname,
  36                                         MonoImageOpenStatus *status,
  37                                         mono_bool refonly);
  38
  39 MONO_API MONO_RT_EXTERNAL_ONLY
  40 MonoAssembly* mono_assembly_load_with_partial_name (const char *name, MonoImageOpenStatus *status);
  41
  42 MONO_API MONO_RT_EXTERNAL_ONLY
  43 MonoAssembly* mono_assembly_loaded     (MonoAssemblyName *aname);
  44 MONO_API MONO_RT_EXTERNAL_ONLY
  45 MonoAssembly* mono_assembly_loaded_full (MonoAssemblyName *aname, mono_bool refonly);
  46 MONO_API void          mono_assembly_get_assemblyref (MonoImage *image, int index, MonoAssemblyName *aname);
  47 MONO_API void          mono_assembly_load_reference (MonoImage *image, int index);
  48 MONO_API void          mono_assembly_load_references (MonoImage *image, MonoImageOpenStatus *status);
  49 MONO_API MONO_RT_EXTERNAL_ONLY MonoImage*    mono_assembly_load_module (MonoAssembly *assembly, uint32_t idx);
  50 MONO_API void          mono_assembly_close      (MonoAssembly *assembly);
  51 MONO_API void          mono_assembly_setrootdir (const char *root_dir);
  52 MONO_API MONO_CONST_RETURN char *mono_assembly_getrootdir (void);
  53 MONO_API char         *mono_native_getrootdir (void);
  54 MONO_API void          mono_assembly_foreach    (MonoFunc func, void* user_data);
  55 MONO_API void          mono_assembly_set_main   (MonoAssembly *assembly);
  56 MONO_API MonoAssembly *mono_assembly_get_main   (void);
  57 MONO_API MONO_RT_EXTERNAL_ONLY
  58 MonoImage    *mono_assembly_get_image  (MonoAssembly *assembly);
  59 MONO_API MONO_RT_EXTERNAL_ONLY
  60 MonoAssemblyName *mono_assembly_get_name (MonoAssembly *assembly);
  61 MONO_API mono_bool      mono_assembly_fill_assembly_name (MonoImage *image, MonoAssemblyName *aname);
  62 MONO_API mono_bool      mono_assembly_names_equal (MonoAssemblyName *l, MonoAssemblyName *r);
  63 MONO_API char*         mono_stringify_assembly_name (MonoAssemblyName *aname);
  64
  65 /* Installs a function which is called each time a new assembly is loaded. */
  66 typedef void  (*MonoAssemblyLoadFunc)         (MonoAssembly *assembly, void* user_data);
  67 MONO_API MONO_RT_EXTERNAL_ONLY void
  68 mono_install_assembly_load_hook (MonoAssemblyLoadFunc func, void* user_data);
  69
  70 /*
  71  * Installs a new function which is used to search the list of loaded
  72  * assemblies for a given assembly name.
  73  */
  74 typedef MonoAssembly *(*MonoAssemblySearchFunc)         (MonoAssemblyName *aname, void* user_data);
  75 MONO_API MONO_RT_EXTERNAL_ONLY
  76 void          mono_install_assembly_search_hook (MonoAssemblySearchFunc func, void* user_data);
  77 MONO_API MONO_RT_EXTERNAL_ONLY
  78 void          mono_install_assembly_refonly_search_hook (MonoAssemblySearchFunc func, void* user_data);
  79
  80 MONO_API MONO_RT_EXTERNAL_ONLY
  81 MonoAssembly* mono_assembly_invoke_search_hook (MonoAssemblyName *aname);
  82
  83 /*
  84  * Installs a new search function which is used as a last resort when loading
  85  * an assembly fails. This could invoke AssemblyResolve events.
  86  */
  87 MONO_API MONO_RT_EXTERNAL_ONLY
  88 void
  89 mono_install_assembly_postload_search_hook (MonoAssemblySearchFunc func, void* user_data);
  90
  91 MONO_API MONO_RT_EXTERNAL_ONLY
  92 void
  93 mono_install_assembly_postload_refonly_search_hook (MonoAssemblySearchFunc func, void* user_data);
  94
  95
  96 /* Installs a function which is called before a new assembly is loaded
  97  * The hook are invoked from last hooked to first. If any of them returns
  98  * a non-null value, that will be the value returned in mono_assembly_load */
  99 typedef MonoAssembly * (*MonoAssemblyPreLoadFunc) (MonoAssemblyName *aname,
 100                                                    char **assemblies_path,
 101                                                    void* user_data);
 102
 103 MONO_API MONO_RT_EXTERNAL_ONLY
 104 void          mono_install_assembly_preload_hook (MonoAssemblyPreLoadFunc func, void* user_data);
 105 MONO_API MONO_RT_EXTERNAL_ONLY
 106 void          mono_install_assembly_refonly_preload_hook (MonoAssemblyPreLoadFunc func, void* user_data);
 107
 108 MONO_API MONO_RT_EXTERNAL_ONLY void
 109 mono_assembly_invoke_load_hook (MonoAssembly *ass);
 110
 111 MONO_API MonoAssemblyName* mono_assembly_name_new             (const char *name);
 112 MONO_API const char*       mono_assembly_name_get_name        (MonoAssemblyName *aname);
 113 MONO_API const char*       mono_assembly_name_get_culture     (MonoAssemblyName *aname);
 114 MONO_API uint16_t          mono_assembly_name_get_version     (MonoAssemblyName *aname,
 115                                                       uint16_t *minor, uint16_t *build, uint16_t *revision);
 116 MONO_API mono_byte*        mono_assembly_name_get_pubkeytoken (MonoAssemblyName *aname);
 117 MONO_API MONO_RT_EXTERNAL_ONLY void mono_assembly_name_free   (MonoAssemblyName *aname);
 118
 119 typedef struct {
 120         const char *name;
 121         const unsigned char *data;
 122         unsigned int size;
 123 } MonoBundledAssembly;
 124
 125 MONO_API void          mono_register_bundled_assemblies (const MonoBundledAssembly **assemblies);
 126 MONO_API void          mono_register_config_for_assembly (const char* assembly_name, const char* config_xml);
 127 MONO_API void          mono_register_symfile_for_assembly (const char* assembly_name, const mono_byte *raw_contents, int size);
 128 MONO_API void         mono_register_machine_config (const char *config_xml);
 129
 130 MONO_API void          mono_set_rootdir (void);
 131 MONO_API void          mono_set_dirs (const char *assembly_dir, const char *config_dir);
 132 MONO_API void          mono_set_assemblies_path (const char* path);
 133 MONO_END_DECLS
 134
 135 #endif
 136