close a shared object
int dlclose(void handle);
dlclose disassociates a shared object previously opened by
dlopen from the current process.
Once an object has been closed using dlclose,
its symbols are no longer available to dlsym.
All objects loaded automatically as a result of invoking
dlopen on the referenced object
are also closed. handle
is the value returned by a previous invocation of
If the referenced object was successfully closed,
dlclose returns 0.
If the object could not be closed, or if
handle does not refer to an open object,
dlclose returns a non-0 value.
More detailed diagnostic information is
available through dlerror.
A successful invocation of dlclose
does not guarantee that the objects associated with handle
have actually been removed from the address space of the process.
Objects loaded by one invocation of dlopen
may also be loaded by another invocation of dlopen.
The same object may also be opened multiple times.
An object is not removed from the address space until
all references to that object through an explicit
dlopen invocation have been closed and
all other objects implicitly referencing that object have also
Once an object has been closed by
referencing symbols contained in that object can cause
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004