dlerror.3c (2010 09)

d
dlerror(3C) dlerror(3C)
NAME
dlerror - get diagnostic information
SYNOPSIS
cc [flag ... ] file ...
-ldl [library ] ...
#include <dlfcn.h>
char *dlerror(void);
DESCRIPTION
dlopen is one of a family of routines that give the user direct access to the dynamic linking facilities
(using the -ldl option on the compiler or
ld command line). dlerror returns a null-terminated char-
acter string (with no trailing newline) that describes the last error that occurred during dynamic linking
processing. If no dynamic linking errors have occurred since the last invocation of
dlerror, dlerror
returns NULL. Thus, invoking dlerrora second time, immediately following a prior invocation, results
in NULL being returned.
MULTITHREAD USAGE
This routine is thread-safe.
WARNINGS
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 mes-
sage should make their own copies of that message.
SEE ALSO
dlclose(3C), dlopen(3C), dlsym(3C).
Texts and Tutorial s:
HP-UX Linker and Libraries Online User Guide
(See the
+help option)
HP-UX Linker and Libraries User’s Guide
(See manuals (5) for ordering information)
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1