HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

k
kmadmin(1M) kmadmin(1M)
NAME
kmadmin - kernel module administration
SYNOPSIS
/usr/sbin/kmadmin -d
directory_name |
-D
/usr/sbin/kmadmin -k
/usr/sbin/kmadmin -L
module_name ... | pathname ...
/usr/sbin/kmadmin -q
module_id ...
/usr/sbin/kmadmin -Q
module_name ...
/usr/sbin/kmadmin -s
| -S
/usr/sbin/kmadmin -u
module_id ...
/usr/sbin/kmadmin -U
module_name ...
DESCRIPTION
kmadmin is the administrative command for static and loadable kernel modules. It performs the following
functions:
• loads a kernel module into a running system
• unloads a kernel module from a running system
• displays the status of kernel module(s) currently loaded or registered
• modifies the search path for kernel modules
The loadable modules feature enables adding a module to a running system without rebooting the system
or rebuilding the kernel. When the module is no longer needed, this feature also allows the module to be
dynamically removed, thereby freeing system resources for other use.
Loadable modules are maintained in individual object files in the same manner as statically configured
modules. Unlike static modules, loadable modules:
• are not linked to the kernel until they are needed
• must be configured into the system and registered with the running kernel using the
config com-
mand, before they can be loaded
• must be configured in loadable form (requires writing additional module initialization or wrapper code)
• can be loaded and unloaded by using the
kmadmin command
• can be loaded by the kernel itself (called an auto load)
Auto-load occurs when the kernel detects a particular loadable module is required to accomplish some task,
but is not currently loaded. The kernel automatically loads the module.
Options
The kmadmin options have the following meanings:
-d pathname
Prepend the pathname to the current loadable modules search path, where pathname specifies
directories that should be searched:
for all subsequent demand loads initiated by a
kmadmin command with the option -L and
a named module_name,
for all subsequent loads performed by the kernel’s auto-load mechanism (see note below),
prior to searching any directories already prepended to the search path by a prior kmad-
min
command with the -d option, and
prior to searching the default search path /stand/dlkm/mod.d or
/stand/dlkm. current.vmunix/mod.d.
pathname must specify an absolute pathname or a list of absolute pathnames delimited by
colons. The directories identified by pathname do not have to exist on the system at the time the
request to modify the search path using kmadmin is made. If these directories do not exist at
the time a load takes place, the load operation ignores them.
All modifications to the search path made using this option take effect immediately and affect all
subsequent loads (demand and auto-load) and all users on the system.
Section 1M−−398 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005