Struct cranelift::prelude::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.

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<(), Error>

Formats the value using the given formatter.

impl Display for ExtFuncData

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

Formats the value using the given formatter.