Trait cranelift_codegen::isa::TargetIsa

source · [−]

pub trait TargetIsa: Display + Send + Sync {
    fn name(&self) -> &'static str;
    fn triple(&self) -> &Triple;
    fn flags(&self) -> &Flags;
    fn isa_flags(&self) -> Vec<Value>;
    fn compile_function(
        &self,
        func: &Function,
        want_disasm: bool
    ) -> CodegenResult<MachCompileResult>;
    fn unsigned_add_overflow_condition(&self) -> IntCC;
    fn emit_unwind_info(
        &self,
        result: &MachCompileResult,
        kind: UnwindInfoKind
    ) -> CodegenResult<Option<UnwindInfo>>;
    fn text_section_builder(
        &self,
        num_labeled_funcs: u32
    ) -> Box<dyn TextSectionBuilder>;

    fn map_regalloc_reg_to_dwarf(
        &self,
        _: Reg
    ) -> Result<u16, RegisterMappingError> { ... }
    fn create_systemv_cie(&self) -> Option<CommonInformationEntry> { ... }
}

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 compile_function(
    &self,
    func: &Function,
    want_disasm: bool
) -> CodegenResult<MachCompileResult>

Compile the given function.

source

fn unsigned_add_overflow_condition(&self) -> IntCC

IntCC condition for Unsigned Addition Overflow (Carry).

source

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

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: u32
) -> 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.