wasmtime 15.0.1 → 16.0.0

data/ext/cargo-vendor/wasmtime-environ-15.0.1/Cargo.toml

@@ -1,116 +0,0 @@
-# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
-#
-# When uploading crates to the registry Cargo will automatically
-# "normalize" Cargo.toml files for maximal compatibility
-# with all versions of Cargo and also rewrite `path` dependencies
-# to registry (e.g., crates.io) dependencies.
-#
-# If you are reading this file be aware that the original Cargo.toml
-# will likely look very different (and much more reasonable).
-# See Cargo.toml.orig for the original contents.
-
-[package]
-edition = "2021"
-name = "wasmtime-environ"
-version = "15.0.1"
-authors = ["The Wasmtime Project Developers"]
-description = "Standalone environment support for WebAsssembly code in Cranelift"
-documentation = "https://docs.rs/wasmtime-environ/"
-keywords = [
-    "webassembly",
-    "wasm",
-]
-categories = ["wasm"]
-license = "Apache-2.0 WITH LLVM-exception"
-repository = "https://github.com/bytecodealliance/wasmtime"
-
-[[example]]
-name = "factc"
-required-features = ["component-model"]
-
-[dependencies.anyhow]
-version = "1.0.22"
-
-[dependencies.cranelift-entity]
-version = "0.102.1"
-
-[dependencies.gimli]
-version = "0.28.0"
-features = [
-    "read",
-    "std",
-    "write",
-]
-default-features = false
-
-[dependencies.indexmap]
-version = "2.0.0"
-features = ["serde"]
-
-[dependencies.log]
-version = "0.4.8"
-default-features = false
-
-[dependencies.object]
-version = "0.32"
-features = [
-    "read_core",
-    "elf",
-    "std",
-    "write_core",
-]
-default-features = false
-
-[dependencies.serde]
-version = "1.0.188"
-
-[dependencies.serde_derive]
-version = "1.0.188"
-
-[dependencies.target-lexicon]
-version = "0.12.12"
-features = ["std"]
-default-features = false
-
-[dependencies.thiserror]
-version = "1.0.43"
-
-[dependencies.wasm-encoder]
-version = "0.36.2"
-optional = true
-
-[dependencies.wasmparser]
-version = "0.116.0"
-
-[dependencies.wasmprinter]
-version = "0.2.72"
-optional = true
-
-[dependencies.wasmtime-component-util]
-version = "=15.0.1"
-optional = true
-
-[dependencies.wasmtime-types]
-version = "15.0.1"
-
-[dev-dependencies.clap]
-version = "4.3.12"
-features = [
-    "std",
-    "derive",
-    "default",
-]
-default-features = false
-
-[dev-dependencies.env_logger]
-version = "0.10"
-
-[dev-dependencies.wat]
-version = "1.0.79"
-
-[features]
-component-model = [
-    "dep:wasm-encoder",
-    "dep:wasmprinter",
-    "dep:wasmtime-component-util",
-]

data/ext/cargo-vendor/wasmtime-environ-15.0.1/src/compilation.rs

