modload(2)							System Calls Manual							modload(2)

NAME

       modload - load kernel modules on demand

SYNOPSIS

DESCRIPTION

       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 privileged 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 module,
		     or the module references symbols not defined in the running kernel, or the module references symbols in another loadable mod-
		     ule 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 initialized.

SEE ALSO

       kcmodule(1M), modstat(2), moduload(2), privileges(5).

																	modload(2)