MAN page from RedHat Other modutils-2.1.85-1.i386.rpm
INSMOD
Section: Linux Module Support (1)
Updated: 26 Dec 1996
Index NAME
insmod - install loadable kernel module
SYNOPSIS
insmod[ -fkmpsxXv ] [ -o module_name ] object_file [ symbol=value ... ]
DESCRIPTION
Insmodinstalls a loadable module in the running kernel.
Insmodtries to link a module into the running kernel by resolving all symbolsfrom the kernel's exported symbol table.
If the object file name is given without extension, insmodwill search for the module in some common default directories. Theenvironment variable MODPATH can be used to override this default.
OPTIONS
- -f
- Attempt load the module even if the version of the running kernel andthe version of the kernel for which the module was compiled do not match.
- -k
- Set the auto-clean flag on the module. This flag will be used bykerneld(8) to remove modules that have not been used in someperiod of time --- usually one minute.
- -m
- Output a load map, making it easier to debug the module in the eventof a kernel panic.
- -o
- Explicitly name the module, rather than deriving the name from thebase name of the source object file.
- -p
- Probe the module to see if it could be successfully loaded. Thisincludes locating the object file in the module path, checkingversion numbers, and resolving symbols.
- -s
- Output everything to syslog(3) instead of the terminal.
- -v
- Be verbose.
- -X, -x
- Do and do not export all of the module's external symbols, respectively.The default is for the symbols to be exported. This option is onlyeffective if the module does not explicitly export its own controledsymbol table, and thus is depreciated.
MODULE PARAMETERS
Some modules accept load-time parameters to customize their operation.These parameters are often I/O port and IRQ numbers that vary frommachine to machine and cannot be determined from the hardware.
In modules built for 2.0 series kernels, any integer or character pointersymbol may be treated as a parameter and modified. Beginning in the2.1 series kernels, symbols are explicitly marked as parameters so thatonly specific values may be chagned. Furthermore type information is provied for checking the values provided at load time.
In the case of integers, all values may be in decimal, octal orhexadecimal a la C: 17, 021 or 0x11. Array elements are specified sequence separrated by commas; elements can be skipped by omittingthe value.
In 2.0 series modules, values that do not begin with a number areconsidered strings. Beginning in 2.1, the parameter's type informationindicates whether to interpret the value as a string. If the valuebegins with double-quotes ("), the string is interpreted asin C, escape sequences and all. Do note that from the shell prompt,the quotes themselves may need to be protected from shell interpretation.
SEE ALSO
rmmod(1),
modprobe(1),
depmod(1),
lsmod(1),
ksyms(1),
modules(2),
genksyms(8),
kerneld(8).
HISTORY
Module support was first concieved by Anonymous
Initial Linux version by Bas Laarhoven <basAATTvimec.nl>
Version 0.99.14 by Jon Tombs <jonAATTgtex02.us.es>
Extended by Bjorn Ekwall <bj0rnAATTblox.se>
Originial ELF help from Eric Youngdale <ericAATTaib.com>
Rewritten for 2.1.17 by Richard Henderson <rthAATTtamu.edu>
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- MODULE PARAMETERS
- SEE ALSO
- HISTORY
This document was created byman2html,using the manual pages.
