INSMOD(1)

NAME
insmod - install loadable modules

SYNOPSIS
insmod [-o internal_name] [-f] object_file [symbol=value ...]

DESCRIPTION
Insmod installs a loadable module in the kernel.

Insmod tries to load a module into the kernel, and resolves all symbols from the exported kernel symbols. The module will get its name by removing the '.o' extension from the basename of the object file.
It is possible to stack modules, i.e. let one module use a previously loaded module. All external symbols are inserted in the kernel symbol table, and all modules that are referenced are updated with this reference. This ensures that a module can't be unloaded if there is another module that refers to it.

It is possible to change integer values in the module when loading it. This makes it possible to "tune" the module.

The options are as follows:

-o  The -o option allows the module to be named to an explicit name instead of having a name derived from the name of the object file.

-f  The -f option tries to load the module even if the kernel version differs from the kernel version of the module. A warning will be issued anyhow.

symbol=value ...
    All integer values in the module can be changed at load-time by naming the symbol and giving the new value.
    The value can be given as a decimal, octal or hexadecimal value: 17, 021 or 0x11.
    Note the syntax: no spaces are allowed around the '='-sign!

SEE ALSO
rmmod(1), lsmod(1), ksyms(1)

HISTORY
The insmod command was first concieved by Jon Tombs <jon@gtex02.us.es>, and extended by Bjorn Ekwall <bj0rn@blox.se>.

BUGS
Insmod relies on the "fact" that symbols, for which one wants to change the value, are defined as ints.
A better version control should be nice...