Struct ObjectFile

pub struct ObjectFile { /* private fields */ }

An object file.

This is the final product after assembly source code is fully assembled. This can be loaded in the simulator to run the assembled code.

Implementations

impl ObjectFile

pub fn empty() -> Self

Creates an empty object file.

pub fn link(a_obj: Self, b_obj: Self) -> Result<Self, AsmErr>

Links two object files, combining them into one.

The linking algorithm is as follows:

• The list of regions in both object files are merged into one.
• Overlaps between regions are checked. If any are found, error.
• For every symbol in the symbol table, this is added to the new symbol table.
  • If any symbols appear more than once in different locations (and neither are external), error (duplicate labels).
  • If any symbols appear more than once in different locations (and one is external), pull out any relocation entries (from .LINKER_INFO) for the external and match them.
• Merge the remaining relocation table entries.

pub fn addr_iter(&self) -> impl Iterator<Item = (u16, Option<u16>)> + '_

Gets an iterator over all of the memory locations defined in the object file.

pub fn symbol_table(&self) -> Option<&SymbolTable>

Gets the symbol table if it is present in the object file.

Trait Implementations

impl Clone for ObjectFile

fn clone(&self) -> ObjectFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectFile

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

Formats the value using the given formatter.

impl PartialEq for ObjectFile

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ObjectFile

impl StructuralPartialEq for ObjectFile