Index for Section 3

Alphabetical listing for D

Bottom of page

dlerror(3)
NAME
  dlerror - get diagnostic information

SYNOPSIS
  #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 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
  No errors are defined.

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

APPLICATION USAGE
  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
  dlclose(3), dlopen(3), dlsym(3)

Index for Section 3

Alphabetical listing for D

Top of page