Dynamic Linking Library Functions                    dlerror(3DL)

NAME
     dlerror - get diagnostic information

SYNOPSIS
     cc [ flag ... ] file ... -ldl [ library ... ]
     #include <dlfcn.h>

     char *dlerror(void);

DESCRIPTION
     The dlerror() function 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 invoca-
     tion of dlerror(), dlerror() returns  NULL.  Thus,  invoking
     dlerror() a second time, immediately following a prior invo-
     cation, will result in NULL being returned.

USAGE
     The dlerror() function is one of a family of functions  that
     give  the  user direct access to the dynamic linking facili-
     ties (see Linker and Libraries Guide) and are  available  to
     dynamically-linked processes only.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO
     ld(1), dladdr(3DL), dlclose(3DL), dldump(3DL),  dlopen(3DL),
     dlsym(3DL), attributes(5)

     Linker and Libraries Guide

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.

SunOS 5.8           Last change: 31 Dec 1996                    1