NAME
kmmodreg — register or unregister loadable kernel modules with the running kernel
SYNOPSIS
/usr/sbin/kmmodreg
/usr/sbin/kmmodreg
-M
module_name[[
-M
module_name]...]
/usr/sbin/kmmodreg
-U
module_name[[
-U
module_name]...]
[-{a|n
}]
DESCRIPTION
kmmodreg
without any arguments
registers with the running kernel all modules that
have been configured as dynamically loadable modules [ see
config(1M)],
but have not yet
been registered with the running kernel.
All newly configured loadable kernel modules must first
be moved into place and registered by the
kmupdate(1M)
command (which in turns calls
kmmodreg)
before they can be loaded by the running kernel.
After the initial registration, the
kmmodreg
command options can be used to unregister and re-register a specified
kernel module, as well as
to schedule and unschedule asynchronous
unregistration (upon system reboot) of a specified kernel module.
Options
kmmodreg
takes the following options:
- -M module_name
Register the specified loadable kernel module with the currently running kernel.
This prepares the module to be loaded with the running kernel either
by demand via the
kmadmin(1M)
command, or by the DLKM auto load mechanism, if supported by the module
type. This will effect registration of the specified module whenever the
current kernel is rebooted.
- -U module_name
Unregister the specified loadable kernel module from the currently
running kernel. The unregistration will fail if the module is currently
loaded and cannot be successfully unloaded.
- -a
Schedule the asynchronous unregistration of a kernel module. This option
is only supported in conjunction with the
-U
module_name
option. It is used to schedule the unregistration of
the specified registered module to occur at the next system shutdown
(asynchronous unregistration).
- -n
Unschedule the asynchronous unregistration of a kernel module. This option
is only supported in conjunction with the
-U
module_name
option. It is used to unschedule the previously scheduled asynchronous
unregistration of the specified module.
NOTES
The
kmmodreg
command is executed automatically at every system reboot.
kmupdate
also calls
kmmodreg,
with the
-M
option, when a loadable kernel module configuration is requested.
kmmodreg
can also be invoked directly to register all the dynamically loadable
kernel modules.
WARNINGS
The module registration format and location is internal to the kernel
configuration commands, and should not be modified manually.
RETURN VALUE
An exit value of zero indicates successful completion of the command.
If the error is a failure to process a specific module registration or
unregistration request, an error message is reported,
but the command continues processing the remaining modules in the request.
Upon partial success,
kmmodreg
returns a value of 1.
If no modules are successfully processed,
kmmodreg
returns a value of 2.
Printable version
