Manual Pages for UNIX Operating System command usage for man dlerror

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
     NULL.  Thus,  invoking  dlerror() a second time, immediately
     following  a  prior  invocation,  results  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. These facilities are available  to  dynamically-linked
     processes only. See Linker and Libraries Guide.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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().



SunOS 5.11           Last change: 1 Mar 2004                    1






Standard C Library Functions                          dlerror(3C)



     Application code should not write to this  buffer.  Programs
     wanting  to  preserve an error message should make their own
     copies of that message.




















































SunOS 5.11           Last change: 1 Mar 2004                    2