Close a shared object
#include <dlfcn.h> int dlclose( void *handle );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The dlclose() function disassociates a shared object opened by dlopen() from the calling process. An object's symbols are no longer available after it's been closed with dlclose(). All objects loaded as a result of the closed objects dependencies are also closed.
The handle argument is the value returned by a previous call to dlopen().
The dlclose() function is available only to dynamically linked processes. |
0 for success, or a nonzero value if an error occurs.
If an error occurs, more detailed diagnostic information is available from dlerror().
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |
An object isn't removed from the address space until all references to that object (via dlopen() or dependencies from other objects) have been closed.
Referencing a symbol in a closed object can cause undefined behavior.
dladdr(), dlerror(), dlopen(), dlsym()
“Dynamic Linking” chapter of the System Architecture guide
“Lazy loading” in the “Compiling and Debugging” chapter of the QNX Neutrino Programmer's Guide