summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/gen/dlopen.319
1 files changed, 18 insertions, 1 deletions
diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index 66fa095..a91db05 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -91,7 +91,8 @@ executable of the process.
.Fa mode
controls the way in which external function references from the
loaded object are bound to their referents.
-It must contain one of the following values:
+It must contain one of the following values, possibly ORed with
+additional flags which will be described subsequently:
.Bl -tag -width RTLD_LAZYX
.It Dv RTLD_LAZY
Each external function reference is resolved when the function is first
@@ -108,6 +109,22 @@ However,
is useful to ensure that any undefined symbols are discovered during the
call to
.Fn dlopen .
+.Pp
+One of the following flags may be ORed into the
+.Fa mode
+argument:
+.Bl -tag -width RTLD_GLOBALX
+.It Dv RTLD_GLOBAL
+Symbols from this shared object and its directed acyclic graph (DAG)
+of needed objects will be available for resolving undefined references
+from all other shared objects.
+.It Dv RTLD_LOCAL
+Symbols in this shared object and its DAG of needed objects will be
+available for resolving undefined references only from other objects
+in the same DAG. This is the default, but it may be specified
+explicitly with this flag.
+.El
+.Pp
If
.Fn dlopen
fails, it returns a null pointer, and sets an error condition which may
OpenPOWER on IntegriCloud