DLERROR
Section: Linux Programmer's Manual (3)
Updated: 2020-06-09
Page Index
NAME
dlerror - obtain error diagnostic for functions in the dlopen API
SYNOPSIS
#include <dlfcn.h>
char *dlerror(void);
Link with -ldl.
DESCRIPTION
The
dlerror()
function returns a human-readable,
null-terminated 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
dlerror().
The returned string does
not
include a trailing newline.
dlerror()
returns NULL if no errors have occurred since initialization or since
it was last called.
VERSIONS
dlerror()
is present in glibc 2.0 and later.
ATTRIBUTES
For an explanation of the terms used in this section, see
attributes(7).
| Interface | Attribute | Value
|
|
dlerror()
| Thread safety | MT-Safe
|
CONFORMING TO
POSIX.1-2001.
NOTES
The message returned by
dlerror()
may reside in a statically allocated buffer that is
overwritten by subsequent
dlerror()
calls.
History
This function is part of the dlopen API, derived from SunOS.
EXAMPLES
See
dlopen(3).
SEE ALSO
dladdr(3),
dlinfo(3),
dlopen(3),
dlsym(3)
COLOPHON
This page is part of release 5.10 of the Linux
man-pages
project.
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
https://www.kernel.org/doc/man-pages/.