Standard C Library Functions                          dlerror(3C)



NAME
     dlerror - get diagnostic information

SYNOPSIS
     #include 

     char *dlerror(void);


DESCRIPTION
     The dlerror() function returns a  null-terminated  character
     string  that  describes  the last error that occurred during
     dynamic linking processing. The returned string contains  no
     trailing newline. If no dynamic linking errors have occurred
     since the last invocation of  dlerror(),  dlerror()  returns
     NUL.  Thus,  invoking  dlerror() a second time, immediately
     following  a  prior  invocation,  results  in   NUL   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. These facilities are available  to  dynamically-linked
     processes only. See Linker and Libraries Guide.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


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


     Linker and Libraries Guide

NOTES
     The messages returned by  dlerror() can reside in  a  static
     buffer that is overwritten on each call to dlerror(). Appli-
     cation code should not write to this buffer. Programs  want-
     ing  to  preserve  an  error  message  should make their own



SunOS 5.11           Last change: 1 Mar 2004                    1






Standard C Library Functions                          dlerror(3C)



     copies of that message.






















































SunOS 5.11           Last change: 1 Mar 2004                    2