Trait wasmer_compiler_llvm::abi::Abi

source · 
pub trait Abi {
    // Required methods
    fn get_vmctx_ptr_param<'ctx>(
        &self,
        func_value: &FunctionValue<'ctx>,
    ) -> PointerValue<'ctx>;
    fn get_g0_ptr_param<'ctx>(
        &self,
        func_value: &FunctionValue<'ctx>,
    ) -> IntValue<'ctx>;
    fn get_m0_ptr_param<'ctx>(
        &self,
        func_value: &FunctionValue<'ctx>,
    ) -> PointerValue<'ctx>;
    fn func_type_to_llvm<'ctx>(
        &self,
        context: &'ctx Context,
        intrinsics: &Intrinsics<'ctx>,
        offsets: Option<&VMOffsets>,
        sig: &FuncSig,
        function_kind: Option<G0M0FunctionKind>,
    ) -> Result<(FunctionType<'ctx>, Vec<(Attribute, AttributeLoc)>), CompileError>;
    fn args_to_call<'ctx>(
        &self,
        alloca_builder: &Builder<'ctx>,
        func_sig: &FuncSig,
        llvm_fn_ty: &FunctionType<'ctx>,
        ctx_ptr: PointerValue<'ctx>,
        values: &[BasicValueEnum<'ctx>],
        intrinsics: &Intrinsics<'ctx>,
        g0m0: Option<(IntValue<'ctx>, PointerValue<'ctx>)>,
    ) -> Result<Vec<BasicValueEnum<'ctx>>, CompileError>;
    fn rets_from_call<'ctx>(
        &self,
        builder: &Builder<'ctx>,
        intrinsics: &Intrinsics<'ctx>,
        call_site: CallSiteValue<'ctx>,
        func_sig: &FuncSig,
    ) -> Result<Vec<BasicValueEnum<'ctx>>, CompileError>;
    fn is_sret(&self, func_sig: &FuncSig) -> Result<bool, CompileError>;
    fn pack_values_for_register_return<'ctx>(
        &self,
        intrinsics: &Intrinsics<'ctx>,
        builder: &Builder<'ctx>,
        values: &[BasicValueEnum<'ctx>],
        func_type: &FunctionType<'ctx>,
    ) -> Result<BasicValueEnum<'ctx>, CompileError>;
}
Expand description

We need to produce different LLVM IR for different platforms. (Contrary to popular knowledge LLVM IR is not intended to be portable in that way.) This trait deals with differences between function signatures on different targets.

Required Methods§

source

fn get_vmctx_ptr_param<'ctx>( &self, func_value: &FunctionValue<'ctx>, ) -> PointerValue<'ctx>

Given a function definition, retrieve the parameter that is the vmctx pointer.

source

fn get_g0_ptr_param<'ctx>( &self, func_value: &FunctionValue<'ctx>, ) -> IntValue<'ctx>

Given a function definition, retrieve the parameter that is the pointer to the first – number 0 – local global.

source

fn get_m0_ptr_param<'ctx>( &self, func_value: &FunctionValue<'ctx>, ) -> PointerValue<'ctx>

Given a function definition, retrieve the parameter that is the pointer to the first – number 0 – local memory.

§Notes

This function assumes that g0m0 is enabled.

source

fn func_type_to_llvm<'ctx>( &self, context: &'ctx Context, intrinsics: &Intrinsics<'ctx>, offsets: Option<&VMOffsets>, sig: &FuncSig, function_kind: Option<G0M0FunctionKind>, ) -> Result<(FunctionType<'ctx>, Vec<(Attribute, AttributeLoc)>), CompileError>

Given a wasm function type, produce an llvm function declaration.

§Notes

This function assumes that g0m0 is enabled.

source

fn args_to_call<'ctx>( &self, alloca_builder: &Builder<'ctx>, func_sig: &FuncSig, llvm_fn_ty: &FunctionType<'ctx>, ctx_ptr: PointerValue<'ctx>, values: &[BasicValueEnum<'ctx>], intrinsics: &Intrinsics<'ctx>, g0m0: Option<(IntValue<'ctx>, PointerValue<'ctx>)>, ) -> Result<Vec<BasicValueEnum<'ctx>>, CompileError>

Marshall wasm stack values into function parameters.

source

fn rets_from_call<'ctx>( &self, builder: &Builder<'ctx>, intrinsics: &Intrinsics<'ctx>, call_site: CallSiteValue<'ctx>, func_sig: &FuncSig, ) -> Result<Vec<BasicValueEnum<'ctx>>, CompileError>

Given a CallSite, extract the returned values and return them in a Vec.

source

fn is_sret(&self, func_sig: &FuncSig) -> Result<bool, CompileError>

Whether the llvm equivalent of this wasm function has an sret attribute.

source

fn pack_values_for_register_return<'ctx>( &self, intrinsics: &Intrinsics<'ctx>, builder: &Builder<'ctx>, values: &[BasicValueEnum<'ctx>], func_type: &FunctionType<'ctx>, ) -> Result<BasicValueEnum<'ctx>, CompileError>

Pack LLVM IR values representing individual wasm values into the return type for the function.

Implementors§