Trait TargetIsa

Source

pub trait TargetIsa:
    Display
    + Send
    + Sync {
Show 21 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 pretty_print_reg(&self, reg: Reg, size: u8) -> String;
    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;
    fn default_argument_extension(&self) -> ArgumentExtension;

    // 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 { ... }
}

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 pretty_print_reg(&self, reg: Reg, size: u8) -> String

Return the string representation of “reg” accessed as “size” bytes. The returned string will match the usual disassemly view of “reg”.

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.

Source

fn default_argument_extension(&self) -> ArgumentExtension

Returns the mode of extension used for integer arguments smaller than the pointer width in function signatures.

Some platform ABIs require that smaller-than-pointer-width values are either zero or sign-extended to the full register width. This value is propagated to the AbiParam value created for signatures. Note that not all ABIs for all platforms require extension of any form, so this is generally only necessary for the default_call_conv.