@@ -1,402 +0,0 @@
-//! A `Compilation` contains the compiled function bodies for a WebAssembly
-//! module.
-
-use crate::{obj, Tunables};
-use crate::{
-    DefinedFuncIndex, FilePos, FuncIndex, FunctionBodyData, ModuleTranslation, ModuleTypes,
-    PrimaryMap, StackMap, WasmError, WasmFuncType,
-};
-use anyhow::Result;
-use object::write::{Object, SymbolId};
-use object::{Architecture, BinaryFormat, FileFlags};
-use serde_derive::{Deserialize, Serialize};
-use std::any::Any;
-use std::borrow::Cow;
-use std::fmt;
-use std::path;
-use std::sync::Arc;
-use thiserror::Error;
-
-/// Information about a function, such as trap information, address map,
-/// and stack maps.
-#[derive(Serialize, Deserialize, Default)]
-#[allow(missing_docs)]
-pub struct WasmFunctionInfo {
-    pub start_srcloc: FilePos,
-    pub stack_maps: Box<[StackMapInformation]>,
-}
-
-/// Description of where a function is located in the text section of a
-/// compiled image.
-#[derive(Copy, Clone, Serialize, Deserialize)]
-pub struct FunctionLoc {
-    /// The byte offset from the start of the text section where this
-    /// function starts.
-    pub start: u32,
-    /// The byte length of this function's function body.
-    pub length: u32,
-}
-
-/// The offset within a function of a GC safepoint, and its associated stack
-/// map.
-#[derive(Serialize, Deserialize, Debug)]
-pub struct StackMapInformation {
-    /// The offset of the GC safepoint within the function's native code. It is
-    /// relative to the beginning of the function.
-    pub code_offset: u32,
-
-    /// The stack map for identifying live GC refs at the GC safepoint.
-    pub stack_map: StackMap,
-}
-
-/// An error while compiling WebAssembly to machine code.
-#[derive(Error, Debug)]
-pub enum CompileError {
-    /// A wasm translation error occured.
-    #[error("WebAssembly translation error")]
-    Wasm(#[from] WasmError),
-
-    /// A compilation error occured.
-    #[error("Compilation error: {0}")]
-    Codegen(String),
-
-    /// A compilation error occured.
-    #[error("Debug info is not supported with this configuration")]
-    DebugInfoNotSupported,
-}
-
-/// Implementation of an incremental compilation's key/value cache store.
-///
-/// In theory, this could just be Cranelift's `CacheKvStore` trait, but it is not as we want to
-/// make sure that wasmtime isn't too tied to Cranelift internals (and as a matter of fact, we
-/// can't depend on the Cranelift trait here).
-pub trait CacheStore: Send + Sync + std::fmt::Debug {
-    /// Try to retrieve an arbitrary cache key entry, and returns a reference to bytes that were
-    /// inserted via `Self::insert` before.
-    fn get(&self, key: &[u8]) -> Option<Cow<[u8]>>;
-
-    /// Given an arbitrary key and bytes, stores them in the cache.
-    ///
-    /// Returns false when insertion in the cache failed.
-    fn insert(&self, key: &[u8], value: Vec<u8>) -> bool;
-}
-
-/// Abstract trait representing the ability to create a `Compiler` below.
-///
-/// This is used in Wasmtime to separate compiler implementations, currently
-/// mostly used to separate Cranelift from Wasmtime itself.
-pub trait CompilerBuilder: Send + Sync + fmt::Debug {
-    /// Sets the target of compilation to the target specified.
-    fn target(&mut self, target: target_lexicon::Triple) -> Result<()>;
-
-    /// Enables clif output in the directory specified.
-    fn clif_dir(&mut self, _path: &path::Path) -> Result<()> {
-        anyhow::bail!("clif output not supported");
-    }
-
-    /// Returns the currently configured target triple that compilation will
-    /// produce artifacts for.
-    fn triple(&self) -> &target_lexicon::Triple;
-
-    /// Compiler-specific method to configure various settings in the compiler
-    /// itself.
-    ///
-    /// This is expected to be defined per-compiler. Compilers should return
-    /// errors for unknown names/values.
-    fn set(&mut self, name: &str, val: &str) -> Result<()>;
-
-    /// Compiler-specific method for configuring settings.
-    ///
-    /// Same as [`CompilerBuilder::set`] except for enabling boolean flags.
-    /// Currently cranelift uses this to sometimes enable a family of settings.
-    fn enable(&mut self, name: &str) -> Result<()>;
-
-    /// Returns a list of all possible settings that can be configured with
-    /// [`CompilerBuilder::set`] and [`CompilerBuilder::enable`].
-    fn settings(&self) -> Vec<Setting>;
-
-    /// Enables Cranelift's incremental compilation cache, using the given `CacheStore`
-    /// implementation.
-    ///
-    /// This will return an error if the compiler does not support incremental compilation.
-    fn enable_incremental_compilation(&mut self, cache_store: Arc<dyn CacheStore>) -> Result<()>;
-
-    /// Set the tunables for this compiler.
-    fn set_tunables(&mut self, tunables: Tunables) -> Result<()>;
-
-    /// Builds a new [`Compiler`] object from this configuration.
-    fn build(&self) -> Result<Box<dyn Compiler>>;
-
-    /// Enables or disables wmemcheck during runtime according to the wmemcheck CLI flag.
-    fn wmemcheck(&mut self, _enable: bool) {}
-}
-
-/// Description of compiler settings returned by [`CompilerBuilder::settings`].
-#[derive(Clone, Copy, Debug)]
-pub struct Setting {
-    /// The name of the setting.
-    pub name: &'static str,
-    /// The description of the setting.
-    pub description: &'static str,
-    /// The kind of the setting.
-    pub kind: SettingKind,
-    /// The supported values of the setting (for enum values).
-    pub values: Option<&'static [&'static str]>,
-}
-
-/// Different kinds of [`Setting`] values that can be configured in a
-/// [`CompilerBuilder`]
-#[derive(Clone, Copy, Debug)]
-pub enum SettingKind {
-    /// The setting is an enumeration, meaning it's one of a set of values.
-    Enum,
-    /// The setting is a number.
-    Num,
-    /// The setting is a boolean.
-    Bool,
-    /// The setting is a preset.
-    Preset,
-}
-
-/// Types of objects that can be created by `Compiler::object`
-pub enum ObjectKind {
-    /// A core wasm compilation artifact
-    Module,
-    /// A component compilation artifact
-    Component,
-}
-
-/// An implementation of a compiler which can compile WebAssembly functions to
-/// machine code and perform other miscellaneous tasks needed by the JIT runtime.
-pub trait Compiler: Send + Sync {
-    /// Compiles the function `index` within `translation`.
-    ///
-    /// The body of the function is available in `data` and configuration
-    /// values are also passed in via `tunables`. Type information in
-    /// `translation` is all relative to `types`.
-    fn compile_function(
-        &self,
-        translation: &ModuleTranslation<'_>,
-        index: DefinedFuncIndex,
-        data: FunctionBodyData<'_>,
-        types: &ModuleTypes,
-    ) -> Result<(WasmFunctionInfo, Box<dyn Any + Send>), CompileError>;
-
-    /// Compile a trampoline for an array-call host function caller calling the
-    /// `index`th Wasm function.
-    ///
-    /// The trampoline should save the necessary state to record the
-    /// host-to-Wasm transition (e.g. registers used for fast stack walking).
-    fn compile_array_to_wasm_trampoline(
-        &self,
-        translation: &ModuleTranslation<'_>,
-        types: &ModuleTypes,
-        index: DefinedFuncIndex,
-    ) -> Result<Box<dyn Any + Send>, CompileError>;
-
-    /// Compile a trampoline for a native-call host function caller calling the
-    /// `index`th Wasm function.
-    ///
-    /// The trampoline should save the necessary state to record the
-    /// host-to-Wasm transition (e.g. registers used for fast stack walking).
-    fn compile_native_to_wasm_trampoline(
-        &self,
-        translation: &ModuleTranslation<'_>,
-        types: &ModuleTypes,
-        index: DefinedFuncIndex,
-    ) -> Result<Box<dyn Any + Send>, CompileError>;
-
-    /// Compile a trampoline for a Wasm caller calling a native callee with the
-    /// given signature.
-    ///
-    /// The trampoline should save the necessary state to record the
-    /// Wasm-to-host transition (e.g. registers used for fast stack walking).
-    fn compile_wasm_to_native_trampoline(
-        &self,
-        wasm_func_ty: &WasmFuncType,
-    ) -> Result<Box<dyn Any + Send>, CompileError>;
-
-    /// Appends a list of compiled functions to an in-memory object.
-    ///
-    /// This function will receive the same `Box<dyn Any>` produced as part of
-    /// compilation from functions like `compile_function`,
-    /// `compile_host_to_wasm_trampoline`, and other component-related shims.
-    /// Internally this will take all of these functions and add information to
-    /// the object such as:
-    ///
-    /// * Compiled code in a `.text` section
-    /// * Unwind information in Wasmtime-specific sections
-    /// * Relocations, if necessary, for the text section
-    ///
-    /// Each function is accompanied with its desired symbol name and the return
-    /// value of this function is the symbol for each function as well as where
-    /// each function was placed within the object.
-    ///
-    /// The `resolve_reloc` argument is intended to resolving relocations
-    /// between function, chiefly resolving intra-module calls within one core
-    /// wasm module. The closure here takes two arguments:
-    ///
-    /// 1. First, the index within `funcs` that is being resolved,
-    ///
-    /// 2. and next the `FuncIndex` which is the relocation target to
-    /// resolve.
-    ///
-    /// The return value is an index within `funcs` that the relocation points
-    /// to.
-    fn append_code(
-        &self,
-        obj: &mut Object<'static>,
-        funcs: &[(String, Box<dyn Any + Send>)],
-        resolve_reloc: &dyn Fn(usize, FuncIndex) -> usize,
-    ) -> Result<Vec<(SymbolId, FunctionLoc)>>;
-
-    /// Inserts two trampolines into `obj` for a array-call host function:
-    ///
-    /// 1. A wasm-call trampoline: A trampoline that takes arguments in their
-    ///    wasm-call locations, moves them to their array-call locations, calls
-    ///    the array-call host function, and finally moves the return values
-    ///    from the array-call locations to the wasm-call return
-    ///    locations. Additionally, this trampoline manages the wasm-to-host
-    ///    state transition for the runtime.
-    ///
-    /// 2. A native-call trampoline: A trampoline that takes arguments in their
-    ///    native-call locations, moves them to their array-call locations,
-    ///    calls the array-call host function, and finally moves the return
-    ///    values from the array-call locations to the native-call return
-    ///    locations. Does not need to manage any wasm/host state transitions,
-    ///    since both caller and callee are on the host side.
-    ///
-    /// This will configure the same sections as `append_code`, but will likely
-    /// be much smaller.
-    ///
-    /// The two returned `FunctionLoc` structures describe where to find these
-    /// trampolines in the text section, respectively.
-    ///
-    /// These trampolines are only valid for in-process JIT usage. They bake in
-    /// the function pointer to the host code.
-    fn emit_trampolines_for_array_call_host_func(
-        &self,
-        ty: &WasmFuncType,
-        // Actually `host_fn: VMArrayCallFunction` but that type is not
-        // available in `wasmtime-environ`.
-        host_fn: usize,
-        obj: &mut Object<'static>,
-    ) -> Result<(FunctionLoc, FunctionLoc)>;
-
-    /// Creates a new `Object` file which is used to build the results of a
-    /// compilation into.
-    ///
-    /// The returned object file will have an appropriate
-    /// architecture/endianness for `self.triple()`, but at this time it is
-    /// always an ELF file, regardless of target platform.
-    fn object(&self, kind: ObjectKind) -> Result<Object<'static>> {
-        use target_lexicon::Architecture::*;
-
-        let triple = self.triple();
-        let mut obj = Object::new(
-            BinaryFormat::Elf,
-            match triple.architecture {
-                X86_32(_) => Architecture::I386,
-                X86_64 => Architecture::X86_64,
-                Arm(_) => Architecture::Arm,
-                Aarch64(_) => Architecture::Aarch64,
-                S390x => Architecture::S390x,
-                Riscv64(_) => Architecture::Riscv64,
-                architecture => {
-                    anyhow::bail!("target architecture {:?} is unsupported", architecture,);
-                }
-            },
-            match triple.endianness().unwrap() {
-                target_lexicon::Endianness::Little => object::Endianness::Little,
-                target_lexicon::Endianness::Big => object::Endianness::Big,
-            },
-        );
-        obj.flags = FileFlags::Elf {
-            os_abi: obj::ELFOSABI_WASMTIME,
-            e_flags: match kind {
-                ObjectKind::Module => obj::EF_WASMTIME_MODULE,
-                ObjectKind::Component => obj::EF_WASMTIME_COMPONENT,
-            },
-            abi_version: 0,
-        };
-        Ok(obj)
-    }
-
-    /// Returns the target triple that this compiler is compiling for.
-    fn triple(&self) -> &target_lexicon::Triple;
-
-    /// Returns the alignment necessary to align values to the page size of the
-    /// compilation target. Note that this may be an upper-bound where the
-    /// alignment is larger than necessary for some platforms since it may
-    /// depend on the platform's runtime configuration.
-    fn page_size_align(&self) -> u64 {
-        use target_lexicon::*;
-        match (self.triple().operating_system, self.triple().architecture) {
-            (
-                OperatingSystem::MacOSX { .. }
-                | OperatingSystem::Darwin
-                | OperatingSystem::Ios
-                | OperatingSystem::Tvos,
-                Architecture::Aarch64(..),
-            ) => 0x4000,
-            // 64 KB is the maximal page size (i.e. memory translation granule size)
-            // supported by the architecture and is used on some platforms.
-            (_, Architecture::Aarch64(..)) => 0x10000,
-            _ => 0x1000,
-        }
-    }
-
-    /// Returns a list of configured settings for this compiler.
-    fn flags(&self) -> Vec<(&'static str, FlagValue<'static>)>;
-
-    /// Same as [`Compiler::flags`], but ISA-specific (a cranelift-ism)
-    fn isa_flags(&self) -> Vec<(&'static str, FlagValue<'static>)>;
-
-    /// Get a flag indicating whether branch protection is enabled.
-    fn is_branch_protection_enabled(&self) -> bool;
-
-    /// Returns a suitable compiler usable for component-related compliations.
-    ///
-    /// Note that the `ComponentCompiler` trait can also be implemented for
-    /// `Self` in which case this function would simply return `self`.
-    #[cfg(feature = "component-model")]
-    fn component_compiler(&self) -> &dyn crate::component::ComponentCompiler;
-
-    /// Appends generated DWARF sections to the `obj` specified for the compiled
-    /// functions.
-    fn append_dwarf(
-        &self,
-        obj: &mut Object<'_>,
-        translation: &ModuleTranslation<'_>,
-        funcs: &PrimaryMap<DefinedFuncIndex, (SymbolId, &(dyn Any + Send))>,
-    ) -> Result<()>;
-
-    /// Creates a new System V Common Information Entry for the ISA.
-    ///
-    /// Returns `None` if the ISA does not support System V unwind information.
-    fn create_systemv_cie(&self) -> Option<gimli::write::CommonInformationEntry> {
-        // By default, an ISA cannot create a System V CIE.
-        None
-    }
-}
-
-/// Value of a configured setting for a [`Compiler`]
-#[derive(Serialize, Deserialize, Hash, Eq, PartialEq, Debug)]
-pub enum FlagValue<'a> {
-    /// Name of the value that has been configured for this setting.
-    Enum(&'a str),
-    /// The numerical value of the configured settings.
-    Num(u8),
-    /// Whether the setting is on or off.
-    Bool(bool),
-}
-
-impl fmt::Display for FlagValue<'_> {
-    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
-        match self {
-            Self::Enum(v) => v.fmt(f),
-            Self::Num(v) => v.fmt(f),
-            Self::Bool(v) => v.fmt(f),
-        }
-    }
-}

