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

k
kmsystem(1M) kmsystem(1M)
NAME
kmsystem - set, query configuration and loadable flags for a module
SYNOPSIS
/usr/sbin/kmsystem
[-S system_file]
/usr/sbin/kmsystem
[-c {Y|y|
N|n}] [-l {Y|y|N|n}] [-q
][-S system_file] module_name
DESCRIPTION
Without any option or with the
-S option only,
kmsystem prints the information on the $LOADABLE and
$CONFIGURATION
flags of all modules. The -q option may be used to print information about the
specified module only. The
$CONFIGURATION
flag for module_name is set using the
-c option, and the
$LOADABLE flag is set with the -l
flag. When module_name is specified on the command line, one or
more of the
-c, -l,or
-q flags must also be specified.
Options
-c value Set the configuration status of module_nameto value. value must be
Y or y to configure the
module, or
N or n to not configure it.
If the system file for the module (/stand/system.d/
module_name) exists but does not con-
tain the
$CONFIGURE flag, then an error message is printed. Otherwise, the flag is set to
value.
If the system file for the module does not exist, then the standard system file (see
-S option) is
searched. module_name is added or removed from that system file according to value.
-l value Set the $LOADABLE flag in the system file of module_name to value. value must be
Y or y to
make the module loadable, or
N or n to specify that it should be statically linked. If the system
file for the module does not exist, kmsystem exits with an error. If the system file exists, but
the $LOADABLE flag is not present in the file, then the module is a static module, and
kmsys-
tem
exits with an error.
-q Print the loadable and configuration flag information for module_name. If the loadable informa-
tion does not apply, then a
- is printed.
-S system_file
Specify the HP-UX system description file name. Users should specify the complete path to the
file name; otherwise, kmsystem will search the current directory for the specified file. The
default HP-UX system description file if the -S option is not specified is
/stand/system.
This option is for backward compatibility.
EXAMPLES
To display the configuration and loadable status of the stape module:
/usr/sbin/kmsystem -q stape
To specify that the stape module should be statically linked:
/usr/sbin/kmsystem -l N stape
NOTES
System administrators are encouraged to use kmsystem and kmtune instead of editing system descrip-
tion files manually. File format of system description files are subject to change, and kmsystem provides
compatibility in the event of a format change.
RETURN VALUE
Upon successful completion, kmsystem returns with one a 0; otherwise it returns with a 1.
DIAGNOSTICS
Output for queries is sent to stdout. Error messages are sent to stderr. Messages from kmsystem are
self explanatory.
FILES
/usr/conf/master.d/* Master configuration tables for kernel and kernel modules
/stand/system Default HP-UX system description file
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−405