Add man page for dlvsym(3)

Add a short description of the function to the appropriate man page and add
reference to it where it makes sense.

Reviewed by:	bcr, markj, 0mp
Approved by:	markj
Differential Revision:	https://reviews.freebsd.org/D18725
This commit is contained in:
Romain Tartière 2019-01-03 21:31:17 +00:00
parent 6564182252
commit 2f1a2bdf81
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=342743
2 changed files with 24 additions and 4 deletions

View File

@ -339,7 +339,8 @@ MLINKS+=dlopen.3 fdlopen.3 \
dlopen.3 dlclose.3 \
dlopen.3 dlerror.3 \
dlopen.3 dlfunc.3 \
dlopen.3 dlsym.3
dlopen.3 dlsym.3 \
dlopen.3 dlvsym.3
MLINKS+=err.3 err_set_exit.3 \
err.3 err_set_file.3 \
err.3 errc.3 \

View File

@ -32,13 +32,14 @@
.\" @(#) dlopen.3 1.6 90/01/31 SMI
.\" $FreeBSD$
.\"
.Dd July 7, 2017
.Dd January 2, 2019
.Dt DLOPEN 3
.Os
.Sh NAME
.Nm dlopen ,
.Nm fdlopen ,
.Nm dlsym ,
.Nm dlvsym ,
.Nm dlfunc ,
.Nm dlerror ,
.Nm dlclose
@ -53,6 +54,8 @@
.Fn fdlopen "int fd" "int mode"
.Ft void *
.Fn dlsym "void * restrict handle" "const char * restrict symbol"
.Ft void *
.Fn dlvsym "void * restrict handle" "const char * restrict symbol" "const char * restrict version"
.Ft dlfunc_t
.Fn dlfunc "void * restrict handle" "const char * restrict symbol"
.Ft char *
@ -74,7 +77,8 @@ provides access to the shared object in
.Fa path ,
returning a descriptor that can be used for later
references to the object in calls to
.Fn dlsym
.Fn dlsym ,
.Fn dlvsym
and
.Fn dlclose .
If
@ -300,6 +304,16 @@ condition which may be queried with
.Fn dlerror .
.Pp
The
.Fn dlvsym
function behaves like
.Fn dlsym ,
but takes an extra argument
.Fa version :
a null-terminated character string which is used to request a specific version
of
.Fa symbol .
.Pp
The
.Fn dlfunc
function
implements all of the behavior of
@ -328,6 +342,7 @@ occurred during a call to
.Fn dladdr ,
.Fn dlinfo ,
.Fn dlsym ,
.Fn dlvsym ,
.Fn dlfunc ,
or
.Fn dlclose .
@ -375,7 +390,10 @@ using the
option to
.Xr ld 1
for symbols defined in the executable to become visible to
.Fn dlsym .
.Fn dlsym ,
.Fn dlvsym
or
.Fn dlfunc
.Pp
Other ELF platforms require linking with
.Lb libdl
@ -397,6 +415,7 @@ The
.Fn dlopen ,
.Fn fdlopen ,
.Fn dlsym ,
.Fn dlvsym ,
and
.Fn dlfunc
functions