Struct Linker 

pub struct Linker { /* private fields */ }

The linker: collects fragments and labels, resolves everything.

Implementations

impl Linker

pub fn new() -> Self

Create a new, empty linker with base address 0.

pub fn set_max_output_bytes(&mut self, max: usize)

Set the hard ceiling on the laid-out image size, in bytes.

Exceeding it during layout aborts with AsmError::ResourceLimitExceeded before any output buffer is reserved.

pub fn set_base_address(&mut self, addr: u64)

Set the base (origin) address for the assembled output.

pub fn base_address(&self) -> u64

Get the base address.

pub fn fragment_count(&self) -> usize

The number of fragments currently added.

pub fn define_external(&mut self, name: &str, addr: u64)

Define an external label at a known absolute address.

pub fn define_constant(&mut self, name: &str, value: i128)

Define a constant value (.equ / .set).

pub fn get_constant(&self, name: &str) -> Option<&i128>

Look up a constant value by name.

pub fn add_label(&mut self, name: &str, span: Span) -> Result<(), AsmError>

Add a label definition at the current position (before the next fragment).

pub fn add_fragment(&mut self, fragment: Fragment)

Add a pre-built fragment.

pub fn add_bytes(&mut self, bytes: Vec<u8>, span: Span)

Convenience: add fixed bytes (data, non-branch instructions, etc.).

pub fn add_encoded( &mut self, bytes: InstrBytes, relocation: Option<Relocation>, relax: Option<RelaxInfo>, span: Span, ) -> Result<(), AsmError>

Add an encoded instruction, automatically choosing Fixed or Relaxable.

pub fn add_alignment( &mut self, alignment: u32, fill: u8, max_skip: Option<u32>, use_nop: bool, span: Span, )

Add alignment padding.

pub fn add_org(&mut self, target: u64, fill: u8, span: Span)

Add an .org directive: advance the location counter to target, padding with fill bytes.

pub fn resolve( &mut self, ) -> Result<(Vec<u8>, Vec<(String, u64)>, Vec<AppliedRelocation>, Vec<u64>), AsmError>

Resolve all labels, perform branch relaxation, and return the final bytes together with a label→address table and applied relocations.

Note

Relocations are patched into the fragments in place, so resolve() is single-shot: calling it a second time would apply every relocation on top of the already-patched bytes and produce garbage. To re-link, build a fresh Linker and re-add the fragments.

Trait Implementations

impl Debug for Linker

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

Formats the value using the given formatter.

impl Default for Linker

fn default() -> Self

Returns the “default value” for a type.