Struct Dylib

pub struct Dylib<'scope> { /* private fields */ }

An relocated dynamic library

Implementations

impl<'scope> Dylib<'scope>

pub fn name(&self) -> &str

Get the name of the dynamic library.

pub fn cname(&self) -> &CStr

Get the C-style name of the dynamic library.

pub fn base(&self) -> usize

Get the base address of the dynamic library.

pub fn phdrs(&self) -> &[Phdr]

Get the program headers of the dynamic library.

pub fn needed_libs(&self) -> &[&str]

Get the needed libs’ name of the elf object.

pub unsafe fn get<'lib, T>(&'lib self, name: &str) -> Result<Symbol<'lib, T>>

Get a pointer to a function or static variable by symbol name.

The symbol is interpreted as-is; no mangling is done. This means that symbols like x::y are most likely invalid.

Safety

Users of this API must specify the correct type of the function or variable loaded.

Examples

unsafe {
    let awesome_function: Symbol<unsafe extern fn(f64) -> f64> =
        lib.get("awesome_function").unwrap();
    awesome_function(0.42);
}

A static variable may also be loaded and inspected:

unsafe {
    let awesome_variable: Symbol<*mut f64> = lib.get("awesome_variable").unwrap();
    **awesome_variable = 42.0;
};

Trait Implementations

impl<'scope> Clone for Dylib<'scope>

fn clone(&self) -> Dylib<'scope>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Dylib<'_>

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

Formats the value using the given formatter.

impl Drop for Dylib<'_>

fn drop(&mut self)

Executes the destructor for this type.