HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
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 charac-
ter string (with no trailing newline) that describes the last error that occurred during dynamic linking pro-
cessing. 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
dler-
ror
. 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)
HP-UX Release 11i: December 2000 − 1 − Section 3−−149
___
___