mono-api-jitinternal.html

## Internal Runtime Utility Functions

### SHA1 Signatures

`mono_sha1_init`
Syntax
void mono_sha1_init (MonoSHA1Context* context)

`mono_sha1_update`
Syntax
void mono_sha1_update (MonoSHA1Context* context, const guchar* data, guint32 len)

`mono_sha1_get_digest_from_file`
Syntax
void mono_sha1_get_digest_from_file (const gchar *filename, guchar digest [20])

Parameters

filename | file name
digest | 20-byte buffer receiving the hash code.

Description

Get the SHA-1 hash of a file. The result is put in the 20-byte buffer digest.

If an IO error happens the value in digest is not updated.
`mono_sha1_get_digest`
Syntax
void mono_sha1_get_digest (const guchar *buffer, gint buffer_size, guchar digest [20])

`mono_sha1_final`
Syntax
void mono_sha1_final (MonoSHA1Context* context, unsigned char digest[20])

### MD5 Signatures

`mono_md5_init`
Syntax
void mono_md5_init (MonoMD5Context *ctx)

`mono_md5_update`
Syntax
void mono_md5_update (MonoMD5Context *ctx, const guchar *buf, guint32 len)

`mono_md5_get_digest_from_file`
Syntax
void mono_md5_get_digest_from_file (const gchar *filename, guchar digest[16])

Parameters

filename | file name
digest | 16-byte buffer receiving the hash code.

Description

Get the MD5 hash of a file. The result is put in the 16-byte buffer digest.

If an IO error happens the value in digest is not updated.
`mono_md5_get_digest`
Syntax
void mono_md5_get_digest (const guchar *buffer, gint buffer_size, guchar digest[16])

Parameters

buffer | byte buffer
buffer_size | buffer size (in bytes)
digest | 16-byte buffer receiving the hash code.

Description

Get the MD5 hash of a buffer. The result is put in the 16-byte buffer digest.
`mono_md5_final`
Syntax
void mono_md5_final (MonoMD5Context *ctx, guchar digest[16])

`mono_digest_get_public_token`
Syntax
void mono_digest_get_public_token (guchar* token, const guchar *pubkey, guint32 len)

Description

Get the public token from public key data. token must point to at least 8 bytes of storage.

### Hashtables

`GHashTable` is used when you need to store object references into a hashtable, objects stored in a `MonoGHashTable` are properly tracked by the garbage collector.

The `MonoGHashTable` data type has the same API as the GLIB.
`mono_g_hash_table_destroy`
Syntax
void mono_g_hash_table_destroy (MonoGHashTable *hash)

`mono_g_hash_table_foreach`
Syntax
void mono_g_hash_table_foreach (MonoGHashTable *hash, GHFunc func, gpointer user_data)

`mono_g_hash_table_foreach_remove`
Syntax
guint mono_g_hash_table_foreach_remove (MonoGHashTable *hash, GHRFunc func, gpointer user_data)

`mono_g_hash_table_insert`
Syntax
void mono_g_hash_table_insert (MonoGHashTable *h, gpointer k, gpointer v)

`mono_g_hash_table_lookup`
Syntax
gpointer mono_g_hash_table_lookup (MonoGHashTable *hash, gconstpointer key)

`mono_g_hash_table_lookup_extended`
Syntax
gboolean mono_g_hash_table_lookup_extended (MonoGHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value)

`mono_g_hash_table_remove`
Syntax
gboolean mono_g_hash_table_remove (MonoGHashTable *hash, gconstpointer key)

`mono_g_hash_table_replace`
Syntax
void mono_g_hash_table_replace(MonoGHashTable *h, gpointer k, gpointer v)

`mono_g_hash_table_size`
Syntax
guint mono_g_hash_table_size (MonoGHashTable *hash)

### Memory Pools

Memory pools are a convenient way of tracking memory allocations that are used for one specific task, they are also faster than using the standard memory allocation procedures, as they are designed to be used only by a single thread at a time.

`MonoMemPool` objects are not thread safe, which means that you should not share the objects across multiple threads without providing proper locking around it (unlike `malloc` and `free` which are thread safe).

When a `MonoMemPool` is released with `mono_mempool_destroy` all of the of the memory allocated from that memory pool with `mono_mempool_alloc` and `mono_mempool_alloc0` is released.
`mono_mempool_new`
Syntax
MonoMemPool* mono_mempool_new (void)

Return value
a new memory pool.
Description

`mono_mempool_destroy`
Syntax
void mono_mempool_destroy (MonoMemPool *pool)

Parameters

pool | the memory pool to destroy

Description

Free all memory associated with this pool.
`mono_mempool_alloc`
Syntax
gpointer mono_mempool_alloc (MonoMemPool *pool, guint size)

Parameters

pool | the memory pool to use
size | size of the memory block

Return value
the address of a newly allocated memory block.
Description

Allocates a new block of memory in pool .

`mono_mempool_alloc0`
Syntax
gpointer mono_mempool_alloc0 (MonoMemPool *pool, guint size)

Description

same as `mono_mempool_alloc`, but fills memory with zero.
`mono_mempool_invalidate`
Syntax
void mono_mempool_invalidate (MonoMemPool *pool)

