From a4fe11fb039b87853f7344fe7730c2f3917a6331 Mon Sep 17 00:00:00 2001
From: phantom <phantom@FreeBSD.org>
Date: Fri, 14 Feb 2003 10:57:20 +0000
Subject: o Document that dlsym()'s behaviour with new special handle RTLD_SELF

o Add cross reference to dlinfo(3)
o Minor mdoc nits
---
 lib/libc/gen/dlopen.3 | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

(limited to 'lib')

diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index d6bb9f9..7cc3f3a 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -36,7 +36,11 @@
 .Os
 .Dt DLOPEN 3
 .Sh NAME
-.Nm dlopen , dlsym , dlfunc , dlerror , dlclose
+.Nm dlopen ,
+.Nm dlsym ,
+.Nm dlfunc ,
+.Nm dlerror ,
+.Nm dlclose
 .Nd programmatic interface to the dynamic linker
 .Sh LIBRARY
 .Lb libc
@@ -231,6 +235,16 @@ interface, below, should be used, since
 .Fn getpid
 is a function and not a data object.)
 .Pp
+If
+.Fn dlsym
+is called with the special
+.Fa handle
+.Dv RTLD_SELF ,
+then the search for the symbol is limited to the shared object
+issuing the call to
+.Fn dlsym
+and those shared objects which were loaded after it.
+.Pp
 The
 .Fn dlsym
 function
@@ -340,4 +354,5 @@ retrieved via a call to
 .Xr ld 1 ,
 .Xr rtld 1 ,
 .Xr dladdr 3 ,
+.Xr dlinfo 3 ,
 .Xr link 5
-- 
cgit v1.1