dlerror(3)

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 at‐
29       tributes(7).
30
31       ┌────────────────────────────────────────────┬───────────────┬─────────┐
32       │Interface                                   │ Attribute     │ Value   │
33       ├────────────────────────────────────────────┼───────────────┼─────────┤
34       │dlerror()                                   │ Thread safety │ MT-Safe │
35       └────────────────────────────────────────────┴───────────────┴─────────┘
36

CONFORMING TO

38       POSIX.1-2001.
39

NOTES

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

EXAMPLES

48       See dlopen(3).
49

COLOPHON

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