modload(2)modload(2)NAMEmodload - load kernel modules on demand
SYNOPSISDESCRIPTION
allows processes with appropriate privilege to demand-load a kernel
module into the running kernel. The module must be of a supported type
and must have been registered via kcmodule(1M) before it can be loaded.
The module to be loaded is specified by pathname. pathname may be
either a module name or an absolute path name. If pathname is a module
name, a list of directories specified by modpath is searched for a
match. If pathname is absolute, only pathname is used to access the
object file. The file must be an ELF64 relocatable object file.
Notes
is currently implemented as a macro.
Security Restrictions
is restricted to superuser processes and privileged processes. A priv‐
ileged process requires the privilege to execute the system call.
See privileges(5), for more information about the privilege.
RETURN VALUE
On successful completion, returns a module identifier that can be
passed to or On failure it returns -1 and sets to identify the error.
ERRORS
fails if one or more of the following are true:
A component of pathname denies search permission.
The file named by
pathname does not exist.
The module being loaded is not currently registered.
The file named by
pathname is not appropriately pre-configured or has
invalid dependency on other modules.
The caller is not a superuser process or a privileged process.
A relocation error occurred during the attempt to load the mod‐
ule,
or the module references symbols not defined in the run‐
ning kernel, or the module references symbols in another
loadable module but it did not declare its dependence on
this module in its module metadata.
pathname
is more than characters long.
The module wrapper has an incorrect version number.
The Dynamically Loadable Kernel Module feature is not initial‐
ized.
SEE ALSOkcmodule(1M), modstat(2), moduload(2), privileges(5).
modload(2)