Struct dlopen_rs::RelocatedLibrary

pub struct RelocatedLibrary { /* private fields */ }

Implementations

impl RelocatedLibrary

pub fn name(&self) -> &CStr

get the dynamic library name

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

Given a loaded library:

let lib = ELFLibrary::from_file("/path/to/awesome.module")
	.unwrap()
	.relocate(&[])
	.unwrap();

Loading and using a function looks like this:

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;
};

impl RelocatedLibrary

pub fn register(&self) -> Option<RelocatedLibrary>

This function can register the loaded dynamic library to ensure the correct execution of the dl_iterate_phdr function, so you can use backtrace function in the loaded dynamic library

Trait Implementations

impl Clone for RelocatedLibrary

fn clone(&self) -> RelocatedLibrary

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RelocatedLibrary

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

Formats the value using the given formatter.

impl Drop for RelocatedLibrary

fn drop(&mut self)

Executes the destructor for this type.

impl Send for RelocatedLibrary

impl Sync for RelocatedLibrary