NAME
kminstall — add, delete, update the installation of a kernel module
SYNOPSIS
/usr/sbin/kminstall
[-a|-d
|-u]
[-s]
module_name
DESCRIPTION
kminstall
will add
(-a),
delete
(-d)
or update
(-u)
a kernel 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.
This command is used to ensure that during system installation
the module's component files
are placed in the locations where the kernel configuration
tools expect to find them. Additional steps are required to configure
and register the installed module with the kernel. [See
config(1M)
and
kmupdate(1M).]
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.
- -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/*
Master configuration files
- /stand/dlkm*/mod.d/*
Configured loadable images associated with a kernel
Printable version
