Trait object::read::ObjectSection

pub trait ObjectSection<'data>: Sealed {
    type RelocationIterator: Iterator<Item = (u64, Relocation)>;
    fn index(&self) -> SectionIndex;
    fn address(&self) -> u64;
    fn size(&self) -> u64;
    fn align(&self) -> u64;
    fn file_range(&self) -> Option<(u64, u64)>;
    fn data(&self) -> Result<&'data [u8]>;
    fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>;
    fn compressed_data(&self) -> Result<CompressedData<'data>>;
    fn name(&self) -> Result<&str>;
    fn segment_name(&self) -> Result<Option<&str>>;
    fn kind(&self) -> SectionKind;
    fn relocations(&self) -> Self::RelocationIterator;
    fn flags(&self) -> SectionFlags;

    fn uncompressed_data(&self) -> Result<Cow<'data, [u8]>> { ... }
}

A section defined in an object file.

Associated Types

type RelocationIterator: Iterator<Item = (u64, Relocation)>

An iterator over the relocations for a section.

The first field in the item tuple is the section offset that the relocation applies to.

Loading content...

Required methods

fn index(&self) -> SectionIndex

Returns the section index.

fn address(&self) -> u64

Returns the address of the section.

fn size(&self) -> u64

Returns the size of the section in memory.

fn align(&self) -> u64

Returns the alignment of the section in memory.

fn file_range(&self) -> Option<(u64, u64)>

Returns offset and size of on-disk segment (if any).

fn data(&self) -> Result<&'data [u8]>

Returns the raw contents of the section.

The length of this data may be different from the size of the section in memory.

This does not do any decompression.

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

Return the raw contents of the section data in the given range.

This does not do any decompression.

Returns Ok(None) if the section does not contain the given range.

fn compressed_data(&self) -> Result<CompressedData<'data>>

Returns the potentially compressed contents of the section, along with information about the compression.

fn name(&self) -> Result<&str>

Returns the name of the section.

fn segment_name(&self) -> Result<Option<&str>>

Returns the name of the segment for this section.

fn kind(&self) -> SectionKind

Return the kind of this section.

fn relocations(&self) -> Self::RelocationIterator

Get the relocations for this section.

fn flags(&self) -> SectionFlags

Section flags that are specific to each file format.

Loading content...

Provided methods

fn uncompressed_data(&self) -> Result<Cow<'data, [u8]>>

Returns the uncompressed contents of the section.

The length of this data may be different from the size of the section in memory.

If no compression is detected, then returns the data unchanged. Returns Err if decompression fails.

Loading content...

Implementors

impl<'data, 'file> ObjectSection<'data> for CoffSection<'data, 'file>

type RelocationIterator = CoffRelocationIterator<'data, 'file>

fn index(&self) -> SectionIndex

fn address(&self) -> u64

fn size(&self) -> u64

fn align(&self) -> u64

fn file_range(&self) -> Option<(u64, u64)>

fn data(&self) -> Result<&'data [u8]>

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

fn compressed_data(&self) -> Result<CompressedData<'data>>

fn name(&self) -> Result<&str>

fn segment_name(&self) -> Result<Option<&str>>

fn kind(&self) -> SectionKind

fn relocations(&self) -> CoffRelocationIterator<'data, 'file>

fn flags(&self) -> SectionFlags

impl<'data, 'file> ObjectSection<'data> for Section<'data, 'file>

type RelocationIterator = SectionRelocationIterator<'data, 'file>

fn index(&self) -> SectionIndex

fn address(&self) -> u64

fn size(&self) -> u64

fn align(&self) -> u64

fn file_range(&self) -> Option<(u64, u64)>

fn data(&self) -> Result<&'data [u8]>

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

fn compressed_data(&self) -> Result<CompressedData<'data>>

fn name(&self) -> Result<&str>

fn segment_name(&self) -> Result<Option<&str>>

fn kind(&self) -> SectionKind

fn relocations(&self) -> SectionRelocationIterator<'data, 'file>

fn flags(&self) -> SectionFlags

impl<'data, 'file, Elf: FileHeader> ObjectSection<'data> for ElfSection<'data, 'file, Elf>

type RelocationIterator = ElfSectionRelocationIterator<'data, 'file, Elf>

fn index(&self) -> SectionIndex

fn address(&self) -> u64

fn size(&self) -> u64

fn align(&self) -> u64

fn file_range(&self) -> Option<(u64, u64)>

fn data(&self) -> Result<&'data [u8]>

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

fn compressed_data(&self) -> Result<CompressedData<'data>>

fn name(&self) -> Result<&str>

fn segment_name(&self) -> Result<Option<&str>>

fn kind(&self) -> SectionKind

fn relocations(&self) -> ElfSectionRelocationIterator<'data, 'file, Elf>

fn flags(&self) -> SectionFlags

impl<'data, 'file, Mach: MachHeader> ObjectSection<'data> for MachOSection<'data, 'file, Mach>

type RelocationIterator = MachORelocationIterator<'data, 'file, Mach>

fn index(&self) -> SectionIndex

fn address(&self) -> u64

fn size(&self) -> u64

fn align(&self) -> u64

fn file_range(&self) -> Option<(u64, u64)>

fn data(&self) -> Result<&'data [u8]>

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

fn compressed_data(&self) -> Result<CompressedData<'data>>

fn name(&self) -> Result<&str>

fn segment_name(&self) -> Result<Option<&str>>

fn kind(&self) -> SectionKind

fn relocations(&self) -> MachORelocationIterator<'data, 'file, Mach>

fn flags(&self) -> SectionFlags

impl<'data, 'file, Pe: ImageNtHeaders> ObjectSection<'data> for PeSection<'data, 'file, Pe>

type RelocationIterator = PeRelocationIterator<'data, 'file>

fn index(&self) -> SectionIndex

fn address(&self) -> u64

fn size(&self) -> u64

fn align(&self) -> u64

fn file_range(&self) -> Option<(u64, u64)>

fn data(&self) -> Result<&'data [u8]>

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

fn compressed_data(&self) -> Result<CompressedData<'data>>

fn name(&self) -> Result<&str>

fn segment_name(&self) -> Result<Option<&str>>

fn kind(&self) -> SectionKind

fn relocations(&self) -> PeRelocationIterator<'data, 'file>

fn flags(&self) -> SectionFlags

Loading content...