Parameters

pool | the memory pool to invalidate

Description

Fill the memory associated with this pool to 0x2a (42). Useful for debugging.
`mono_mempool_stats`
Syntax
void mono_mempool_stats (MonoMemPool *pool)

Parameters

pool | the memory pool we need stats for

Description

Print a few stats about the mempool: - Total memory allocated (malloced) by mem pool - Number of chunks/blocks memory is allocated in - How much memory is available to dispense before a new malloc must occur?
`mono_mempool_contains_addr`
Syntax
gboolean mono_mempool_contains_addr (MonoMemPool *pool, gpointer addr)

Description

Determines whether addr is inside the memory used by the mempool.

### Bitsets

MonoBitsets are a set of routines used to manipulate sets of bits.
`mono_bitset_alloc_size`
Syntax
guint32 mono_bitset_alloc_size (guint32 max_size, guint32 flags)

Parameters

max_size | The number of bits you want to hold
flags | unused

Return value
the number of bytes required to hold the bitset. Useful to allocate it on the stack or with mempool. Use with `mono_bitset_mem_new`.
`mono_bitset_clear`
Syntax
void mono_bitset_clear (MonoBitSet *set, guint32 pos)

Parameters

set | bitset ptr
pos | unset bit at this pos

Description

Unset bit at pos, counting from 0.
`mono_bitset_clear_all`
Syntax
void mono_bitset_clear_all (MonoBitSet *set)

Parameters

set | bitset ptr

Description

Unset all bits.
`mono_bitset_clone`
Syntax
MonoBitSet* mono_bitset_clone (const MonoBitSet *set, guint32 new_size)

Parameters

set | bitset ptr to clone
new_size | number of bits the cloned bitset can hold

Return value
a cloned bitset of size new_size. `MONO_BITSET_DONT_FREE` unset in cloned bitset. If new_size is 0, the cloned object is just as big.
`mono_bitset_copyto`
Syntax
void mono_bitset_copyto (const MonoBitSet *src, MonoBitSet *dest)

Parameters

src | bitset ptr to copy from
dest | bitset ptr to copy to

Description

Copy one bitset to another.
`mono_bitset_count`
Syntax
guint32 mono_bitset_count (const MonoBitSet *set)

Parameters

set | bitset ptr

Return value
number of bits that are set.
`mono_bitset_equal`
Syntax
gboolean mono_bitset_equal (const MonoBitSet *src, const MonoBitSet *src1)

Parameters

src | bitset ptr
src1 | bitset ptr

Return value
`TRUE` if their size are the same and the same bits are set in both bitsets.
`mono_bitset_find_first`
Syntax
int mono_bitset_find_first (const MonoBitSet *set, gint pos)

Parameters

set | bitset ptr
pos | pos to search after (not including)

Return value
position of first set bit after pos. If pos `-1` if no bit set is found.
`mono_bitset_find_last`
Syntax
int mono_bitset_find_last (const MonoBitSet *set, gint pos)

Parameters

set | bitset ptr
pos | pos to search before (not including)

Return value
position of last set bit before pos. If pos `-1` if no set bit is found.
`mono_bitset_find_start`
Syntax
int mono_bitset_find_start (const MonoBitSet *set)

Parameters

set | bitset ptr

Description
Equivalent to `mono_bitset_find_first (set, -1)` but faster.
`mono_bitset_foreach`
Syntax
void mono_bitset_foreach (MonoBitSet *set, MonoBitSetFunc func, gpointer data)

Parameters

set | bitset ptr
func | Function to call for every set bit
data | pass this as second arg to func

Description
Calls func for every bit set in bitset. Argument 1 is the number of the bit set, argument 2 is data
`mono_bitset_free`
Syntax
mono_bitset_free

`mono_bitset_intersection`
Syntax
void mono_bitset_intersection (MonoBitSet *dest, const MonoBitSet *src)

Parameters

dest | bitset ptr to hold intersection
src | bitset ptr to copy

Description

Make intersection of one bitset and another.
`mono_bitset_invert`
Syntax
void mono_bitset_invert (MonoBitSet *set)

Parameters

set | bitset ptr

Description

Flip all bits.
`mono_bitset_mem_new`
Syntax
MonoBitSet* mono_bitset_mem_new (gpointer mem, guint32 max_size, guint32 flags)

Parameters

mem | The location the bitset is stored
max_size | The number of bits you want to hold
flags | bitfield of flags

Description

Return mem, which is now a initialized bitset of size max_size. It is not freed even if called with `mono_bitset_free`. mem must be at least as big as `mono_bitset_alloc_size` returns for the same max_size.
`mono_bitset_new`
Syntax
MonoBitSet* mono_bitset_new (guint32 max_size, guint32 flags)

Parameters

max_size | The numer of bits you want to hold
flags | bitfield of flags

Return value
a bitset of size max_size. It must be freed using `mono_bitset_free`.
`mono_bitset_set`
Syntax
void mono_bitset_set (MonoBitSet *set, guint32 pos)

Parameters

set | bitset ptr
pos | set bit at this pos

Description

