DLERROR(3C)							   DLERROR(3C)

NAME    [Toc]    [Back]

     dlerror - get diagnostic information

SYNOPSIS    [Toc]    [Back]

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

     #include <dlfcn.h>

     char *dlerror(void);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111