dlerror(3X)      MISCELLANEOUS LIBRARY FUNCTIONS      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.  Appli-
     cation code should not write to this buffer.  Programs wish-
     ing  to  preserve  an  error  message  should make their own
     copies of that message.



























          Last change: C Programming Language Utilities         1