modload(2) [hpux man page]
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)
Check Out this Related Man Page
modload(1M) System Administration Commands modload(1M) NAME
modload - load a kernel module SYNOPSIS
modload [-p] [-e exec_file] filename DESCRIPTION
The modload command loads the loadable module filename into the running system. filename is an object file produced by ld -r. If filename is an absolute pathname then the file specified by that absolute path is loaded. If filename does not begin with a slash (/), then the path to load filename is relative to the current directory unless the -p option is specified. The kernel's modpath variable can be set using the /etc/system file. The default value of the kernel's modpath variable is set to the path where the operating system was loaded. Typically this is /kernel /usr/kernel. For example, the following command looks for ./drv/foo: example# modload drv/foo The following command looks for /kernel/drv/foo and then /usr/kernel/drv/foo: example# modload -p drv/foo OPTIONS
The following options are supported: -e exec_file Specify the name of a shell script or executable image file that is executed after the module is successfully loaded. The first argument passed is the module ID (in decimal). The other argument is module specific. The module specific information is: the block and character major numbers for drivers, the system call number for system calls, or, for other module types, the index into the appropriate kernel table. See modinfo(1M) -p Use the kernel's internal modpath variable as the search path for the module. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ SEE ALSO
ld(1), add_drv(1M), kernel(1M), modinfo(1M), modunload(1M), system(4), attributes(5), modldrv(9S), modlinkage(9S), modlstrmod(9S), mod- ule_info(9S) Writing Device Drivers NOTES
Use add_drv(1M) to add device drivers, not modload. See Writing Device Drivers for procedures on adding device drivers. SunOS 5.10 1 Dec 1993 modload(1M)