next up previous contents index
Next: 21.1.5 dlerror: Return an Up: 21.1 Introduction Previous: 21.1.3 dlsym: Find the

21.1.4 dlclose: Delete a reference to a shared library

 

SYNOPSIS

#include <dlfnc.h>

int dlclose(void *handle);

DESCRIPTION

Delete the reference to the shared library referenced by handle. When the reference count reaches zero, the shared library is removed the OSKit kernel's address space, and the descriptor becomes invalid. Subsequent attempts to use the descriptor will result in undefined behavior. When the final reference to a shared library is deleted, the library's finalization function _fini(), if it exists, is called by the linker.

PARAMETERS

handle
The descriptor of the shared library to delete.

RETURNS

Returns 0 on success.



Utah Flux Research Group