dlclose()

close shared object 

Function


SYNOPSIS

#include <dlfcn.h>

int dlclose(void *handle);


DESCRIPTION

The dlclose() function is used to inform the system that the object referenced by a handle returned from a previous dlopen() is no longer needed by the application.

The use of a dlclose() reflects a statement of intent on the part of the process, but does not create any requirement upon the implementation, such as removal of the code or symbols referenced by handle. Once an object has been closed using dlclose() an application should assume that its symbols are no longer available to dlsym(). All objects loaded automatically as a result of invoking dlopen() on the reference object are also closed.


PARAMETERS

handle 

Points to a previously loaded shared object.


RETURN VALUES

dlclose() returns 0 on success, non-0 on failure. More detailed diagnostic information is available through dlerror().


CONFORMANCE

UNIX 98


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

dlclose() is implemented as a pass-through to the Win32 function FreeLibrary(). Please refer to the Win32 online documentation for more detailed information.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
dlerror(), dlopen(), dlsym()


PTC MKS Toolkit 10.3 Documentation Build 39.