Skip to main content

Module

Struct Module 

Source
pub struct Module { /* private fields */ }
Expand description

A validated, currently-loaded ELF object.

Implementations§

Source§

impl Module

Source

pub unsafe fn from_handle(handle: *mut c_void) -> Result<Self>

Acquire a module from a dlopen handle. On glibc, dlinfo (RTLD_DI_LINKMAP) yields the object’s load bias, which selects its dl_iterate_phdr entry.

§Safety

handle must be a live handle returned by dlopen/dlmopen for a currently-loaded object.

Source

pub unsafe fn from_address(address: *const c_void) -> Result<Self>

Acquire the module containing address — e.g. the address of an exported

§Safety

address must point into a loadable segment of a currently-mapped object.

Source

pub fn from_name(name: &str) -> Result<Self>

Acquire an already-loaded module by SONAME / path (dlopen with RTLD_NOLOAD, so a not-yet-loaded object is reported rather than loaded).

Source

pub fn enumerate() -> Result<Vec<Self>>

Enumerate every object loaded in the process (Scope::AllModules). Objects that fail validation (no PT_DYNAMIC, unsupported machine) are skipped.

Source

pub fn name(&self) -> &str

File name of the module (final path component).

Source

pub fn path(&self) -> &str

Full path of the module (dlpi_name; empty for the main executable).

Source

pub fn base(&self) -> *const c_void

Load bias (dlpi_addr) of the mapped image.

Source

pub fn size(&self) -> usize

Size of the mapped image span (hi - lo over its loadable segments).

Source

pub fn imports(&self) -> Result<Vec<ImportSlot>>

Enumerate the module’s import slots (JUMP_SLOT + GLOB_DAT).

Every returned slot’s address was validated to lie inside a loadable segment and to be pointer-aligned, so it is safe to pass to crate::install.

Trait Implementations§

Source§

impl Clone for Module

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Module

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

Source§

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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

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

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.