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.