dlerror(3X)         (C Programming Language Utilities)          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, invoking
         dlerror a second time, immediately following a prior invocation, will
         result in NULL being returned.

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

   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.



























   7/91                                                                 Page 1