dyld-239.3.tar.gz

[apple/dyld.git] / doc / man / man3 / dlclose.3

diff --git a/doc/man/man3/dlclose.3 b/doc/man/man3/dlclose.3
index c966d6a00d8b9b1a5c0e14be518142e0c4d7ddae..1200e8086f1c32f5b1bad0f5b045ad3c89e4dbc8 100644 (file)
--- a/doc/man/man3/dlclose.3
+++ b/doc/man/man3/dlclose.3
@@ -1,4 +1,4 @@
-.Dd Sept 25, 2004
+.Dd Nov 6, 2006

 .Dt DLCLOSE 3
 .Sh NAME
 .Nm dlclose
 .Dt DLCLOSE 3
 .Sh NAME
 .Nm dlclose


@@ -19,6 +19,13 @@ Just before removing a dynamic library or bundle in this way, any
 termination routines in it are called.  
 .Fa handle
 is the value returned by a previous call to dlopen.
 termination routines in it are called.  
 .Fa handle
 is the value returned by a previous call to dlopen.

+.Pp
+Prior to Mac OS X 10.5, only bundles could be unloaded.  Starting in Mac OS X 10.5, 
+dynamic libraries may also be unloaded.  There are a couple of cases in which a
+dynamic library will never be unloaded: 1) the main executable links against it, 
+2) An API that does not supoort unloading (e.g. NSAddImage()) was used to load
+it or some other dynnamic library that depends on it, 3) the dynamic library
+is in dyld's shared cache.

 .Sh RETURN VALUES
 If
 .Fn dlclose
 .Sh RETURN VALUES
 If
 .Fn dlclose


@@ -32,7 +39,5 @@ retrived with
 .Xr dlsym 3
 .Xr dlerror 3
 .Xr dyld 3
 .Xr dlsym 3
 .Xr dlerror 3
 .Xr dyld 3

-.Xr NSModule 3
-.Xr NSObjectFileImage 3

 .Xr ld 1
 .Xr cc 1
 .Xr ld 1
 .Xr cc 1