Struct symbolic::debuginfo::macho::MachObject [−][src]
pub struct MachObject<'d> { /* fields omitted */ }
Expand description
Mach Object containers, used for executables and debug companions on macOS and iOS.
Implementations
Tries to parse a MachO from the given slice.
Parses and loads the BcSymbolMap
into the object.
The bitcode symbol map must match the object, there is nothing in the symbol map which allows this call to verify this.
Once the symbolmap is loaded this object will transparently resolve any hidden symbols using the provided symbolmap.
Examples
use symbolic_debuginfo::macho::{BcSymbolMap, MachObject};
// let object_data = std::fs::read("dSYMs/.../Resources/DWARF/object").unwrap();
let mut object = MachObject::parse(&object_data).unwrap();
let map = object.symbol_map();
let symbol = map.lookup(0x5a74).unwrap();
assert_eq!(symbol.name.as_ref().map(|n| n.to_owned()).unwrap(), "__hidden#0_");
// let bc_symbol_map_data =
// std::fs::read("BCSymbolMaps/c8374b6d-6e96-34d8-ae38-efaa5fec424f.bcsymbolmap")
// .unwrap();
let bc_symbol_map = BcSymbolMap::parse(&bc_symbol_map_data).unwrap();
object.load_symbolmap(bc_symbol_map);
let map = object.symbol_map();
let symbol = map.lookup(0x5a74).unwrap();
assert_eq!(
symbol.name.as_ref().map(|n| n.to_owned()).unwrap(),
"-[SentryMessage initWithFormatted:]",
);
Gets the Compact Unwind Info of this object, if any exists.
The container file format, which is always FileFormat::MachO
.
The code identifier of this object.
Mach objects use a UUID which is specified in the load commands that are part of the Mach header. This UUID is generated at compile / link time and is usually unique per compilation.
The debug information identifier of a MachO file.
This uses the same UUID as code_id
.
The CPU architecture of this object, as specified in the Mach header.
The kind of this object, as specified in the Mach header.
The address at which the image prefers to be loaded into memory.
MachO files store all internal addresses as if it was loaded at that address. When the image is actually loaded, that spot might already be taken by other images and so it must be relocated to a new address. At runtime, a relocation table manages the arithmetics behind this.
Addresses used in symbols
or debug_session
have already been rebased relative to that
load address, so that the caller only has to deal with addresses relative to the actual
start of the image.
Determines whether this object exposes a public symbol table.
pub fn symbols(&self) -> MachOSymbolIterator<'d>ⓘNotable traits for MachOSymbolIterator<'data>impl<'data> Iterator for MachOSymbolIterator<'data> type Item = Symbol<'data>;
pub fn symbols(&self) -> MachOSymbolIterator<'d>ⓘNotable traits for MachOSymbolIterator<'data>impl<'data> Iterator for MachOSymbolIterator<'data> type Item = Symbol<'data>;
impl<'data> Iterator for MachOSymbolIterator<'data> type Item = Symbol<'data>;
Returns an iterator over symbols in the public symbol table.
Returns an ordered map of symbols in the symbol table.
Determines whether this object contains debug information.
Constructs a debugging session.
A debugging session loads certain information from the object file and creates caches for efficient access to various records in the debug information. Since this can be quite a costly process, try to reuse the debugging session as long as possible.
MachO files generally use DWARF debugging information, which is also used by ELF containers on Linux.
Constructing this session will also work if the object does not contain debugging
information, in which case the session will be a no-op. This can be checked via
has_debug_info
.
Determines whether this object contains stack unwinding information.
Determines whether this object contains embedded source.
Determines whether this object is malformed and was only partially parsed
Returns the raw data of the ELF file.
Checks whether this mach object contains hidden symbols.
This is an indication that BCSymbolMaps are needed to symbolicate crash reports correctly.
Trait Implementations
type Ref = MachObject<'slf>
type Ref = MachObject<'slf>
The Self
type with 'slf
lifetimes, returned by as_self
.
Returns a reference to self
with downcasted lifetime.
type Error = DwarfError
type Error = DwarfError
Errors thrown when reading information from this object.
type Session = DwarfDebugSession<'data>
type Session = DwarfDebugSession<'data>
A session that allows optimized access to debugging information.
type SymbolIterator = MachOSymbolIterator<'data>
type SymbolIterator = MachOSymbolIterator<'data>
The iterator over the symbols in the public symbol table.
The container format of this file.
The kind of this object.
The address at which the image prefers to be loaded into memory.
Determines whether this object exposes a public symbol table.
Returns an iterator over symbols in the public symbol table.
Returns an ordered map of symbols in the symbol table.
Determines whether this object contains debug information.
pub fn debug_session(
&self
) -> Result<<MachObject<'data> as ObjectLike<'data, 'object>>::Session, <MachObject<'data> as ObjectLike<'data, 'object>>::Error>
pub fn debug_session(
&self
) -> Result<<MachObject<'data> as ObjectLike<'data, 'object>>::Session, <MachObject<'data> as ObjectLike<'data, 'object>>::Error>
Constructs a debugging session. Read more
Determines whether this object contains stack unwinding information.
Determines whether this object contains embedded sources.
Determines whether this object is malformed and was only partially parsed
Auto Trait Implementations
impl<'d> RefUnwindSafe for MachObject<'d>
impl<'d> Send for MachObject<'d>
impl<'d> Sync for MachObject<'d>
impl<'d> Unpin for MachObject<'d>
impl<'d> UnwindSafe for MachObject<'d>
Blanket Implementations
Mutably borrows from an owned value. Read more
impl<I, T> ExtractContext<I, ()> for T
impl<I, T> ExtractContext<I, ()> for T
pub fn extract_context(self, _original_input: I)
pub fn extract_context(self, _original_input: I)
Given the context attached to a nom error, and given the original input to the nom parser, extract more the useful context information. Read more
pub fn recreate_context(_original_input: I, tail: I) -> I
pub fn recreate_context(_original_input: I, tail: I) -> I
Given the original input, as well as the context reported by nom, recreate a context in the original string where the error occurred. Read more