Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

dlerror()

Get dynamic loading diagnostic information

Synopsis:

#include <dlfcn.h>

char *dlerror( void );

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The dlerror() function returns a NULL-terminated string (with no trailing newline) describing the last error that occurred during a call to one of the dl*() functions. If no errors have occurred, dlerror() returns NULL.


Note: The dlopen() function is available only to dynamically linked processes.

Returns:

A pointer to an error description, or NULL.

Classification:

POSIX 1003.1 XSI

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

See also:

dladdr(), dlclose(), dlopen(), dlsym()