[−][src]Trait object::read::Object

pub trait Object<'data, 'file>: Sealed {
    type Segment: ObjectSegment<'data>;
    type SegmentIterator: Iterator<Item = Self::Segment>;
    type Section: ObjectSection<'data>;
    type SectionIterator: Iterator<Item = Self::Section>;
    type SymbolIterator: Iterator<Item = (SymbolIndex, Symbol<'data>)>;
    fn architecture(&self) -> Architecture;
    fn is_little_endian(&self) -> bool;
    fn is_64(&self) -> bool;
    fn segments(&'file self) -> Self::SegmentIterator;
    fn entry(&'file self) -> u64;
    fn section_by_name(&'file self, section_name: &str) -> Option<Self::Section>;
    fn section_by_index(
        &'file self, 
        index: SectionIndex
    ) -> Result<Self::Section>;
    fn sections(&'file self) -> Self::SectionIterator;
    fn symbol_by_index(&self, index: SymbolIndex) -> Result<Symbol<'data>>;
    fn symbols(&'file self) -> Self::SymbolIterator;
    fn dynamic_symbols(&'file self) -> Self::SymbolIterator;
    fn symbol_map(&self) -> SymbolMap<'data>;
    fn has_debug_symbols(&self) -> bool;
    fn flags(&self) -> FileFlags;

    fn endianness(&self) -> Endianness { ... }
    fn symbol_data(
        &'file self, 
        symbol: &Symbol<'data>
    ) -> Result<Option<&'data [u8]>> { ... }
    fn mach_uuid(&self) -> Result<Option<[u8; 16]>> { ... }
    fn build_id(&self) -> Result<Option<&'data [u8]>> { ... }
    fn gnu_debuglink(&self) -> Result<Option<(&'data [u8], u32)>> { ... }
}

An object file.

Associated Types

`type Segment: ObjectSegment<'data>`

A segment in the object file.

`type SegmentIterator: Iterator<Item = Self::Segment>`

An iterator over the segments in the object file.

`type Section: ObjectSection<'data>`

A section in the object file.

`type SectionIterator: Iterator<Item = Self::Section>`

An iterator over the sections in the object file.

`type SymbolIterator: Iterator<Item = (SymbolIndex, Symbol<'data>)>`

An iterator over the symbols in the object file.

Loading content...

Required methods

`fn architecture(&self) -> Architecture`

Get the architecture type of the file.

`fn is_little_endian(&self) -> bool`

Return true if the file is little endian, false if it is big endian.

`fn is_64(&self) -> bool`

Return true if the file can contain 64-bit addresses.

`fn segments(&'file self) -> Self::SegmentIterator`

Get an iterator over the segments in the file.

`fn entry(&'file self) -> u64`

Get the entry point address of the binary

`fn section_by_name(&'file self, section_name: &str) -> Option<Self::Section>`

Get the section named section_name, if such a section exists.

If section_name starts with a '.' then it is treated as a system section name, and is compared using the conventions specific to the object file format. This includes:

if ".text" is requested for a Mach-O object file, then the actual section name that is searched for is "__text".
if ".debug_info" is requested for an ELF object file, then ".zdebug_info" may be returned (and similarly for other debug sections).

For some object files, multiple segments may contain sections with the same name. In this case, the first matching section will be used.

This method skips over sections with invalid names.