1dlerror(3C)              Standard C Library Functions              dlerror(3C)
2
3
4

NAME

6       dlerror - get diagnostic information
7

SYNOPSIS

9       #include <dlfcn.h>
10
11       char *dlerror(void);
12
13

DESCRIPTION

15       The  dlerror() function returns a null-terminated character string that
16       describes the last error that occurred during dynamic linking  process‐
17       ing.  The  returned  string contains no trailing newline. If no dynamic
18       linking errors have occurred since the last  invocation  of  dlerror(),
19       dlerror()  returns NULL. Thus, invoking  dlerror() a second time, imme‐
20       diately following a prior invocation, results in NULL being returned.
21

USAGE

23       The dlerror() function is one of a family of functions  that  give  the
24       user  direct access to the dynamic linking facilities. These facilities
25       are available to dynamically-linked  processes  only.  See  Linker  and
26       Libraries Guide.
27

ATTRIBUTES

29       See attributes(5) for descriptions of the following attributes:
30
31
32
33
34       ┌─────────────────────────────┬─────────────────────────────┐
35       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
36       ├─────────────────────────────┼─────────────────────────────┤
37       │Interface Stability          │Standard                     │
38       ├─────────────────────────────┼─────────────────────────────┤
39       │MT-Level                     │MT-Safe                      │
40       └─────────────────────────────┴─────────────────────────────┘
41

SEE ALSO

43       ld(1),  dladdr(3C),  dlclose(3C),  dldump(3C),  dlopen(3C),  dlsym(3C),
44       attributes(5), standards(5)
45
46
47       Linker and Libraries Guide
48

NOTES

50       The messages returned by  dlerror() can reside in a static buffer  that
51       is  overwritten  on each call to dlerror(). Application code should not
52       write to this buffer. Programs wanting to  preserve  an  error  message
53       should make their own copies of that message.
54
55
56
57SunOS 5.11                        1 Mar 2004                       dlerror(3C)
Impressum