1 .\" Copyright 1995 Yggdrasil Computing, Incorporated.
2 .\" and Copyright 2015 Michael Kerrisk (mtk.manpages@gmail.com).
4 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
5 .\" This is free documentation; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License as
7 .\" published by the Free Software Foundation; either version 2 of
8 .\" the License, or (at your option) any later version.
10 .\" The GNU General Public License's references to "object code"
11 .\" and "executables" are to be interpreted as the output of any
12 .\" document formatting or typesetting system, including
13 .\" intermediate and printed output.
15 .\" This manual is distributed in the hope that it will be useful,
16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 .\" GNU General Public License for more details.
20 .\" You should have received a copy of the GNU General Public
21 .\" License along with this manual; if not, see
22 .\" <http://www.gnu.org/licenses/>.
25 .TH DLERROR 3 2015-08-08 "Linux" "Linux Programmer's Manual"
27 dlerror \- obtain error diagnostic for functions in the dlopen API
31 .B "char *dlerror(void);"
33 Link with \fI\-ldl\fP.
37 function returns a human-readable string describing the most recent error
38 that occurred from a call to one of the functions in the dlopen API
39 since the last call to
41 The returned string does
43 include a trailing newline.
46 returns NULL if no errors have occurred since initialization or since
50 is present in glibc 2.0 and later.
52 For an explanation of the terms used in this section, see
58 Interface Attribute Value
61 T} Thread safety MT-Safe
66 The message returned by
68 may reside in a staticially allocated buffer that is
69 overwritten by subsequent
73 .\" The string returned by
75 .\" should not be modified.
76 .\" Some systems give the prototype as
79 .\" .B "const char *dlerror(void);"
82 This function is part of the dlopen API, derived from SunOS.