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 directories.
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
Printable version
