mono/metadata/assembly.h

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