dlsym 0.0.4

Memory-safe bindings around the platform's dynamic library loading primitives
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Platform-specific functionality.
//!
//! The portable API lives at the crate root. These modules expose extension
//! traits for loader features that only exist on one platform family.

#[cfg(unix)]
pub mod unix;
#[cfg(unix)]
pub(crate) use self::unix as imp;

#[cfg(windows)]
pub mod windows;
#[cfg(windows)]
pub(crate) use self::windows as imp;

// fullrust is Linux underneath but not `cfg(unix)`: it has no libc, so
// libraries are loaded through the system's `ld.so`, booted by `dldota`.
#[cfg(target_os = "fullrust")]
pub mod fullrust;
#[cfg(target_os = "fullrust")]
pub(crate) use self::fullrust as imp;

#[cfg(not(any(unix, windows, target_os = "fullrust")))]
compile_error!("dlsym supports only Unix-like, Windows and fullrust targets");

/// Outcome of a raw symbol lookup.
pub(crate) enum Lookup {
    /// The symbol exists. Its address may legitimately be null.
    Found(*mut std::ffi::c_void),
    /// The symbol does not exist; carries the loader's message.
    NotFound(String),
}