dlerror(3X)                                                     dlerror(3X)

NAME
     dlerror - get diagnostic information

SYNOPSIS
     cc [flag ...] file ... -ldl [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, invok-
     ing dlerror() a second time, immediately following a prior invocation,
     will result in NULL being returned.

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.

SEE ALSO
     dlclose(3X), dlopen(3X), dlsym(3X).





























Page 1                       Reliant UNIX 5.44                Printed 11/98