Function xmf_sys::init

source ·
pub unsafe fn init(name: &str) -> Result<bool, DlError>
Available on crate feature dlopen only.
Expand description

Loads and installs the shared library globally.

Returns true if the library was loaded and installed by this call and false if it was already installed by a previous call.

§Safety

When a library is loaded, initialisation routines contained within it are executed. For the purposes of safety, the execution of these routines is conceptually the same calling an unknown foreign function and may impose arbitrary requirements on the caller for the call to be sound.

Additionally, the callers of this function must also ensure that execution of the termination routines contained within the library is safe as well. These routines may be executed when the library is unloaded.