KLDUNLOAD(2)

✨ NAME ✨

Okay bestie, this is the KLDUNLOAD(2) manual page — it's for kldunload and kldunloadf, aka the calls that unload kld files. 💖

📚 LIBRARY 📚

Standard C Library (libc, -lc). Slay.

🧚 SYNOPSIS 🧚

#include <sys/linker.h>

int
kldunload(int fileid);

int
kldunloadf(int fileid, int flags);

💅 DESCRIPTION 💅

The kldunload() system call unloads a kld file from the kernel that was previously linked via kldload(2). No cap.

The kldunloadf() system call accepts an additional flags argument, which may be one of LINKER_UNLOAD_NORMAL, giving the same behavior as kldunload(), or LINKER_UNLOAD_FORCE, which causes the unload to ignore a failure to quiesce the module. Iconic behavior honestly. ✨

🫶 RETURN VALUES 🫶

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error. That's the vibe check. 💀

🚨 ERRORS 🚨

The file referred to by fileid is unloaded unless:

• [EPERM] — You do not have access to unlink the file from the kernel.
• [ENOENT] — The file was not found.
• [EBUSY] — You attempted to unload a file linked by the kernel.
• [EINVAL] — The kldunloadf() system call was passed invalid flags.

👀 SEE ALSO 👀

kldfind(2), kldfirstmod(2), kldload(2), kldnext(2), kldstat(2), kldsym(2), modfind(2), modfnext(2), modnext(2), modstat(2), kld(4), kldunload(8).

🌸 HISTORY 🌸

The kld interface first appeared in FreeBSD 3.0. Periodt.

---

Bye bestie — this KLDUNLOAD(2) page is from Debian, dated December 25, 2008. 💜🦋