dlerror(3)

✨ dlerror — bestie edition ✨

okay so you know the dlopen API?? the whole dynamic-linking girlboss situation with libdl / -ldl?? yeah. dlerror is the one who tells you what went wrong. she's the friend who actually reads the group chat and explains the drama. 💅

🦋 SYNOPSIS

#include <dlfcn.h>

char *dlerror(void);

🌸 DESCRIPTION

dlerror() hands you back a human-readable, null-terminated string that describes the most recent error that happened in a call to one of the functions in the dlopen API — counting only stuff that went down since the last time dlerror() was called. so like, she's got amnesia on purpose bestie, it's a feature.

the returned string does not include a trailing newline. no extra \n, she's not doing that to you. 🙈

if no errors have occurred since initialization, or since the last time she was called, dlerror() returns NULL. that NULL is the slay. that NULL is the ✅. if you get a string, something fumbled.

👑 ATTRIBUTES

for the whole explanation of what these words even mean, go peek at attributes(7). ✨

• Interface: dlerror()
• Attribute: Thread safety
• Value: MT-Safe

so yes bestie, she's MT-Safe — you can call her from multiple threads and she will not start drama. iconic behaviour only.

📜 STANDARDS

POSIX.1-2008.

🕰️ HISTORY

• glibc 2.0.
• POSIX.1-2001.

also: SunOS. yes she's been around, she's a legacy legend, giving vintage main character energy. 💜

💀 NOTES

the message dlerror() gives you may live in a statically allocated buffer that gets overwritten by subsequent dlerror() calls. so if you need to keep that string around, copy it immediately, because the next call can and will step on it. no cap. this is the one that bites people fr fr. 😭

🌈 EXAMPLES

see dlopen(3). she's showing off over there. 🫶

🔥 SEE ALSO

• dladdr(3)
• dlinfo(3)
• dlopen(3)
• dlsym(3)

---

and that's the whole page bestie!! 💖 this came to you from Linux man-pages 6.20, dated 2026-02-08, so if anybody asks where you got your info, that's the receipt. now go check your error string and copy it before something overwrites it, i'm begging you. 🎀🦋🌸⭐🧚💜