1.Dd April 17, 2006
2.Dt DLERROR 3
3.Sh NAME
4.Nm dlerror
5.Nd get diagnostic information
6.Sh SYNOPSIS
7.In dlfcn.h
8.Ft const char*
9.Fn dlerror "void"
10.Sh DESCRIPTION
11.Fn dlerror
12returns a null-terminated character string describing the last error that
13occurred on this thread during a call to
14.Fn dlopen ,
15.Fn dlopen_preflight ,
16.Fn dlsym ,
17or
18.Fn dlclose .
19If no such error has occurred,
20.Fn dlerror
21returns a null pointer.
22At each call to
23.Fn dlerror ,
24the error indication is reset.  Thus in the case of two calls
25to
26.Fn dlerror ,
27where the second call follows the first immediately, the second call
28will always return a null pointer.
29.Sh SEE ALSO
30.Xr dlopen 3
31.Xr dlopen_preflight 3
32.Xr dlclose 3
33.Xr dlsym 3
34.Xr dyld 3
35