kcmodule.1m (2010 09)

k
kcmodule(1M) kcmodule(1M)
next_cause This field indicates how the module was given its state for next boot. It has
the same values as cause, above. This field is present only if
-c is not
specified.
before_state The state of the module before the current change. This field is present only
for modules for which an immediate value change has been made during the
current invocation of
kcmodule.
before_cause The cause of the module state before the current change. This field is present
only for modules for which an immediate value change has been made during
the current invocation of
kcmodule.
capable This field will contain a space-separated list of the states that this module can
support. The states are listed in the table under Arguments, above.
depend This field will produce a line in the output for each dependency this module
has on another module or interface. (There may be zero such lines.) Each line
has the form:
depend type name:version
where type is either
interface or module
, indicating the type of object;
name is the name of the interface or module; and version is the version
number of the interface or module on which this module depends.
exports This field will produce a line in the output for each interface exported by this
module. (There may be zero such lines.) Each line will contain the
interfacename
:interfaceversion of an interface exported by this module.
The special field name
ALL may be specified to indicate that all defined fields should be included in the
output. The output may include fields not listed in this man page. The fields will be listed in unspecified
order.
Additional fields may be added in future releases or patches.
Default Output
When kcmodule is called with no options, it shows the optional kernel modules on the system, their
current state, the cause for including it in the configuration and special capabilities if any. If there are
changes that are being held for nextboot, they will be shown as well. The cause field will be empty for all
modules that are not included in the configuration. The special capabilities of kernel modules would be
one of:
loadable The module can be dynamically changed to the state loaded.
unloadable The module can be dynamically changed to the state unused.
auto-loadable The module supports the state
auto.
The layout and content of the default output may change in future releases or patches of HP-UX. Scripts
or applications which need to parse the output of
kcmodule must use the -P option to get output that
can be parsed.
RETURN VALUE
kcmodule returns one of the following values:
0
kcmodule was successful. If -D was specified, this return value indicates that there are no
module state changes being held for next boot.
1
kcmodule was successful. However, there were changes requested to the currently running sys-
tem which cannot be applied until the system reboots. Therefore, all of the requested changes are
being held until next boot.
If
-D was specified, this return value indicates that there are module state changes being held for
next boot.
2
kcmodule was not successful.
EXAMPLES
To see all optional modules and their current states:
$ kcmodule
HP-UX 11i Version 3: September 2010 − 3 − Hewlett-Packard Company 3