NAME    [Toc]    [Back]

       dlerror - get diagnostic information

SYNOPSIS    [Toc]    [Back]

       #include <dlfcn.h>

       char *dlerror(void );

DESCRIPTION    [Toc]    [Back]

       The dlerror() function returns a null-terminated character
       string (with no trailing newline) that describes the  last
       error  that  occurred  in dynamic linking processing for a
       call to dlopen(), dlclose(), or dlsym().   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.

ERRORS    [Toc]    [Back]

       No errors are defined.

RETURN VALUE    [Toc]    [Back]

       If successful, dlerror() returns a null-terminated character
 string. Otherwise, NULL is returned.

APPLICATION USAGE    [Toc]    [Back]

       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. Depending on the application environment
 with respect  to  asynchronous  execution  events,
       such  as signals or other asynchronous computation sharing
       the address space,  portable  applications  should  use  a
       critical section to retrieve the error pointer and buffer.

SEE ALSO    [Toc]    [Back]

       dlclose(3), dlopen(3), dlsym(3)



                                                       dlerror(3)