HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
k
kminstall(1M) kminstall(1M)
NAME
kminstall - add, delete, update a kernel module
SYNOPSIS
/usr/sbin/kminstall [-a|-d|-u][-s] module_name
DESCRIPTION
kminstall will add (-a), delete (-d) or update (-u) a module’s component files on the system.
When called with the -a or -u option, kminstall expects to find the module’s component files in the
current directory, and installs or updates copies of the files under subdirectories of the /usr/conf and
/stand directories.
Options
The options for kminstall are:
-a Add the component files for the named module, module_name, to the appropriate system-specific
directories.
A module’s component files consist of the following:
mod.o required
master required
system required
space.h optional
Modstub.o optional
kminstall -a expects minimally a readable mod.o, master, and system file in the
current directory. It creates the required system-specific target directories if they do not exist.
If module_name already exists on the system, kminstall -a prints a message and fails.
-d Remove the component files for the named module, module_name, from the system-specific
directories.
kminstall -d deletes the files that have been previously installed via kminstall -a or
kminstall -u. If the module has been configured for use with the current kernel, and
kminstall can bring the module to an unregistered state, kminstall -d will also remove
the loadable image of the module from disk. If the module cannot be unregistered,
kminstall
-d
prints a warning message and the loadable image remains.
If module_name is configured as a loadable module and its entry is in the /etc/loadmods
file
(see loadmods(4)), then
kminstall prints a warning message and removes the module entry
from /etc/loadmods.
-s Silence all warning messages.
-u Update the component files for the named module, module_name, in the system-specific direc-
tories.
kminstall -u expects minimally the same required component files in the current directory
as the -a option. If module_name already exists on the system, kminstall updates the
module. When updating an existing module, any administrator-configurable attributes (see
kmsystem(1M) and kmtune(1M)) of the existing module will be preserved and applied to the
updated module.
If module_name does not exist on the system, then kminstall -u prints a warning and
proceeds to add the module to the system.
kminstall creates the required system-specific target directories if they do not exist.
RETURN VALUE
An exit value of zero indicates success. If an error occurs, kminstall exits with a non-zero value and
reports an error message. Error messages are self-explanatory.
FILES
/usr/conf/master.d/* Default input master kernel configuration tables
/stand/dlkm*/mod.d/*
Configured loadable images associated with a kernel
Section 1M−−386 − 1 − HP-UX Release 11i: December 2000
___
___