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 contain 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
kmsystem
exits with an error.
- -q
Print the loadable and configuration flag information for
module_name.
If the loadable information 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 description 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
- /stand/system.d/*
Kernel module system description files