Struct symbolic::debuginfo::breakpad::BreakpadObject [−][src]
pub struct BreakpadObject<'data> { /* fields omitted */ }
Expand description
A Breakpad object file.
To process minidump crash reports without having to understand all sorts of native symbol formats, the Breakpad processor uses a text-based symbol file format. It comprises records describing the object file, functions and lines, public symbols, as well as unwind information for stackwalking.
The platform-specific symbol dumping tools parse the debugging information the compiler provides (whether as DWARF or STABS sections in an ELF file or as stand-alone PDB files), and write that information back out in the Breakpad symbol file format. This format is much simpler and less detailed than compiler debugging information, and values legibility over compactness.
The full documentation resides here.
Implementations
Tries to parse a Breakpad object from the given slice.
The container file format, which is always FileFormat::Breakpad
.
The debug file name of this object.
This is the name of the original debug file that was used to create the Breakpad file. On
Windows, this will have a .pdb
extension, on other platforms that name is likely
equivalent to the name of the code file (shared library or executable).
The kind of this object.
The address at which the image prefers to be loaded into memory.
When Breakpad symbols are written, all addresses are rebased relative to the load address. Since the original load address is not stored in the file, it is assumed as zero.
Determines whether this object exposes a public symbol table.
pub fn symbols(&self) -> BreakpadSymbolIterator<'data>ⓘNotable traits for BreakpadSymbolIterator<'data>impl<'data> Iterator for BreakpadSymbolIterator<'data> type Item = Symbol<'data>;
pub fn symbols(&self) -> BreakpadSymbolIterator<'data>ⓘNotable traits for BreakpadSymbolIterator<'data>impl<'data> Iterator for BreakpadSymbolIterator<'data> type Item = Symbol<'data>;
impl<'data> Iterator for BreakpadSymbolIterator<'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.
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
pub fn info_records(&self) -> BreakpadInfoRecords<'data>ⓘNotable traits for BreakpadInfoRecords<'d>impl<'d> Iterator for BreakpadInfoRecords<'d> type Item = Result<BreakpadInfoRecord<'d>, BreakpadError>;
pub fn info_records(&self) -> BreakpadInfoRecords<'data>ⓘNotable traits for BreakpadInfoRecords<'d>impl<'d> Iterator for BreakpadInfoRecords<'d> type Item = Result<BreakpadInfoRecord<'d>, BreakpadError>;
impl<'d> Iterator for BreakpadInfoRecords<'d> type Item = Result<BreakpadInfoRecord<'d>, BreakpadError>;
Returns an iterator over info records.
pub fn file_records(&self) -> BreakpadFileRecords<'data>ⓘNotable traits for BreakpadFileRecords<'d>impl<'d> Iterator for BreakpadFileRecords<'d> type Item = Result<BreakpadFileRecord<'d>, BreakpadError>;
pub fn file_records(&self) -> BreakpadFileRecords<'data>ⓘNotable traits for BreakpadFileRecords<'d>impl<'d> Iterator for BreakpadFileRecords<'d> type Item = Result<BreakpadFileRecord<'d>, BreakpadError>;
impl<'d> Iterator for BreakpadFileRecords<'d> type Item = Result<BreakpadFileRecord<'d>, BreakpadError>;
Returns an iterator over file records.
pub fn public_records(&self) -> BreakpadPublicRecords<'data>ⓘNotable traits for BreakpadPublicRecords<'d>impl<'d> Iterator for BreakpadPublicRecords<'d> type Item = Result<BreakpadPublicRecord<'d>, BreakpadError>;
pub fn public_records(&self) -> BreakpadPublicRecords<'data>ⓘNotable traits for BreakpadPublicRecords<'d>impl<'d> Iterator for BreakpadPublicRecords<'d> type Item = Result<BreakpadPublicRecord<'d>, BreakpadError>;
impl<'d> Iterator for BreakpadPublicRecords<'d> type Item = Result<BreakpadPublicRecord<'d>, BreakpadError>;
Returns an iterator over public symbol records.
pub fn func_records(&self) -> BreakpadFuncRecords<'data>ⓘNotable traits for BreakpadFuncRecords<'d>impl<'d> Iterator for BreakpadFuncRecords<'d> type Item = Result<BreakpadFuncRecord<'d>, BreakpadError>;
pub fn func_records(&self) -> BreakpadFuncRecords<'data>ⓘNotable traits for BreakpadFuncRecords<'d>impl<'d> Iterator for BreakpadFuncRecords<'d> type Item = Result<BreakpadFuncRecord<'d>, BreakpadError>;
impl<'d> Iterator for BreakpadFuncRecords<'d> type Item = Result<BreakpadFuncRecord<'d>, BreakpadError>;
Returns an iterator over function records.
pub fn stack_records(&self) -> BreakpadStackRecords<'data>ⓘNotable traits for BreakpadStackRecords<'d>impl<'d> Iterator for BreakpadStackRecords<'d> type Item = Result<BreakpadStackRecord<'d>, BreakpadError>;
pub fn stack_records(&self) -> BreakpadStackRecords<'data>ⓘNotable traits for BreakpadStackRecords<'d>impl<'d> Iterator for BreakpadStackRecords<'d> type Item = Result<BreakpadStackRecord<'d>, BreakpadError>;
impl<'d> Iterator for BreakpadStackRecords<'d> type Item = Result<BreakpadStackRecord<'d>, BreakpadError>;
Returns an iterator over stack frame records.
Trait Implementations
type Ref = BreakpadObject<'slf>
type Ref = BreakpadObject<'slf>
The Self
type with 'slf
lifetimes, returned by as_self
.
Returns a reference to self
with downcasted lifetime.
impl<'data, 'object> ObjectLike<'data, 'object> for BreakpadObject<'data> where
'data: 'object,
impl<'data, 'object> ObjectLike<'data, 'object> for BreakpadObject<'data> where
'data: 'object,
type Error = BreakpadError
type Error = BreakpadError
Errors thrown when reading information from this object.
type Session = BreakpadDebugSession<'data>
type Session = BreakpadDebugSession<'data>
A session that allows optimized access to debugging information.
type SymbolIterator = BreakpadSymbolIterator<'data>
type SymbolIterator = BreakpadSymbolIterator<'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.
pub fn symbols(
&self
) -> <BreakpadObject<'data> as ObjectLike<'data, 'object>>::SymbolIterator
pub fn symbols(
&self
) -> <BreakpadObject<'data> as ObjectLike<'data, 'object>>::SymbolIterator
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<<BreakpadObject<'data> as ObjectLike<'data, 'object>>::Session, <BreakpadObject<'data> as ObjectLike<'data, 'object>>::Error>
pub fn debug_session(
&self
) -> Result<<BreakpadObject<'data> as ObjectLike<'data, 'object>>::Session, <BreakpadObject<'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<'data> RefUnwindSafe for BreakpadObject<'data>
impl<'data> Send for BreakpadObject<'data>
impl<'data> Sync for BreakpadObject<'data>
impl<'data> Unpin for BreakpadObject<'data>
impl<'data> UnwindSafe for BreakpadObject<'data>
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