wasmer-compiler-singlepass 7.0.1

Singlepass compiler for Wasmer WebAssembly 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
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

#[cfg(feature = "unwind")]
use gimli::write::{Address, CallFrameInstruction, CommonInformationEntry, FrameDescriptionEntry};
#[cfg(feature = "unwind")]
use gimli::{AArch64, Encoding, Format, X86_64};
use std::fmt::Debug;
#[cfg(feature = "unwind")]
use wasmer_types::target::Architecture;

use crate::location;

#[derive(Clone, Debug, Copy)]
#[allow(clippy::upper_case_acronyms)]
pub enum UnwindRegister<R: location::Reg, S: location::Reg> {
    GPR(R),
    FPR(S),
}

#[cfg(feature = "unwind")]
impl<R: location::Reg, S: location::Reg> UnwindRegister<R, S> {
    pub(crate) fn dwarf_index(&self) -> gimli::Register {
        match self {
            Self::GPR(reg) => reg.to_dwarf(),
            Self::FPR(reg) => reg.to_dwarf(),
        }
    }
}

#[derive(Clone, Debug)]
#[cfg_attr(not(feature = "unwind"), allow(dead_code))]
pub enum UnwindOps<R: location::Reg, S: location::Reg> {
    PushFP {
        up_to_sp: u32,
    },
    SubtractFP {
        up_to_sp: u32,
    },
    Push2Regs {
        reg1: UnwindRegister<R, S>,
        reg2: UnwindRegister<R, S>,
        up_to_sp: u32,
    },
    DefineNewFrame,
    SaveRegister {
        reg: UnwindRegister<R, S>,
        bp_neg_offset: i32,
    },
}

#[cfg(not(feature = "unwind"))]
pub type CallFrameInstruction = u32;

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct UnwindInstructions {
    pub instructions: Vec<(u32, CallFrameInstruction)>,
    pub len: u32,
}

#[cfg(feature = "unwind")]
pub enum UnwindFrame {
    SystemV(gimli::write::FrameDescriptionEntry),
}

#[cfg(not(feature = "unwind"))]
pub type UnwindFrame = u32;

#[cfg(feature = "unwind")]
impl UnwindInstructions {
    /// Converts the unwind information into a `FrameDescriptionEntry`.
    pub fn to_fde(&self, address: Address) -> UnwindFrame {
        let mut fde = FrameDescriptionEntry::new(address, self.len);
        for (offset, inst) in &self.instructions {
            fde.add_instruction(*offset, inst.clone());
        }
        UnwindFrame::SystemV(fde)
    }
}

/// generate a default systemv  cie
#[cfg(feature = "unwind")]
pub fn create_systemv_cie(arch: Architecture) -> Option<gimli::write::CommonInformationEntry> {
    match arch {
        Architecture::X86_64 => {
            let mut entry = CommonInformationEntry::new(
                Encoding {
                    address_size: 8,
                    format: Format::Dwarf32,
                    version: 1,
                },
                1,
                -8,
                X86_64::RA,
            );
            entry.add_instruction(CallFrameInstruction::Cfa(X86_64::RSP, 8));
            entry.add_instruction(CallFrameInstruction::Offset(X86_64::RA, -8));
            Some(entry)
        }
        Architecture::Aarch64(_) => {
            let mut entry = CommonInformationEntry::new(
                Encoding {
                    address_size: 8,
                    format: Format::Dwarf32,
                    version: 1,
                },
                1,
                -8,
                AArch64::X30,
            );
            entry.add_instruction(CallFrameInstruction::Cfa(AArch64::SP, 0));
            Some(entry)
        }
        Architecture::Riscv64(_) => {
            use gimli::RiscV;

            let mut entry = CommonInformationEntry::new(
                Encoding {
                    address_size: 8,
                    format: Format::Dwarf32,
                    version: 1,
                },
                1,
                -8,
                RiscV::RA,
            );
            entry.add_instruction(CallFrameInstruction::Cfa(RiscV::SP, 0));
            Some(entry)
        }
        _ => None,
    }
}