dlerror - obtain error diagnostic for functions in the dlopen API
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ dlerror() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
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.
Examples
See dlopen(3).
History
glibc 2.0. POSIX.1-2001.
SunOS.
Library
Dynamic linking library (libdl, -ldl)
Name
dlerror - obtain error diagnostic for functions in the dlopen API
Notes
The message returned by dlerror() may reside in a statically allocated buffer that is overwritten by
subsequent dlerror() calls.
See Also
dladdr(3), dlinfo(3), dlopen(3), dlsym(3) Linux man-pages 6.9.1 2024-05-02 dlerror(3)
Standards
POSIX.1-2008.
Synopsis
#include<dlfcn.h>char*dlerror(void);