From 2f1a2bdf8182c58c7ee4e4a0b2d61edc4aebc6bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Romain=20Tarti=C3=A8re?= <romain@FreeBSD.org>
Date: Thu, 3 Jan 2019 21:31:17 +0000
Subject: [PATCH] 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
---
 lib/libc/gen/Makefile.inc |  3 ++-
 lib/libc/gen/dlopen.3     | 25 ++++++++++++++++++++++---
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/lib/libc/gen/Makefile.inc b/lib/libc/gen/Makefile.inc
index ef8f9cba8e8..4e30df5aaab 100644
--- a/lib/libc/gen/Makefile.inc
+++ b/lib/libc/gen/Makefile.inc
@@ -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 \
diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index 202f1af4864..169a657b395 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -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