dlerror(3)dlerror(3)NAMEdlerror - get diagnostic information
SYNOPSIS
#include <dlfcn.h>
char *dlerror(void );
DESCRIPTION
The dlerror() function returns a null-terminated character string (with
no trailing newline) that describes the last error that occurred in
dynamic linking processing for a call to dlopen(), dlclose(), or
dlsym(). If no dynamic linking errors have occurred since the last
invocation of dlerror(), dlerror() returns NULL. Thus, invoking dler‐
ror() a second time, immediately following a prior invocation, results
in NULL being returned.
ERRORS
No errors are defined.
RETURN VALUE
If successful, dlerror() returns a null-terminated character string.
Otherwise, NULL is returned.
APPLICATION USAGE
The messages returned by dlerror() may reside in a static buffer that
is overwritten on each call to dlerror(). Application code should not
write to this buffer. Programs wishing to preserve an error message
should make their own copies of that message. Depending on the applica‐
tion environment with respect to asynchronous execution events, such as
signals or other asynchronous computation sharing the address space,
portable applications should use a critical section to retrieve the
error pointer and buffer.
SEE ALSOdlclose(3), dlopen(3), dlsym(3)dlerror(3)