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 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