Enum me3_binary::Program

pub enum Program<'a> {
    File(PeFile<'a>),
    Mapping(PeView<'a>),
}

Variants

File(PeFile<'a>)

Mapping(PeView<'a>)

Implementations

impl<'a> Program<'a>

pub unsafe fn current() -> Self

Safety

This must only be called from the context of a valid PE program. Attempting to call this on a program with malformed or incorrect PE headers is undefined behaviour.

Trait Implementations

impl<'a> Clone for Program<'a>

fn clone(&self) -> Program<'a>

Returns a copy of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Pe<'a> for Program<'a>

fn dos_header(self) -> &'a IMAGE_DOS_HEADER

Returns the DOS header.

fn dos_image(self) -> &'a [u8]

Returns the DOS image.

fn nt_headers(self) -> &'a IMAGE_NT_HEADERS64

Returns the NT headers.

fn file_header(self) -> &'a IMAGE_FILE_HEADER

Returns the file header.

fn optional_header(self) -> &'a IMAGE_OPTIONAL_HEADER64

Returns the optional header.

fn data_directory(self) -> &'a [IMAGE_DATA_DIRECTORY]

Returns the data directory.

fn section_headers(self) -> &'a SectionHeaders

Returns the section headers.

fn headers(self) -> Headers<Self>

Returns the pe headers together in a single struct.

fn rva_to_file_offset(self, rva: u32) -> Result<usize, Error>

Converts a relative virtual address to file offset.

fn file_offset_to_rva(self, file_offset: usize) -> Result<u32, Error>

Converts a file offset to relative virtual address.

fn rva_to_va(self, rva: u32) -> Result<u64, Error>

Converts from relative virtual address to virtual address.

fn va_to_rva(self, va: u64) -> Result<u32, Error>

Converts from virtual address to relative virtual address.

fn slice(
    &self,
    rva: u32,
    min_size_of: usize,
    align: usize
) -> Result<&'a [u8], Error>

Slices the image at the specified rva.

fn slice_bytes(self, rva: u32) -> Result<&'a [u8], Error>

Slices the image at the specified rva returning a byte slice with no alignment or minimum size.

fn get_section_bytes(
    self,
    section_header: &IMAGE_SECTION_HEADER
) -> Result<&'a [u8], Error>

Gets the bytes defined by a section header in this image.

fn read(
    &self,
    va: u64,
    min_size_of: usize,
    align: usize
) -> Result<&'a [u8], Error>

Reads the image at the specified va.

fn read_bytes(self, va: u64) -> Result<&'a [u8], Error>

Reads the image at the specified va returning a byte slice with no alignment or minimum size.

fn derva<T>(self, rva: u32) -> Result<&'a T, Error>where
    T: Pod,

Reads an aligned pod T.

fn derva_copy<T>(self, rva: u32) -> Result<T, Error>where
    T: Copy + Pod,

Reads an unaligned pod T.

fn derva_into<T>(self, rva: u32, dest: &mut T) -> Result<(), Error>where
    T: Pod + ?Sized,

Reads and byte-wise copies the content to the given destination.

fn derva_slice<T>(self, rva: u32, len: usize) -> Result<&'a [T], Error>where
    T: Pod,

Reads an array of pod T with given length.

fn derva_slice_f<T, F>(self, rva: u32, f: F) -> Result<&'a [T], Error>where
    T: Pod,
    F: FnMut(&'a T) -> bool,

Reads an array of pod T.

fn derva_slice_s<T>(self, rva: u32, sentinel: T) -> Result<&'a [T], Error>where
    T: PartialEq<T> + Pod,

Reads an array of pod T.

fn derva_c_str(self, rva: u32) -> Result<&'a CStr, Error>

Reads a nul-terminated C string.

fn derva_string<T>(self, rva: u32) -> Result<&'a T, Error>where
    T: FromBytes + ?Sized,

Reads a string.

fn deref<T>(self, ptr: Ptr<T>) -> Result<&'a T, Error>where
    T: Pod,

Dereferences the pointer to a pod T.

fn deref_copy<T>(self, ptr: Ptr<T>) -> Result<T, Error>where
    T: Copy + Pod,

Dereferences the pointer to an unaligned pod T.

fn deref_into<T>(self, ptr: Ptr<T>, dest: &mut T) -> Result<(), Error>where
    T: Pod + ?Sized,

Reads and byte-wise copies the content to the given destination.

fn deref_slice<T>(self, ptr: Ptr<[T]>, len: usize) -> Result<&'a [T], Error>where
    T: Pod,

Reads an array of pod T with given length.

fn deref_slice_f<T, F>(self, ptr: Ptr<[T]>, f: F) -> Result<&'a [T], Error>where
    T: Pod,
    F: FnMut(&'a T) -> bool,

Reads an array of pod T.

fn deref_slice_s<T>(self, ptr: Ptr<[T]>, sentinel: T) -> Result<&'a [T], Error>where
    T: PartialEq<T> + Pod,

Reads an array of pod T.

fn deref_c_str(self, ptr: Ptr<CStr>) -> Result<&'a CStr, Error>

Dereferences the pointer to a nul-terminated C string.

fn deref_string<T>(self, ptr: Ptr<T>) -> Result<&'a T, Error>where
    T: FromBytes + ?Sized,

Dereferences the pointer to a string.

fn rich_structure(self) -> Result<RichStructure<'a>, Error>

Returns the Rich structure.

fn exports(self) -> Result<Exports<'a, Self>, Error>

Gets the Export Directory.

fn imports(self) -> Result<Imports<'a, Self>, Error>

Gets the Import Directory.

fn iat(self) -> Result<IAT<'a, Self>, Error>

Gets the Import Address Table.

fn base_relocs(self) -> Result<BaseRelocs<'a>, Error>

Gets the Base Relocations Directory.

fn load_config(self) -> Result<LoadConfig<'a, Self>, Error>

Gets the Load Config Directory.

fn tls(self) -> Result<Tls<'a, Self>, Error>

Gets the TLS Directory.

fn security(self) -> Result<Security<'a>, Error>

Gets the Security Directory.

fn exception(self) -> Result<Exception<'a, Self>, Error>

Gets the Exception Directory.

fn debug(self) -> Result<Debug<'a, Self>, Error>

Gets the Debug Directory.

fn resources(self) -> Result<Resources<'a>, Error>where
    Self: Copy,

Gets the Resources.

fn scanner(self) -> Scanner<Self>

Gets Scanner access.

impl<'a> PeObject<'a> for Program<'a>

fn image(&self) -> &'a [u8]

Returns the image as a byte slice.

fn align(&self) -> Align

Returns whether this image uses file alignment or section alignment.

impl<'a> Copy for Program<'a>