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 character 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 message should make their own
copies of that message.
SEE ALSO
dlclose(3C),
dlopen(3C),
dlsym(3C).
Texts and Tutorials:
- 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)
Printable version
