moduload(2)moduload(2)NAMEmoduload - unload a kernel module on demand
SYNOPSISDESCRIPTION
allows processes with appropriate privilege to demand unload one or all
unloadable modules from the running kernel. A module is considered
unloadable if it is not currently in use, if no module depending on it
is currently loaded, and if the module is not being loaded or unloaded
from the kernel. If module_id is set to 0 (zero), attempts to unload
all unloadable modules, otherwise attempts to unload the module speci‐
fied by module_id.
Notes
is currently implemented as a macro.
Security Restrictions
is restricted to superuser processes or privileged processes. A privi‐
leged process requires the privilege to execute the system call.
See privileges(5), for more information about the privilege.
RETURN VALUE
On success, returns 0, otherwise it returns -1 and sets to indicate the
error.
ERRORS
fails if one or more of the following are true:
module_id does not correspond to any valid currently loaded
kernel module.
The caller is not a superuser process or a privileged process.
There are outstanding references to the module, or modules that
depend
on this module are currently loaded, or profiling
is enabled, or the module is in the process of
being loaded or unloaded from the kernel.
The Dynamically Loadable Kernel Module feature is not initial‐
ized.
SEE ALSOkcmodule(1M), modload(2), privileges(5).
moduload(2)