kmmodreg - register or unregister loadable kernel modules with the
/usr/sbin/kmmodreg [[-M module_name]...] [-r mod_register_root]
/usr/sbin/kmmodreg [[-U module_name]...] [-r mod_register_root]
kmmodreg registers all of the loadable kernel modules listed in the
mod_register file located under either /stand/dlkm.current_vmunix/
when the running kernel is current_vmunix, or /stand/dlkm when the
running kernel is /stand/vmunix. All loadable kernel modules need to
be registered by kmmodreg before they can be automatically-loaded by
the running kernel (i.e., upon module access by an application or user
process), or demand-loaded by an administrator issuing the kmadmin
The mod_register file is generated whenever config is run to create a
new kernel and contains the registration information for any (and all)
configured loadable modules. When config -M is run to configure a
loadable kernel module, the entries for the module are appended to
the mod_register. The mod_register file is not expected to be edited
manually. An individual module's registration information is also
created by config and stored in the mod_reg file located under
kmmodreg takes the following options:
Use to specify a directory other than /stand/dlkm.current_vmunix
or /stand/dlkm/ as the location for the mod_register file that is
used to register modules.
Use the individual module registration information under the
mod_reg_root directory instead of /stand/dlkm/mod_bld.d.
-M module_name [module_name]
Register the specified loadable kernel module, and append an
entry (or entries) for the module(s) to the mod_register file.
This will effect registration of the specified module(s) at every
Unregister the specified loadable kernel module, and remove an
entry (or entries) for the module from the mod_register file, so
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
it will not be registered every time the system is rebooted.
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 as a user-level command to register all of the loadable kernel
The mod_register file format may change or be eliminated in the
Default mod_register_root directory
Default mod_register file
Module registration information
Each mod_register file entry provides registration information about a
single module. The information is contained in a single-line entry.
All fields are positional and are separated by colons. The subfields
are separated by commas. The entry is of the form:
+ module-name identifies the module to which the entry belongs
+ module-type contains an integer representing the module type
+ type-specific-data includes additional information that depends on
the type of the module
An exit value of zero indicates successful completion of the command.
If errors occur, kmmodreg reports error messages for each error and
exits with the return value 1. If the error is a failure to register
a module, an error message is reported, but the command continues
processing the remaining modules listed in the mod_register file. If
no modules are processed, kmmodreg returns a value of 2.
config(1M), kmadmin(1M), kmupdate(1M).
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000