NAME¶

kldunload, kldunloadf — unload kld files

LIBRARY¶

Standard C Library (libc, -lc)

SYNOPSIS¶

#include <sys/param.h>
#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).

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.

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.

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.