wasmtime 44.0.0

High-level API to expose the Wasmtime runtime
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
51
52
53
54
55

#![doc(hidden)]

use crate::runtime::vm::{Instance, VMContext};
use core::ptr::NonNull;
use wasmtime_environ::{EntityRef, MemoryIndex};
use wasmtime_versioned_export_macros::versioned_export;

static mut VMCTX_AND_MEMORY: (NonNull<VMContext>, usize) = (NonNull::dangling(), 0);

// These implementations are referenced from C code in "helpers.c". The symbols defined
// there (prefixed by "wasmtime_") are the real 'public' interface used in the debug info.

#[versioned_export]
pub unsafe extern "C" fn resolve_vmctx_memory_ptr(p: *const u32) -> *const u8 {
    unsafe {
        let ptr = core::ptr::read(p);
        assert!(
            VMCTX_AND_MEMORY.0 != NonNull::dangling(),
            "must call `__vmctx->set()` before resolving Wasm pointers"
        );
        Instance::enter_host_from_wasm(VMCTX_AND_MEMORY.0, |store, instance| {
            let handle = store.instance_mut(instance);
            assert!(
                VMCTX_AND_MEMORY.1 < handle.env_module().memories.len(),
                "memory index for debugger is out of bounds"
            );
            let index = MemoryIndex::new(VMCTX_AND_MEMORY.1);
            let mem = handle.get_memory(index);
            mem.base.as_ptr().add(ptr as usize)
        })
    }
}

#[versioned_export]
pub unsafe extern "C" fn set_vmctx_memory(vmctx_ptr: *mut VMContext) {
    unsafe {
        // TODO multi-memory
        VMCTX_AND_MEMORY = (NonNull::new(vmctx_ptr).unwrap(), 0);
    }
}

/// A bit of a hack around various linkage things. The goal here is to force the
/// `wasmtime_*` symbols defined in `helpers.c` to actually get exported. That
/// means they need to be referenced for the linker to include them which is
/// what this function does with trickery in C.
pub fn init() {
    unsafe extern "C" {
        #[wasmtime_versioned_export_macros::versioned_link]
        fn wasmtime_debug_builtins_init();
    }

    unsafe {
        wasmtime_debug_builtins_init();
    }
}