macroassembler 1.0.5

A library for writing portable x86-64/riscv64/aarch64 assembly code in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

//! Direct port of `JavaScriptCore/jit` module.

use jit_allocator::{JitAllocator, JitAllocatorOptions};
use once_cell::sync::OnceCell;
use parking_lot::Mutex;

pub mod fpr_info;
pub mod gpr_info;
pub mod helpers;

pub static EXECUTABLE_ALLOCATOR: OnceCell<Mutex<Box<JitAllocator>>> = OnceCell::new();
pub fn init_executable_allocator_with(opts: JitAllocatorOptions) {
    EXECUTABLE_ALLOCATOR.get_or_init(|| Mutex::new(JitAllocator::new(opts)));
}

pub fn init_executable_allocator() {
    init_executable_allocator_with(JitAllocatorOptions {
        use_dual_mapping: true,
        use_multiple_pools: true,
        fill_unused_memory: true,
        immediate_release: false,
        ..Default::default()
    });
}

pub fn allocate_executable_memory(
    size: usize,
) -> Result<(*const u8, *mut u8), jit_allocator::Error> {
    EXECUTABLE_ALLOCATOR
        .get_or_init(|| Mutex::new(JitAllocator::new(JitAllocatorOptions::default())))
        .lock()
        .alloc(size)
}

/// Free executable memory allocated by `allocate_executable_memory`.
///
/// # Safety
///
/// - `rx` must be pointer to read-execute memory allocated by `allocate_executable_memory`.
/// - `rx` must not be null.
/// - `rx` must not be double freed.
pub unsafe fn free_executable_memory(rx: *const u8) -> Result<(), jit_allocator::Error> {
    {
        EXECUTABLE_ALLOCATOR
            .get()
            .expect("Executable Allocator must be initialized before freeing")
            .lock()
            .release(rx)
    }
}