Manpages - dlerror.3
Table of Contents
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.13 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/.