dlerror.3: Migrate dlerror(3) to a separate man page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 67 insertions, 1 deletions

diff --git a/man3/dlerror.3 b/man3/dlerror.3
index 15d096806f..0c312bd277 100644
--- a/man3/dlerror.3
+++ b/man3/dlerror.3
@@ -1 +1,67 @@
-.so man3/dlopen.3
+.\" Copyright 1995 Yggdrasil Computing, Incorporated.
+.\" and Copyright 2015 Michael Kerrisk (mtk.manpages@gmail.com).
+.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" The GNU General Public License's references to "object code"
+.\" and "executables" are to be interpreted as the output of any
+.\" document formatting or typesetting system, including
+.\" intermediate and printed output.
+.\"
+.\" This manual is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
+.\"
+.TH DLERROR 3 2015-07-16 "Linux" "Linux Programmer's Manual"
+.SH NAME
+dlerror \- obtain error diagnostic for functions in the dlopen API
+.SH SYNOPSIS
+.B #include <dlfcn.h>
+.sp
+.B "char *dlerror(void);"
+.sp
+Link with \fI\-ldl\fP.
+.SH DESCRIPTION
+The
+.BR dlerror ()
+function returns a human-readable string describing the most recent error
+that occurred from a call to one of the functions in the dlopen API
+since the last call to
+.BR dlerror ().
+It returns NULL if no errors have occurred since initialization or since
+it was last called.
+.SH VERSIONS
+.BR dlerror ()
+is present in glibc 2.0 and later.
+.SH CONFORMING TO
+POSIX.1-2001.
+.SH NOTES
+.\" .LP
+.\" The string returned by
+.\" .BR dlerror ()
+.\" should not be modified.
+.\" Some systems give the prototype as
+.\" .sp
+.\" .in +5
+.\" .B "const char *dlerror(void);"
+.\" .in
+.SS History
+This function is part of the dlopen API, derived from SunOS.
+.SH EXAMPLE
+See
+.BR dlopen (3).
+.SH SEE ALSO
+.BR dladdr (3),
+.BR dlinfo (3),
+.BR dlopen (3),
+.BR dlsym (3)