Struct LocalsFirst 

pub struct LocalsFirst {
    pub order: Vec<usize>,
    pub old_to_new: Vec<usize>,
    pub local_count: usize,
}

The locals-first symbol order, computed ONCE for every container that needs it (#656, #1180).

ELF requires every STB_LOCAL symbol to precede every non-local one in .symtab, with the section’s sh_info = index of the first non-local. Mach-O’s LC_DYSYMTAB requires the same partition (locals, then external defined, then undefined). The ARM ELF32 builder (synth-backend, ElfBuilder::build) and the aarch64 object plan (synth-backend-aarch64, plan_object) both apply THIS permutation, so the rule is written once — a second hand-written copy in a second writer is the mirror the North Star forbids, and the way the two backends diverged in the first place.

The permutation is a STABLE sort on binding != Local: with zero locals it is the identity, which is what keeps every pre-#656 / pre-#1180 object byte-identical.

Fields

order: Vec<usize>

order[new] = old: the symbol emitted at position new is the caller’s symbol old.

old_to_new: Vec<usize>

old_to_new[old] = new: where the caller’s symbol old landed. Every relocation that names a symbol by index is rewritten through this.

local_count: usize

The number of Local symbols — the length of the local prefix. ELF’s sh_info is local_count + 1 (the null symbol at index 0 counts as local); Mach-O’s nlocalsym is local_count.

Trait Implementations

impl Clone for LocalsFirst

fn clone(&self) -> LocalsFirst

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalsFirst

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

Formats the value using the given formatter.

impl Eq for LocalsFirst

impl PartialEq for LocalsFirst

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LocalsFirst