data/ext/cargo-vendor/wasmtime-environ-15.0.1/src/component/compiler.rs

@@ -1,47 +0,0 @@
-use crate::component::{ComponentTranslation, ComponentTypes, TrampolineIndex};
-use anyhow::Result;
-use serde_derive::{Deserialize, Serialize};
-use std::any::Any;
-
-/// A triple of related functions/trampolines variants with differing calling
-/// conventions: `{wasm,array,native}_call`.
-///
-/// Generic so we can use this with either the `Box<dyn Any + Send>`s that
-/// implementations of the compiler trait return or with `FunctionLoc`s inside
-/// an object file, for example.
-#[derive(Clone, Copy, Default, Serialize, Deserialize)]
-pub struct AllCallFunc<T> {
-    /// The function exposing the Wasm calling convention.
-    pub wasm_call: T,
-    /// The function exposing the array calling convention.
-    pub array_call: T,
-    /// The function exposing the native calling convention.
-    pub native_call: T,
-}
-
-impl<T> AllCallFunc<T> {
-    /// Map an `AllCallFunc<T>` into an `AllCallFunc<U>`.
-    pub fn map<U>(self, mut f: impl FnMut(T) -> U) -> AllCallFunc<U> {
-        AllCallFunc {
-            wasm_call: f(self.wasm_call),
-            array_call: f(self.array_call),
-            native_call: f(self.native_call),
-        }
-    }
-}
-
-/// Compilation support necessary for components.
-pub trait ComponentCompiler: Send + Sync {
-    /// Compiles the pieces necessary to create a `VMFuncRef` for the
-    /// `trampoline` specified.
-    ///
-    /// Each trampoline is a member of the `Trampoline` enumeration and has a
-    /// unique purpose and is translated differently. See the implementation of
-    /// this trait for Cranelift for more information.
-    fn compile_trampoline(
-        &self,
-        component: &ComponentTranslation,
-        types: &ComponentTypes,
-        trampoline: TrampolineIndex,
-    ) -> Result<AllCallFunc<Box<dyn Any + Send>>>;
-}