dlclose(3X)         (C Programming Language Utilities)          dlclose(3X)


   NAME
         dlclose - close a shared object

   SYNOPSIS
         cc [flag ...] file ...  -ldl [library ...]

         #include <dlfcn.h>

         int dlclose(void *handle);

   DESCRIPTION
         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 [see dlopen(3X)] are also closed.  handle is the value
         returned by a previous invocation of dlopen.

   SEE ALSO
         dlerror(3X), dlopen(3X), dlsym(3X).

   DIAGNOSTICS
         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 will be available through dlerror.

   NOTES
         A successful invocation of dlclose does not guarantee that the
         objects associated with handle will actually be 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 will not be
         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 been closed.

         Once an object has been closed by dlclose, referencing symbols
         contained in that object can cause undefined behavior.














   7/91                                                                 Page 1