HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

modload(2) modload(2)

NAME

modload - load kernel modules on demand

SYNOPSIS

#include <sys/mod.h>

int modload(char *

pathname);

DESCRIPTION

modload 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 conﬁg(1M) or

kmmodreg(1M) before it can be loaded.

The module to be loaded is speciﬁed by pathname. pathname may be either a module name or an absolute

pathname. If pathname is a module name, a list of directories speciﬁed by modpath is searched for a match.

If pathname is absolute, only pathname is used to access the object ﬁle. The ﬁle must be an ELF64 relocat-

able object ﬁle.

NOTES

modload is currently implemented as a macro.

RETURN VALUE

On successful completion, modload returns a module identiﬁer that can be passed to moduload or

modstat. On failure it returns -1 and sets errno to identify the error.

ERRORS

modload fails if one or more of the following are true:

[EACCES] A component of pathname denies search permission.

[ENOENT] The ﬁle named by pathname does not exist.

[ENOREG] Module being loaded is not currently registered.

[EINVAL] The ﬁle named by pathname is not appropriately pre-conﬁgured or has invalid

dependency on other modules.

[EPERM] The calling process does not have appropriate privilege.

[ERELOC] A relocation error occurred during the attempt to load the module, or the module

references symbols not deﬁned in the running kernel, or the module references sym-

bols in another loadable module but it did not declare its dependence on this module

in its master(4) ﬁle.

[ENAMETOOLONG] pathname is more than

MAXPATHLEN characters long.

[EBADVER] The module wrapper has an incorrect version number.

[ENOSYS] The Dynamically Loadable Kernel Module feature is not initialized.