summaryrefslogtreecommitdiffstats
path: root/man3/dlopen.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/dlopen.3')
-rw-r--r--man3/dlopen.350
1 files changed, 25 insertions, 25 deletions
diff --git a/man3/dlopen.3 b/man3/dlopen.3
index 03fbc04e1..86a03ad81 100644
--- a/man3/dlopen.3
+++ b/man3/dlopen.3
@@ -44,9 +44,9 @@ string
.I filename
and returns an opaque "handle" for the loaded object.
This handle is employed with other functions in the dlopen API, such as
-.BR dlsym (3),
-.BR dladdr (3),
-.BR dlinfo (3),
+.MR dlsym 3 ,
+.MR dladdr 3 ,
+.MR dlinfo 3 ,
and
.BR dlclose ().
.P
@@ -66,7 +66,7 @@ contains a slash ("/"), then it is interpreted as a (relative
or absolute) pathname.
Otherwise, the dynamic linker searches for the object as follows
(see
-.BR ld.so (8)
+.MR ld.so 8
for further details):
.IP \[bu] 3
(ELF only) If the calling object
@@ -90,7 +90,7 @@ are searched.
The cache file
.I /etc/ld.so.cache
(maintained by
-.BR ldconfig (8))
+.MR ldconfig 8 )
is checked to see whether it contains an entry for
.IR filename .
.IP \[bu]
@@ -181,7 +181,7 @@ If
.I filename
is NULL, then the returned handle is for the main program.
When given to
-.BR dlsym (3),
+.MR dlsym 3 ,
this handle causes a search for a symbol in the main program,
followed by all shared objects loaded at program startup,
and then all shared objects loaded by
@@ -203,14 +203,14 @@ and definitions in the shared object itself
.P
Any global symbols in the executable that were placed into
its dynamic symbol table by
-.BR ld (1)
+.MR ld 1
can also be used to resolve references in a dynamically loaded shared object.
Symbols may be placed in the dynamic symbol table
either because the executable was linked with the flag "\-rdynamic"
(or, synonymously, "\-\-export\-dynamic"), which causes all of
the executable's global symbols to be placed in the dynamic symbol table,
or because
-.BR ld (1)
+.MR ld 1
noted a dependency on a symbol in another object during static linking.
.P
If the same shared object is opened again with
@@ -276,7 +276,7 @@ The
argument is either the ID of an existing namespace
.\" FIXME: Is using dlinfo() RTLD_DI_LMID the right technique?
(which can be obtained using the
-.BR dlinfo (3)
+.MR dlinfo 3
.B RTLD_DI_LMID
request) or one of the following special values:
.TP
@@ -345,10 +345,10 @@ On success,
returns 0; on error, it returns a nonzero value.
.P
Errors from these functions can be diagnosed using
-.BR dlerror (3).
+.MR dlerror 3 .
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
-.BR attributes (7).
+.MR attributes 7 .
.TS
allbox;
lbx lb lb
@@ -489,7 +489,7 @@ then that routine is called just before the object is unloaded.
In this case, one must avoid linking against the system startup files,
which contain default versions of these files;
this can be done by using the
-.BR gcc (1)
+.MR gcc 1
.I \-nostartfiles
command-line option.
.P
@@ -515,7 +515,7 @@ permit multiple initialization and finalization functions to be defined.
.\"
.P
Since glibc 2.2.3,
-.BR atexit (3)
+.MR atexit 3
can be used to register an exit handler that is automatically
called when a shared object is unloaded.
.SS History
@@ -539,7 +539,7 @@ namespace other than the initial namespace.
.SH EXAMPLES
The program below loads the (glibc) math library,
looks up the address of the
-.BR cos (3)
+.MR cos 3
function, and prints the cosine of 2.0.
The following is an example of building and running the program:
.P
@@ -609,16 +609,16 @@ main(void)
.EE
.\" SRC END
.SH SEE ALSO
-.BR ld (1),
-.BR ldd (1),
-.BR pldd (1),
-.BR dl_iterate_phdr (3),
-.BR dladdr (3),
-.BR dlerror (3),
-.BR dlinfo (3),
-.BR dlsym (3),
-.BR rtld\-audit (7),
-.BR ld.so (8),
-.BR ldconfig (8)
+.MR ld 1 ,
+.MR ldd 1 ,
+.MR pldd 1 ,
+.MR dl_iterate_phdr 3 ,
+.MR dladdr 3 ,
+.MR dlerror 3 ,
+.MR dlinfo 3 ,
+.MR dlsym 3 ,
+.MR rtld\-audit 7 ,
+.MR ld.so 8 ,
+.MR ldconfig 8
.P
gcc info pages, ld info pages