Struct symbolic_debuginfo::macho::MachArchive

pub struct MachArchive<'d>(_);

An archive that can consist of a single MachObject or a FatMachO container.

Executables and dSYM files on macOS can be a so-called Fat Mach Object: It contains multiple objects for several architectures. When loading this object, the operating system determines the object corresponding to the host's architecture. This allows to distribute a single binary with optimizations for specific CPUs, which is frequently done on iOS.

To abstract over the differences, MachArchive simulates the archive interface also for single Mach objects. This allows uniform access to both file types.

Methods

impl<'d> MachArchive<'d>

pub fn test(data: &[u8]) -> bool

Tests whether the buffer contains either a Mach Object or a Fat Mach Object.

pub fn parse(data: &'d [u8]) -> Result<Self, MachError>

Tries to parse a Mach archive from the given slice.

Important traits for MachObjectIterator<'d, 'a>

impl<'d, 'a> Iterator for MachObjectIterator<'d, 'a> type Item = Result<MachObject<'d>, MachError>;

pub fn objects(&self) -> MachObjectIterator<'d, '_>

Returns an iterator over all objects contained in this archive.

pub fn object_count(&self) -> usize

Returns the number of objects in this archive.

pub fn object_by_index(
    &self,
    index: usize
) -> Result<Option<MachObject<'d>>, MachError>

Resolves the object at the given index.

Returns Ok(None) if the index is out of bounds, or Err if the object exists but cannot be parsed.

pub fn is_multi(&self) -> bool

Returns whether this is a multi-object archive.

This may also return true if there is only a single object inside the archive.

Trait Implementations

impl<'d> Debug for MachArchive<'d>

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

Formats the value using the given formatter.

impl<'slf, 'd: 'slf> AsSelf<'slf> for MachArchive<'d>

type Ref = MachArchive<'slf>

The Self type with 'slf lifetimes, returned by as_self.

fn as_self(&'slf self) -> &Self::Ref

Returns a reference to self with downcasted lifetime.