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

dlerror(3C) dlerror(3C)

NAME

dlerror - get diagnostic information

SYNOPSIS

cc [ﬂag]... ﬁle...

-ldl [library]...

#include <dlfcn.h>

char *dlerror(void);

Multithread Usage

This routine is thread-safe.

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.

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.