Struct object::read::pe::PeFile

source · [−]

pub struct PeFile<'data, Pe: ImageNtHeaders> { /* private fields */ }

Expand description

A PE object file.

Implementations

source

impl<'data, Pe: ImageNtHeaders> PeFile<'data, Pe>

source

pub fn optional_header_magic(data: &'data [u8 ]) -> Result<u16>

Find the optional header and read the optional_header.magic.

source

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

Parse the raw PE file data.

Trait Implementations

source

impl<'data, Pe: Debug + ImageNtHeaders> Debug for PeFile<'data, Pe>

source

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

Formats the value using the given formatter. Read more

source

impl<'data, 'file, Pe> Object<'data, 'file> for PeFile<'data, Pe> where
'data: 'file,
Pe: ImageNtHeaders,

type Segment = PeSegment<'data, 'file, Pe>

A segment in the object file.

type SegmentIterator = PeSegmentIterator<'data, 'file, Pe>

An iterator over the segments in the object file.

type Section = PeSection<'data, 'file, Pe>

A section in the object file.

type SectionIterator = PeSectionIterator<'data, 'file, Pe>

An iterator over the sections in the object file.

type Comdat = PeComdat<'data, 'file, Pe>

A COMDAT section group in the object file.

type ComdatIterator = PeComdatIterator<'data, 'file, Pe>

An iterator over the COMDAT section groups in the object file.

type Symbol = CoffSymbol<'data, 'file>

A symbol in the object file.

type SymbolIterator = CoffSymbolIterator<'data, 'file>

An iterator over symbols in the object file.

type SymbolTable = CoffSymbolTable<'data, 'file>

A symbol table in the object file.

type DynamicRelocationIterator = NoDynamicRelocationIterator

An iterator over dynamic relocations in the file. Read more

source

fn architecture(&self) -> Architecture

Get the architecture type of the file.

source

fn is_little_endian(&self) -> bool

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

source

fn is_64(&self) -> bool

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

source

fn segments(&'file self) -> PeSegmentIterator<'data, 'file, Pe>ⓘNotable traits for PeSegmentIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSegmentIterator<'data, 'file, Pe> type Item = PeSegment<'data, 'file, Pe>;`

Get an iterator over the segments in the file.

source

fn section_by_name(
&'file self,
section_name: &str
) -> Option<PeSection<'data, 'file, Pe>>

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

source

fn section_by_index(
&'file self,
index: SectionIndex
) -> Result<PeSection<'data, 'file, Pe>>

Get the section at the given index. Read more

source

fn sections(&'file self) -> PeSectionIterator<'data, 'file, Pe>ⓘNotable traits for PeSectionIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSectionIterator<'data, 'file, Pe> type Item = PeSection<'data, 'file, Pe>;`

Get an iterator over the sections in the file.

source

fn comdats(&'file self) -> PeComdatIterator<'data, 'file, Pe>ⓘNotable traits for PeComdatIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeComdatIterator<'data, 'file, Pe> type Item = PeComdat<'data, 'file, Pe>;`

Get an iterator over the COMDAT section groups in the file.

source

fn symbol_by_index(
&'file self,
index: SymbolIndex
) -> Result<CoffSymbol<'data, 'file>>

Get the debugging symbol at the given index. Read more

source

fn symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>`impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;`

Get an iterator over the debugging symbols in the file. Read more

source

fn symbol_table(&'file self) -> Option<CoffSymbolTable<'data, 'file>>

Get the symbol table, if any.

source

fn dynamic_symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>`impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;`

Get an iterator over the dynamic linking symbols in the file. Read more

source

fn dynamic_symbol_table(&'file self) -> Option<CoffSymbolTable<'data, 'file>>

Get the dynamic linking symbol table, if any. Read more

source

fn dynamic_relocations(&'file self) -> Option<NoDynamicRelocationIterator>

Get the dynamic relocations for this file. Read more

source

fn imports(&self) -> Result<Vec<Import<'data>>>

Get the imported symbols.

source

fn exports(&self) -> Result<Vec<Export<'data>>>

Get the exported symbols.

source

fn has_debug_symbols(&self) -> bool

Return true if the file contains debug information sections, false if not.

source

fn entry(&self) -> u64

Get the entry point address of the binary

source

fn flags(&self) -> FileFlags

File flags that are specific to each file format.

source

fn endianness(&self) -> Endianness

Get the endianness of the file.

source

fn symbol_map(&'file self) -> SymbolMap<SymbolMapName<'data>>

Construct a map from addresses to symbol names. Read more

source

fn object_map(&'file self) -> ObjectMap<'data>

Construct a map from addresses to symbol names and object file names. Read more

source

fn mach_uuid(&self) -> Result<Option<[u8 ; 16]>>

The UUID from a Mach-O LC_UUID load command.

source

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

The build ID from an ELF NT_GNU_BUILD_ID note.

source

fn gnu_debuglink(&self) -> Result<Option<(&'data [u8 ], u32 )>>

The filename and CRC from a .gnu_debuglink section.

Auto Trait Implementations

impl<'data, Pe> RefUnwindSafe for PeFile<'data, Pe> where
Pe: RefUnwindSafe,

impl<'data, Pe> Send for PeFile<'data, Pe> where
Pe: Sync,

impl<'data, Pe> Sync for PeFile<'data, Pe> where
Pe: Sync,

impl<'data, Pe> Unpin for PeFile<'data, Pe>

impl<'data, Pe> UnwindSafe for PeFile<'data, Pe> where
Pe: RefUnwindSafe,

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct object::read::pe::PeFile

Implementations

impl<'data, Pe: ImageNtHeaders> PeFile<'data, Pe>

pub fn optional_header_magic(data: &'data [u8]) -> Result<u16>

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

Trait Implementations

impl<'data, Pe: Debug + ImageNtHeaders> Debug for PeFile<'data, Pe>

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

impl<'data, 'file, Pe> Object<'data, 'file> for PeFile<'data, Pe> where 'data: 'file, Pe: ImageNtHeaders,

type Segment = PeSegment<'data, 'file, Pe>

type SegmentIterator = PeSegmentIterator<'data, 'file, Pe>

type Section = PeSection<'data, 'file, Pe>

type SectionIterator = PeSectionIterator<'data, 'file, Pe>

type Comdat = PeComdat<'data, 'file, Pe>

type ComdatIterator = PeComdatIterator<'data, 'file, Pe>

type Symbol = CoffSymbol<'data, 'file>

type SymbolIterator = CoffSymbolIterator<'data, 'file>

type SymbolTable = CoffSymbolTable<'data, 'file>

type DynamicRelocationIterator = NoDynamicRelocationIterator

fn architecture(&self) -> Architecture

fn is_little_endian(&self) -> bool

fn is_64(&self) -> bool

fn segments(&'file self) -> PeSegmentIterator<'data, 'file, Pe>ⓘNotable traits for PeSegmentIterator<'data, 'file, Pe>impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSegmentIterator<'data, 'file, Pe> type Item = PeSegment<'data, 'file, Pe>;

fn section_by_name( &'file self, section_name: &str) -> Option<PeSection<'data, 'file, Pe>>

fn section_by_index( &'file self, index: SectionIndex) -> Result<PeSection<'data, 'file, Pe>>

fn sections(&'file self) -> PeSectionIterator<'data, 'file, Pe>ⓘNotable traits for PeSectionIterator<'data, 'file, Pe>impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSectionIterator<'data, 'file, Pe> type Item = PeSection<'data, 'file, Pe>;

fn comdats(&'file self) -> PeComdatIterator<'data, 'file, Pe>ⓘNotable traits for PeComdatIterator<'data, 'file, Pe>impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeComdatIterator<'data, 'file, Pe> type Item = PeComdat<'data, 'file, Pe>;

fn symbol_by_index( &'file self, index: SymbolIndex) -> Result<CoffSymbol<'data, 'file>>

fn symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;

fn symbol_table(&'file self) -> Option<CoffSymbolTable<'data, 'file>>

fn dynamic_symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;

fn dynamic_symbol_table(&'file self) -> Option<CoffSymbolTable<'data, 'file>>

fn dynamic_relocations(&'file self) -> Option<NoDynamicRelocationIterator>

fn imports(&self) -> Result<Vec<Import<'data>>>

fn exports(&self) -> Result<Vec<Export<'data>>>

fn has_debug_symbols(&self) -> bool

fn entry(&self) -> u64

fn flags(&self) -> FileFlags

fn endianness(&self) -> Endianness

fn symbol_map(&'file self) -> SymbolMap<SymbolMapName<'data>>

fn object_map(&'file self) -> ObjectMap<'data>

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)>>

Auto Trait Implementations

impl<'data, Pe> RefUnwindSafe for PeFile<'data, Pe> where Pe: RefUnwindSafe,

impl<'data, Pe> Send for PeFile<'data, Pe> where Pe: Sync,

impl<'data, Pe> Sync for PeFile<'data, Pe> where Pe: Sync,

impl<'data, Pe> Unpin for PeFile<'data, Pe>

impl<'data, Pe> UnwindSafe for PeFile<'data, Pe> where Pe: RefUnwindSafe,

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

pub fn optional_header_magic(data: &'data [u8 ]) -> Result<u16>

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

impl<'data, 'file, Pe> Object<'data, 'file> for PeFile<'data, Pe> where
'data: 'file,
Pe: ImageNtHeaders,

fn segments(&'file self) -> PeSegmentIterator<'data, 'file, Pe>ⓘNotable traits for PeSegmentIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSegmentIterator<'data, 'file, Pe> type Item = PeSegment<'data, 'file, Pe>;`

fn section_by_name(
&'file self,
section_name: &str
) -> Option<PeSection<'data, 'file, Pe>>

fn section_by_index(
&'file self,
index: SectionIndex
) -> Result<PeSection<'data, 'file, Pe>>

fn sections(&'file self) -> PeSectionIterator<'data, 'file, Pe>ⓘNotable traits for PeSectionIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeSectionIterator<'data, 'file, Pe> type Item = PeSection<'data, 'file, Pe>;`

fn comdats(&'file self) -> PeComdatIterator<'data, 'file, Pe>ⓘNotable traits for PeComdatIterator<'data, 'file, Pe>`impl<'data, 'file, Pe: ImageNtHeaders> Iterator for PeComdatIterator<'data, 'file, Pe> type Item = PeComdat<'data, 'file, Pe>;`

fn symbol_by_index(
&'file self,
index: SymbolIndex
) -> Result<CoffSymbol<'data, 'file>>

fn symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>`impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;`

fn dynamic_symbols(&'file self) -> CoffSymbolIterator<'data, 'file>ⓘNotable traits for CoffSymbolIterator<'data, 'file>`impl<'data, 'file> Iterator for CoffSymbolIterator<'data, 'file> type Item = CoffSymbol<'data, 'file>;`

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 )>>

impl<'data, Pe> RefUnwindSafe for PeFile<'data, Pe> where
Pe: RefUnwindSafe,

impl<'data, Pe> Send for PeFile<'data, Pe> where
Pe: Sync,

impl<'data, Pe> Sync for PeFile<'data, Pe> where
Pe: Sync,

impl<'data, Pe> UnwindSafe for PeFile<'data, Pe> where
Pe: RefUnwindSafe,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,