wasmi 1.0.9

WebAssembly interpreter
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use super::{Executor, InstructionPtr};
use crate::{
    core::wasm,
    engine::utils::unreachable_unchecked,
    ir::{FixedSlotSpan, Op, Slot},
};

/// Parameters for the `i64.add128` and `i64.sub128` instructions.
struct Params128 {
    /// The register storing the high 64-bit part of the `lhs` parameter value.
    lhs_hi: Slot,
    /// The register storing the low 64-bit part of the `rhs` parameter value.
    rhs_lo: Slot,
    /// The register storing the low 64-bit part of the `rhs` parameter value.
    rhs_hi: Slot,
}

/// Function signature for `i64.binop128` handlers.
type BinOp128Fn = fn(lhs_lo: i64, lhs_hi: i64, rhs_lo: i64, rhs_hi: i64) -> (i64, i64);

/// Function signature for `i64.mul_wide_sx` handlers.
type I64MulWideFn = fn(lhs: i64, rhs: i64) -> (i64, i64);

impl Executor<'_> {
    /// Fetches the parameters required by the `i64.add128` and `i64.sub128` instructions.
    fn fetch_params128(&self) -> Params128 {
        let mut addr: InstructionPtr = self.ip;
        addr.add(1);
        match *addr.get() {
            Op::Slot3 { slots } => Params128 {
                lhs_hi: slots[0],
                rhs_lo: slots[1],
                rhs_hi: slots[2],
            },
            unexpected => {
                // Safety: Wasmi translation guarantees that [`Op::MemoryIndex`] exists.
                unsafe { unreachable_unchecked!("expected `Op::Slot3` but found: {unexpected:?}") }
            }
        }
    }

    /// Executes a generic Wasm `i64.binop128` instruction.
    fn execute_i64_binop128(&mut self, results: [Slot; 2], lhs_lo: Slot, binop: BinOp128Fn) {
        let Params128 {
            lhs_hi,
            rhs_lo,
            rhs_hi,
        } = self.fetch_params128();
        let lhs_lo: i64 = self.get_stack_slot_as(lhs_lo);
        let lhs_hi: i64 = self.get_stack_slot_as(lhs_hi);
        let rhs_lo: i64 = self.get_stack_slot_as(rhs_lo);
        let rhs_hi: i64 = self.get_stack_slot_as(rhs_hi);
        let (result_lo, result_hi) = binop(lhs_lo, lhs_hi, rhs_lo, rhs_hi);
        self.set_stack_slot(results[0], result_lo);
        self.set_stack_slot(results[1], result_hi);
        self.next_instr_at(2)
    }

    /// Executes an [`Op::I64Add128`].
    pub fn execute_i64_add128(&mut self, results: [Slot; 2], lhs_lo: Slot) {
        self.execute_i64_binop128(results, lhs_lo, wasm::i64_add128)
    }

    /// Executes an [`Op::I64Sub128`].
    pub fn execute_i64_sub128(&mut self, results: [Slot; 2], lhs_lo: Slot) {
        self.execute_i64_binop128(results, lhs_lo, wasm::i64_sub128)
    }

    /// Executes a generic Wasm `i64.mul_wide_sx` instruction.
    fn execute_i64_mul_wide_sx(
        &mut self,
        results: FixedSlotSpan<2>,
        lhs: Slot,
        rhs: Slot,
        mul_wide: I64MulWideFn,
    ) {
        let lhs: i64 = self.get_stack_slot_as(lhs);
        let rhs: i64 = self.get_stack_slot_as(rhs);
        let (result_lo, result_hi) = mul_wide(lhs, rhs);
        let results = results.to_array();
        self.set_stack_slot(results[0], result_lo);
        self.set_stack_slot(results[1], result_hi);
        self.next_instr()
    }

    /// Executes an [`Op::I64MulWideS`].
    pub fn execute_i64_mul_wide_s(&mut self, results: FixedSlotSpan<2>, lhs: Slot, rhs: Slot) {
        self.execute_i64_mul_wide_sx(results, lhs, rhs, wasm::i64_mul_wide_s)
    }

    /// Executes an [`Op::I64MulWideU`].
    pub fn execute_i64_mul_wide_u(&mut self, results: FixedSlotSpan<2>, lhs: Slot, rhs: Slot) {
        self.execute_i64_mul_wide_sx(results, lhs, rhs, wasm::i64_mul_wide_u)
    }
}