cranelift_codegen::isa

Trait TargetIsa

Source
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, ) -> CodegenResult<CompiledCodeBase<Stencil>>; fn emit_unwind_info( &self, result: &CompiledCode, kind: UnwindInfoKind, ) -> CodegenResult<Option<UnwindInfo>>; 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) -> OwnedTargetIsa 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§

Source

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

Get the name of this ISA.

Source

fn triple(&self) -> &Triple

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

Source

fn flags(&self) -> &Flags

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

Source

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

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

Source

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

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

Source

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

Compile the given function.

Source

fn emit_unwind_info( &self, result: &CompiledCode, kind: UnwindInfoKind, ) -> CodegenResult<Option<UnwindInfo>>

Available on crate feature unwind only.

Creates unwind information for the function.

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

Source

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.

Source

fn function_alignment(&self) -> FunctionAlignment

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

Source

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.

Source

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.

Source

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.

Source

fn has_x86_pshufb_lowering(&self) -> bool

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

Source

fn has_x86_pmulhrsw_lowering(&self) -> bool

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

Source

fn has_x86_pmaddubsw_lowering(&self) -> bool

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

Provided Methods§

Source

fn is_branch_protection_enabled(&self) -> bool

Get a flag indicating whether branch protection is enabled.

Source

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

Available on crate feature unwind only.

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

Source

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

Available on crate feature unwind only.

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

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

Source

fn wrapped(self) -> OwnedTargetIsa
where Self: Sized + 'static,

Create a polymorphic TargetIsa from this specific implementation.

Source

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

Available on crate feature disas only.

Generate a Capstone context for disassembling bytecode for this architecture.

Implementations§

Source§

impl<'a> dyn TargetIsa + 'a

Methods implemented for free for target ISA!

Source

pub fn default_call_conv(&self) -> CallConv

Get the default calling convention of this target.

Source

pub fn endianness(&self) -> Endianness

Get the endianness of this ISA.

Source

pub fn symbol_alignment(&self) -> u64

Returns the minimum symbol alignment for this ISA.

Source

pub fn pointer_type(&self) -> Type

Get the pointer type of this ISA.

Source

pub fn pointer_bits(&self) -> u8

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

Source

pub fn pointer_bytes(&self) -> u8

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

Source

pub fn frontend_config(&self) -> TargetFrontendConfig

Get the information needed by frontends producing Cranelift IR.

Trait Implementations§

Source§

impl Debug for &dyn TargetIsa

Source§

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

Formats the value using the given formatter. Read more
Source§

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

Source§

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

Converts to this type from the input type.

Implementors§

Source§

impl TargetIsa for AArch64Backend

Available on crate feature arm64 only.
Source§

impl TargetIsa for Riscv64Backend

Available on crate feature riscv64 only.