As part of a Wasm JIT update, SpiderMonkey is changing its internal WebAssembly function ABI. The new ABI's frame format includes "caller TLS" and "callee TLS" slots. The details of where these come from are not important; from Cranelift's point of view, the only relevant requirement is that we have two on-stack args that are always present (offsetting other on-stack args), and that we define special argument purposes so that we can supply values for these slots. Note that this adds a *new* ABI (a variant of the Baldrdash ABI) because we do not want to tightly couple the landing of this PR to the landing of the changes in SpiderMonkey; it's better if both the old and new behavior remain available in Cranelift, so SpiderMonkey can continue to vendor Cranelift even if it does not land (or backs out) the ABI change. Furthermore, note that this needs to be a Cranelift-level change (i.e. cannot be done purely from the translator environment implementation) because the special TLS arguments must always go on the stack, which would not otherwise happen with the usual argument-placement logic; and there is no primitive to push a value directly in CLIF code (the notion of a stack frame is a lower-level concept).
107 lines
3.9 KiB
Rust
107 lines
3.9 KiB
Rust
use crate::settings::{self, LibcallCallConv};
|
|
use core::fmt;
|
|
use core::str;
|
|
use target_lexicon::{CallingConvention, Triple};
|
|
|
|
#[cfg(feature = "enable-serde")]
|
|
use serde::{Deserialize, Serialize};
|
|
|
|
/// Calling convention identifiers.
|
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "enable-serde", derive(Serialize, Deserialize))]
|
|
pub enum CallConv {
|
|
/// Best performance, not ABI-stable
|
|
Fast,
|
|
/// Smallest caller code size, not ABI-stable
|
|
Cold,
|
|
/// System V-style convention used on many platforms
|
|
SystemV,
|
|
/// Windows "fastcall" convention, also used for x64 and ARM
|
|
WindowsFastcall,
|
|
/// SpiderMonkey WebAssembly convention on systems using natively SystemV
|
|
BaldrdashSystemV,
|
|
/// SpiderMonkey WebAssembly convention on Windows
|
|
BaldrdashWindows,
|
|
/// SpiderMonkey WebAssembly convention for "ABI-2020", with extra TLS
|
|
/// register slots in the frame.
|
|
Baldrdash2020,
|
|
/// Specialized convention for the probestack function
|
|
Probestack,
|
|
}
|
|
|
|
impl CallConv {
|
|
/// Return the default calling convention for the given target triple.
|
|
pub fn triple_default(triple: &Triple) -> Self {
|
|
match triple.default_calling_convention() {
|
|
// Default to System V for unknown targets because most everything
|
|
// uses System V.
|
|
Ok(CallingConvention::SystemV) | Err(()) => Self::SystemV,
|
|
Ok(CallingConvention::WindowsFastcall) => Self::WindowsFastcall,
|
|
Ok(unimp) => unimplemented!("calling convention: {:?}", unimp),
|
|
}
|
|
}
|
|
|
|
/// Returns the calling convention used for libcalls according to the current flags.
|
|
pub fn for_libcall(flags: &settings::Flags, default_call_conv: CallConv) -> Self {
|
|
match flags.libcall_call_conv() {
|
|
LibcallCallConv::IsaDefault => default_call_conv,
|
|
LibcallCallConv::Fast => Self::Fast,
|
|
LibcallCallConv::Cold => Self::Cold,
|
|
LibcallCallConv::SystemV => Self::SystemV,
|
|
LibcallCallConv::WindowsFastcall => Self::WindowsFastcall,
|
|
LibcallCallConv::BaldrdashSystemV => Self::BaldrdashSystemV,
|
|
LibcallCallConv::BaldrdashWindows => Self::BaldrdashWindows,
|
|
LibcallCallConv::Baldrdash2020 => Self::Baldrdash2020,
|
|
LibcallCallConv::Probestack => Self::Probestack,
|
|
}
|
|
}
|
|
|
|
/// Is the calling convention extending the Windows Fastcall ABI?
|
|
pub fn extends_windows_fastcall(self) -> bool {
|
|
match self {
|
|
Self::WindowsFastcall | Self::BaldrdashWindows => true,
|
|
_ => false,
|
|
}
|
|
}
|
|
|
|
/// Is the calling convention extending the Baldrdash ABI?
|
|
pub fn extends_baldrdash(self) -> bool {
|
|
match self {
|
|
Self::BaldrdashSystemV | Self::BaldrdashWindows | Self::Baldrdash2020 => true,
|
|
_ => false,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl fmt::Display for CallConv {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.write_str(match *self {
|
|
Self::Fast => "fast",
|
|
Self::Cold => "cold",
|
|
Self::SystemV => "system_v",
|
|
Self::WindowsFastcall => "windows_fastcall",
|
|
Self::BaldrdashSystemV => "baldrdash_system_v",
|
|
Self::BaldrdashWindows => "baldrdash_windows",
|
|
Self::Baldrdash2020 => "baldrdash_2020",
|
|
Self::Probestack => "probestack",
|
|
})
|
|
}
|
|
}
|
|
|
|
impl str::FromStr for CallConv {
|
|
type Err = ();
|
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
|
match s {
|
|
"fast" => Ok(Self::Fast),
|
|
"cold" => Ok(Self::Cold),
|
|
"system_v" => Ok(Self::SystemV),
|
|
"windows_fastcall" => Ok(Self::WindowsFastcall),
|
|
"baldrdash_system_v" => Ok(Self::BaldrdashSystemV),
|
|
"baldrdash_windows" => Ok(Self::BaldrdashWindows),
|
|
"baldrdash_2020" => Ok(Self::Baldrdash2020),
|
|
"probestack" => Ok(Self::Probestack),
|
|
_ => Err(()),
|
|
}
|
|
}
|
|
}
|