Struct GlobalJitAlloc

pub struct GlobalJitAlloc;

Available on crate features bundled_jit_alloc or custom_jit_alloc only.

The default, global JIT allocator.

When the bundled_jit_alloc feature is enabled, this is currently implemented as a ZST deffering to a static jit_allocator::JitAllocator behind a std::sync::Mutex (or a spin::Mutex under no_std).

When the custom_jit_alloc feature is enabled, defers to a JitAlloc implementation provided by a downstream crate using the global_jit_alloc macro.

Trait Implementations

impl Clone for GlobalJitAlloc

fn clone(&self) -> GlobalJitAlloc

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for GlobalJitAlloc

fn default() -> GlobalJitAlloc

Returns the “default value” for a type.

impl JitAlloc for GlobalJitAlloc

Available on crate feature bundled_jit_alloc only.

fn alloc(&self, size: usize) -> Result<(*const u8, *mut u8), JitAllocError>

Allocates size bytes in the executable memory region. Returns two pointers. One points to Read-Execute mapping and another to Read-Write mapping. All code writes must go to the Read-Write mapping.

unsafe fn release(&self, rx_ptr: *const u8) -> Result<(), JitAllocError>

Releases the memory allocated by alloc.

unsafe fn flush_instruction_cache(&self, rx_ptr: *const u8, size: usize)

Flushes the instruction cache for (at least) the given slice of executable memory. Should be called after the JIT memory is ready to be executed.

unsafe fn protect_jit_memory( &self, _ptr: *const u8, _size: usize, access: ProtectJitAccess, )

On hardened architectures with MAP_JIT-like memory flags, set the access for the current thread.

impl Copy for GlobalJitAlloc