MOJOELF_dlclose

Dispose of a previously-loaded ELF binary.

Header File

Syntax

void MOJOELF_dlclose(void *lib);

Function Parameters

void *

lib

the ELF binary of which to dispose.

Remarks

This will free any resources involved with this ELF binary, including calling into a MOJOELF_UnloaderCallback to clean out any dependencies that were loaded with the binary.

The lib param must be a pointer returned from MOJOELF_dlopen_mem() or MOJOELF_dlopen_file(). You can not use a handle returned from the C runtime's dlopen() function here!

MojoELF does not currently reference-count loaded ELF binaries; a single call to this function will destroy the binary's handle (and multiple loads of the same library will all be separate instances of it, that are closed separately). Once this function is called, the app should consider lib invalid and not use it again.

Calling this function with a NULL lib is a valid no-op.

Thread Safety

this function is not thread-safe.

Version

This function is available since MojoELF 1.0.0.