dlerror(3C)

NAME
     dlerror - get diagnostic information

SYNOPSIS
     cc [flag ...] file ...  -lc [library ...]

     #include <dlfcn.h>

     char *dlerror(void);

DESCRIPTION
     dlerror returns a null-terminated character string (with no trailing
     newline) that describes the last error that occurred during dynamic
     linking processing. If no dynamic linking errors have occurred since the
     last invocation of dlerror, dlerror returns NULL.  Thus, invoking dlerror
     a second time, immediately following a prior invocation, results in NULL
     being returned.

SEE ALSO
     dlerror(3), dlopen(3), sgidladd(3), sgidlopen_version(3), dlsym(3).

NOTES
     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.

     The string pointed to by the return value must not be free(3)d.

     The dlerror string space is not thread-safe (whether sproc(2) threads
     with shared data or POSIX-pthreads or some other shared-data thread
     code):  multiple threads doing dynamic linking calls can step on each
     others dlerror strings.