Struct NativeLoaderInternal 

pub struct NativeLoaderInternal<'loader> { /* private fields */ }

Native library loader internal interface.

Implementations

impl NativeLoaderInternal<'_>

pub unsafe fn load_ext( &mut self, path: &impl AsRef<Path>, flags: i32, ) -> Result<InternalLibrary<Owned>, Error>

Loads a library. The resulting handle is unique.

The argument flags is passed to dlopen.

Failure

The function fails if path is invalid or the call to dlopen fails.

Return

Handle on success, error otherwise.

Safety

The function crosses the ffi boundary. Direct usage of a NativeLoaderInternal may break some invariants of the library api, if not handled with care.

pub unsafe fn get_native_handle<O>( &self, internal: &InternalLibrary<O>, ) -> Result<NativeLibraryHandle, Error>

where O: ImmutableAccessIdentifier,

Returns the underlying handle of a library.

Failure

The function fails if internal is invalid.

Return

Handle on success, error otherwise.

Safety

The function crosses the ffi boundary. Direct usage of a NativeLoaderInternal may break some invariants of the library api, if not handled with care.

Methods from Deref<Target = NonNullConst<NativeLibraryLoaderInterface>>

pub unsafe fn into_mut(&self) -> NonNull<T>

Acquires a mutable version of the pointer.

Safety

It is undefined behavior if the underlying pointer is not already mutable.

pub unsafe fn as_ref(&self) -> &T

Returns a shared reference to the value.

Safety

The same restrictions as NonNull::as_ref apply.

Trait Implementations

impl<'loader> Clone for NativeLoaderInternal<'loader>

fn clone(&self) -> NativeLoaderInternal<'loader>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'loader> Debug for NativeLoaderInternal<'loader>

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

Formats the value using the given formatter.

impl Deref for NativeLoaderInternal<'_>

type Target = NonNullConst<NativeLibraryLoaderInterface>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for NativeLoaderInternal<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a> LibraryLoaderAPI<'a> for NativeLoaderInternal<'a>

type InternalLoader = NativeLoaderInternal<'a>

Type of the internal loader.

fn to_interface(&self) -> NonNullConst<LibraryLoaderInterface>

Fetches a pointer that can be used with the interface.

unsafe fn from_interface( interface: NonNullConst<LibraryLoaderInterface>, ) -> Self

Construct a new instance from a pointer.

unsafe fn from_void_ptr(interface: NonNullConst<c_void>) -> Self

Construct a new instance from a void pointer.

unsafe fn load( &mut self, path: &impl AsRef<Path>, ) -> Result<InternalLibrary<Owned>, Error>

Loads a library. The resulting handle is unique.

unsafe fn unload( &mut self, internal: InternalLibrary<Owned>, ) -> Result<(), Error>

Unloads a library.

unsafe fn get_data_symbol<O, U>( &self, internal: &InternalLibrary<O>, symbol: &impl AsRef<CStr>, caster: impl FnOnce(NonNullConst<c_void>) -> &'a U, ) -> Result<Symbol<'a, &'a U>, Error>

where O: ImmutableAccessIdentifier,

Fetches a data symbol from a library.

unsafe fn get_function_symbol<O, U>( &self, internal: &InternalLibrary<O>, symbol: &impl AsRef<CStr>, caster: impl FnOnce(CBaseFn) -> U, ) -> Result<Symbol<'a, U>, Error>

where O: ImmutableAccessIdentifier,

Fetches a function symbol from a library.

unsafe fn get_internal_interface(&self) -> Self::InternalLoader

Fetches a pointer to the internal interface.

impl<'loader> Ord for NativeLoaderInternal<'loader>

fn cmp(&self, other: &NativeLoaderInternal<'loader>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'loader> PartialEq for NativeLoaderInternal<'loader>

fn eq(&self, other: &NativeLoaderInternal<'loader>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'loader> PartialOrd for NativeLoaderInternal<'loader>

fn partial_cmp(&self, other: &NativeLoaderInternal<'loader>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'loader> Copy for NativeLoaderInternal<'loader>

impl<'loader> Eq for NativeLoaderInternal<'loader>

impl Send for NativeLoaderInternal<'_>

impl<'loader> StructuralPartialEq for NativeLoaderInternal<'loader>

impl Sync for NativeLoaderInternal<'_>