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

k
kcmodule(1M) kcmodule(1M)
NAME
kcmodule - manage kernel modules and subsystems
SYNOPSIS
kcmodule [-adhvBDKS][-c config][
-C comment][-P fields]
[module[
=[unused|static |loaded| auto|best|uninstall ]]]
DESCRIPTION
kcmodule is the administrative command for HP-UX kernel modules. It gives information about kernel
modules and their usage, and makes changes to their usage.
This command can work with any saved kernel configuration, or with the currently running kernel
configuration, depending on the use of the
-c flag (see below). By default, changes to the currently run-
ning kernel configuration are applied immediately. Some changes cannot be applied without a reboot; if
any such changes are requested, or the
-h
flag is given, all changes on the kcmodule command line will
be held until next boot.
Super-user permissions are required when making changes to module usage.
Options
-a Include all modules in the output listing. Normally only "interesting" modules are listed:
required modules and container (library) modules are omitted, as are multiple versions of
a module. Not valid in combination with -D or -S.
-B Forces a backup of the currently running configuration before making the requested
change. For more information on backup configurations, see kconfig(5). Not valid in
combination with -c.
-c config Tells kcmodule to view or change the saved kernel configuration named config. If this
option is not specified,
kcmodule views or changes the currently running kernel
configuration.
See kconfig(5) for more information on saved kernel configurations.
-C comment The specified comment will be included in the kernel configuration log file entry made for
this invocation of kcmodule. For more details on the kernel configuration log file, see
kclog(1M). Note that it will usually be necessary to quote the comment in order to avoid
interpretation by the shell.
-d Adds the description of each module to the output.
-D Restricts the output to only those modules that have a state change being held for next
reboot. kcmodule will return 1 if there are any such modules; see RETURN VALUE
below. Not valid in combination with -a, -c,or-S.
-h Changes will be held until next boot, even if they could be applied immediately. Not
valid in combination with -c.
-K Prevents a backup of the currently running configuration before making the requested
change. For more information on backup configurations, see kconfig(5). Not valid in
combination with -c.
-P fields Tells kcmodule to include only the specified fields in its output, and to print them in
the machine-readable form described in kconfig(5). See the Developers Note, below. Not
valid in combination with -d or -v.
-S Only modules in non-default states are included in the output. In other words, the listing
includes only optional modules that are in use by explicit request. It does not include
unused modules, required modules, or modules that were automatically selected to
resolve dependencies. Not valid in combination with -a or -D.
-v Print verbose information about each module. The information includes the name, ver-
sion and state of the module, its allowed states and its dependencies on other modules
and interfaces. Not valid in combination with -d or -P.
Section 1M−−344 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004