HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

k
kcmodule(1M) kcmodule(1M)
NAME
kcmodule - manage kernel modules and subsystems
SYNOPSIS
kcmodule [-adhvDS][-b behavior][
-c config][-C comment][-P fields]
[module[
=[unused|static|loaded|auto|best]]] ...
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.
Only users with appropriate privileges can make changes to module usage.
Options
-a Include all modules in the output listing. Normally only "interesting" modules are listed:
required modules and multiple versions of modules are omitted. Not valid in combination
with -D or -S.
-b behavior Specifies whether or not to update the automatic backup configuration before the requested
change. Also specifies the default backup behavior for future changes. See kconfig(5) for a
description of the various backup behaviors. Not valid in combination with
-c.
For compatibility with old releases,
-B is accepted as an alias for -b yes, and -K is
accepted as an alias for
-b no. These aliases will be removed in a future release.
-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.
-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, version
and state of the module, its allowed states and its dependencies on other modules and inter-
faces. Not valid in combination with
-d or -P.
Arguments
The arguments to kcmodule may be any mixture of module state queries and assignments. The argu-
ments must each take one of the forms listed below. No spaces are permitted within each argument. If no
arguments are given, kcmodule performs a query on all modules (subject to the constraints of the -a,
-D,or-S flags).
386 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007