cranelift::prelude::isa

Trait TargetIsa

pub trait TargetIsa:
    Display
    + Send
    + Sync {
Show 20 methods // Required methods fn name(&self) -> &'static str; fn triple(&self) -> &Triple; fn flags(&self) -> &Flags; fn isa_flags(&self) -> Vec<Value>; fn dynamic_vector_bytes(&self, dynamic_ty: Type) -> u32; fn compile_function( &self, func: &Function, domtree: &DominatorTree, want_disasm: bool, ctrl_plane: &mut ControlPlane, ) -> Result<CompiledCodeBase<Stencil>, CodegenError>; fn emit_unwind_info( &self, result: &CompiledCodeBase<Final>, kind: UnwindInfoKind, ) -> Result<Option<UnwindInfo>, CodegenError>; fn text_section_builder( &self, num_labeled_funcs: usize, ) -> Box<dyn TextSectionBuilder>; fn function_alignment(&self) -> FunctionAlignment; fn page_size_align_log2(&self) -> u8; fn has_native_fma(&self) -> bool; fn has_x86_blendv_lowering(&self, ty: Type) -> bool; fn has_x86_pshufb_lowering(&self) -> bool; fn has_x86_pmulhrsw_lowering(&self) -> bool; fn has_x86_pmaddubsw_lowering(&self) -> bool; // Provided methods fn is_branch_protection_enabled(&self) -> bool { ... } fn map_regalloc_reg_to_dwarf( &self, _: Reg, ) -> Result<u16, RegisterMappingError> { ... } fn create_systemv_cie(&self) -> Option<CommonInformationEntry> { ... } fn wrapped(self) -> Arc<dyn TargetIsa> where Self: Sized + 'static { ... } fn to_capstone(&self) -> Result<Capstone, Error> { ... }
}
Expand description

Methods that are specialized to a target ISA.

Implies a Display trait that shows the shared flags, as well as any ISA-specific flags.

Required Methods§

fn name(&self) -> &'static str

Get the name of this ISA.

fn triple(&self) -> &Triple

Get the target triple that was used to make this trait object.

fn flags(&self) -> &Flags

Get the ISA-independent flags that were used to make this trait object.

fn isa_flags(&self) -> Vec<Value>

Get the ISA-dependent flag values that were used to make this trait object.

fn dynamic_vector_bytes(&self, dynamic_ty: Type) -> u32

Get the ISA-dependent maximum vector register size, in bytes.

fn compile_function( &self, func: &Function, domtree: &DominatorTree, want_disasm: bool, ctrl_plane: &mut ControlPlane, ) -> Result<CompiledCodeBase<Stencil>, CodegenError>

Compile the given function.

fn emit_unwind_info( &self, result: &CompiledCodeBase<Final>, kind: UnwindInfoKind, ) -> Result<Option<UnwindInfo>, CodegenError>

Creates unwind information for the function.

Returns None if there is no unwind information for the function.

fn text_section_builder( &self, num_labeled_funcs: usize, ) -> Box<dyn TextSectionBuilder>

Returns an object that can be used to build the text section of an executable.

This object will internally attempt to handle as many relocations as possible using relative calls/jumps/etc between functions.

The num_labeled_funcs argument here is the number of functions which will be “labeled” or might have calls between them, typically the number of defined functions in the object file.

fn function_alignment(&self) -> FunctionAlignment

Returns the minimum function alignment and the preferred function alignment, for performance, required by this ISA.

fn page_size_align_log2(&self) -> u8

The log2 of the target’s page size and alignment.

Note that this may be an upper-bound that is larger than necessary for some platforms since it may depend on runtime configuration.

fn has_native_fma(&self) -> bool

Returns whether this ISA has a native fused-multiply-and-add instruction for floats.

Currently this only returns false on x86 when some native features are not detected.

fn has_x86_blendv_lowering(&self, ty: Type) -> bool

Returns whether the CLIF x86_blendv instruction is implemented for this ISA for the specified type.

fn has_x86_pshufb_lowering(&self) -> bool

Returns whether the CLIF x86_pshufb instruction is implemented for this ISA.

fn has_x86_pmulhrsw_lowering(&self) -> bool

Returns whether the CLIF x86_pmulhrsw instruction is implemented for this ISA.

fn has_x86_pmaddubsw_lowering(&self) -> bool

Returns whether the CLIF x86_pmaddubsw instruction is implemented for this ISA.

Provided Methods§

fn is_branch_protection_enabled(&self) -> bool

Get a flag indicating whether branch protection is enabled.

fn map_regalloc_reg_to_dwarf(&self, _: Reg) -> Result<u16, RegisterMappingError>

Map a regalloc::Reg to its corresponding DWARF register.

fn create_systemv_cie(&self) -> Option<CommonInformationEntry>

Creates a new System V Common Information Entry for the ISA.

Returns None if the ISA does not support System V unwind information.

fn wrapped(self) -> Arc<dyn TargetIsa>
where Self: Sized + 'static,

Create a polymorphic TargetIsa from this specific implementation.

fn to_capstone(&self) -> Result<Capstone, Error>

Generate a Capstone context for disassembling bytecode for this architecture.

Implementations§

§

impl<'a> dyn TargetIsa + 'a

Methods implemented for free for target ISA!

pub fn default_call_conv(&self) -> CallConv

Get the default calling convention of this target.

pub fn endianness(&self) -> Endianness

Get the endianness of this ISA.

pub fn symbol_alignment(&self) -> u64

Returns the minimum symbol alignment for this ISA.

pub fn pointer_type(&self) -> Type

Get the pointer type of this ISA.

pub fn pointer_bits(&self) -> u8

Get the width of pointers on this ISA, in units of bits.

pub fn pointer_bytes(&self) -> u8

Get the width of pointers on this ISA, in units of bytes.

pub fn frontend_config(&self) -> TargetFrontendConfig

Get the information needed by frontends producing Cranelift IR.

Trait Implementations§

§

impl Debug for &dyn TargetIsa

§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
§

impl<'a> From<&'a dyn TargetIsa> for FlagsOrIsa<'a>

§

fn from(isa: &'a dyn TargetIsa) -> FlagsOrIsa<'a>

Converts to this type from the input type.

Implementors§