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.