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 from 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, will result in NULL being
  returned.

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

ERRORS
  No errors are defined.

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.

RELATED INFORMATION
  dlclose(3), dlopen(3), dlsym(3).

Index for Section 3

Alphabetical listing for D

Top of page