Set bit at pos, counting from 0.
`mono_bitset_set_all`
Syntax
void mono_bitset_set_all (MonoBitSet *set)

Parameters

set | bitset ptr

Description

Set all bits.
`mono_bitset_size`
Syntax
guint32 mono_bitset_size (const MonoBitSet *set)

Parameters

set | bitset ptr

Return value
the number of bits this bitset can hold.
`mono_bitset_sub`
Syntax
void mono_bitset_sub (MonoBitSet *dest, const MonoBitSet *src)

Parameters

dest | bitset ptr to hold bitset - src
src | bitset ptr to copy

Description

Unset all bits in dest that are set in src.
`mono_bitset_test`
Syntax
int mono_bitset_test (const MonoBitSet *set, guint32 pos)

Parameters

set | bitset ptr
pos | test bit at this pos

Return value
a nonzero value if set, 0 otherwise.
Description
Test bit at pos, counting from 0.
`mono_bitset_test_bulk`
Syntax
gsize mono_bitset_test_bulk (const MonoBitSet *set, guint32 pos)

Parameters

set | bitset ptr
pos | test bit at this pos

Return value
32/64 bits from the bitset, starting from pos, which must be divisible with 32/64.
`mono_bitset_union`
Syntax
void mono_bitset_union (MonoBitSet *dest, const MonoBitSet *src)

Parameters

dest | bitset ptr to hold union
src | bitset ptr to copy

Description

Make union of one bitset and another.
`mono_bitset_find_first_unset`
Syntax
int mono_bitset_find_first_unset (const MonoBitSet *set, gint pos)

Parameters

set | bitset ptr
pos | pos to search after (not including)

Return value
position of first unset bit after pos. If pos `-1` if no bit set is found.
`mono_bitset_intersection_2`
Syntax
void mono_bitset_intersection_2 (MonoBitSet *dest, const MonoBitSet *src1, const MonoBitSet *src2)

Parameters

dest | bitset ptr to hold intersection
src1 | first bitset
src2 | second bitset

Description

Make intersection of two bitsets

### JIT utilities

`mono_signbit_double`
Syntax
int mono_signbit_double (double x)

`mono_signbit_float`
Syntax
int mono_signbit_float (float x)

### Function Pointers

To wrap a function pointer into something that the Mono runtime can consume, you should use the mono_create_ftnptr. This is only important if you plan on running on the IA64 architecture. Otherwise you can just use the function pointer address.
`mono_create_ftnptr`
Syntax
gpointer mono_create_ftnptr (MonoDomain *domain, gpointer addr)

Description

Given a function address, create a function descriptor for it. This is only needed on some platforms.

## Notification Interface

This is an internal profiler interface. In general, users would not be using this interface, but would be using the profiler interface.

These methods must be called to notify the profiler of an event that must be recorded. Mono's JIT engine currently calls these routines, but if you are extending Mono in some way these are the methods that you might invoke to notify the profiler of an event.
`mono_profiler_load`
Syntax
void mono_profiler_load (const char *desc)

Description

Loads a profiler module based on the specified description. desc can be of the form `name:args` or just `name`. For example, `log:sample` and `log` will both load `libmono-profiler-log.so`. The description is passed to the module after it has been loaded. If the specified module has already been loaded, this function has no effect.

A module called `foo` should declare an entry point like so:

     void mono_profiler_init_foo (const char *desc)
     {
     }

This function is not async safe.

This function may only be called by embedders prior to running managed code.
`mono_profiler_allocation`
Syntax
mono_profiler_allocation

`mono_profiler_stat_hit`
Syntax
mono_profiler_stat_hit

`mono_profiler_thread_start`
Syntax
mono_profiler_thread_start

`mono_profiler_thread_end`
Syntax
mono_profiler_thread_end

`mono_profiler_appdomain_event`
Syntax
mono_profiler_appdomain_event

`mono_profiler_appdomain_loaded`
Syntax
mono_profiler_appdomain_loaded

`mono_profiler_assembly_event`
Syntax
mono_profiler_assembly_event

`mono_profiler_assembly_loaded`
Syntax
mono_profiler_assembly_loaded

`mono_profiler_class_event`
Syntax
mono_profiler_class_event

`mono_profiler_class_loaded`
Syntax
mono_profiler_class_loaded

`mono_profiler_code_transition`
Syntax
mono_profiler_code_transition

`mono_profiler_method_end_jit`
Syntax
mono_profiler_method_end_jit

`mono_profiler_method_enter`
Syntax
mono_profiler_method_enter

`mono_profiler_method_jit`
Syntax
mono_profiler_method_jit

`mono_profiler_method_leave`
Syntax
mono_profiler_method_leave

`mono_profiler_module_event`
Syntax
mono_profiler_module_event

`mono_profiler_module_loaded`
Syntax
mono_profiler_module_loaded

`mono_profiler_shutdown`
Syntax
mono_profiler_shutdown

`mono_profiler_startup`
Syntax
mono_profiler_startup

`mono_profiler_gc_event`
Syntax
mono_profiler_gc_event

`mono_profiler_gc_heap_resize`
Syntax
mono_profiler_gc_heap_resize