Struct cranelift_codegen::ir::ExtFuncData

pub struct ExtFuncData {
    pub name: ExternalName,
    pub signature: SigRef,
    pub colocated: bool,
}

An external function.

Information about a function that can be called directly with a direct call instruction.

Fields

name: ExternalName

Name of the external function.

signature: SigRef

Call signature of function.

colocated: bool

Will this function be defined nearby, such that it will always be a certain distance away, after linking? If so, references to it can avoid going through a GOT or PLT. Note that symbols meant to be preemptible cannot be considered colocated.

If true, some backends may use relocation forms that have limited range. The exact distance depends on the code model in use. Currently on AArch64, for example, Cranelift uses a custom code model supporting up to +/- 128MB displacements. If it is unknown how far away the target will be, it is best not to set the colocated flag; in general, this flag is best used when the target is known to be in the same unit of code generation, such as a Wasm module.

See the documentation for RelocDistance for more details. A colocated flag value of true implies RelocDistance::Near.

Implementations

impl ExtFuncData

pub fn reloc_distance(&self) -> RelocDistance

Return an estimate of the distance to the referred-to function symbol.

pub fn display<'a>(
    &'a self,
    params: Option<&'a FunctionParameters>
) -> DisplayableExtFuncData<'a>

Returns a displayable version of the ExtFuncData, with or without extra context to prettify the output.

Trait Implementations

impl Clone for ExtFuncData

fn clone(&self) -> ExtFuncData

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExtFuncData

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

Formats the value using the given formatter.

impl Hash for ExtFuncData

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<ExtFuncData> for ExtFuncData

fn eq(&self, other: &ExtFuncData) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ExtFuncData) -> bool

This method tests for !=.

impl StructuralPartialEq for ExtFuncData