1DLERROR(3)                 Linux Programmer's Manual                DLERROR(3)
2
3
4

NAME

6       dlerror - obtain error diagnostic for functions in the dlopen API
7

SYNOPSIS

9       #include <dlfcn.h>
10
11       char *dlerror(void);
12
13       Link with -ldl.
14

DESCRIPTION

16       The dlerror() function returns a human-readable, null-terminated string
17       describing the most recent error that occurred from a call  to  one  of
18       the  functions in the dlopen API since the last call to dlerror().  The
19       returned string does not include a trailing newline.
20
21       dlerror() returns NULL if no errors have occurred since  initialization
22       or since it was last called.
23

VERSIONS

25       dlerror() is present in glibc 2.0 and later.
26

ATTRIBUTES

28       For   an   explanation   of   the  terms  used  in  this  section,  see
29       attributes(7).
30
31       ┌──────────┬───────────────┬─────────┐
32       │Interface │ Attribute     │ Value   │
33       ├──────────┼───────────────┼─────────┤
34       │dlerror() │ Thread safety │ MT-Safe │
35       └──────────┴───────────────┴─────────┘

CONFORMING TO

37       POSIX.1-2001.
38

NOTES

40       The message returned by dlerror() may reside in a statically  allocated
41       buffer that is overwritten by subsequent dlerror() calls.
42
43   History
44       This function is part of the dlopen API, derived from SunOS.
45

EXAMPLE

47       See dlopen(3).
48

SEE ALSO

50       dladdr(3), dlinfo(3), dlopen(3), dlsym(3)
51

COLOPHON

53       This  page  is  part of release 4.15 of the Linux man-pages project.  A
54       description of the project, information about reporting bugs,  and  the
55       latest     version     of     this    page,    can    be    found    at
56       https://www.kernel.org/doc/man-pages/.
57
58
59
60Linux                             2017-09-15                        DLERROR(3)
Impressum