dlclose

dlclose — closes an open dynamic library.

Syntax

dlclose (handle)

		

Arguments

handle

The "handle" returned by dlopen.

Returns

0 when successful, else -1.

Description

This function is a wrapper for the dlclose shell command. Each call decrements the link count in the dl library created by dlopen. When this count reaches zero and no other loaded libraries use symbols in it, the library is unloaded.

If the library exports a routine named _fini, that will be called just before the library is unloaded.

Example

Gamma> dlopen("libform.so",RTLD_NOW|RTLD_GLOBAL);
134940024
Gamma> a = dlopen("libform.so",RTLD_NOW|RTLD_GLOBAL);
134940024
Gamma> dlclose(a);
0
Gamma> dlclose(a);
0
Gamma> dlclose(a);
-1
Gamma> 
		

See Also

dlopen