DLCLOSE(3)

NAME
dlclose - unlink shared object from process address space

LIBRARY
This function is not in a library. It is included in every dynamically linked program automatically.

SYNOPSIS
#include <dlfcn.h>
int
dlclose(void *handle);

DESCRIPTION
The dlclose() function deletes a reference to the shared object referenced by handle. If the reference count drops to 0, the object is removed from the address space, and handle is rendered invalid. Just before removing a shared object in this way, the dynamic linker calls the object's _fini() function, if such a function is defined by the object.

The object-intrinsic functions _init() and _fini() are called with no arguments, and are not expected to return values.

RETURN VALUES
The dlclose() function returns 0 on success, or -1 if an error occurred. Whenever an error has been detected, a message detailing it can be retrieved via a call to dlerror().

SEE ALSO
rtld(1), dlerror(3), dlfcn(3), dlopen(3)