MAN page from Old RedHat 7.X modutils-2.4.6-4.i386.rpm
RMMOD
Section: Linux Module Support (8)
Updated: November 12, 2000
Index NAME
rmmod - unload loadable modules
SYNOPSIS
rmmod[ -aehrsvV ] module ...
DESCRIPTION
rmmodunloads loadable modules from the running kernel.
rmmodtries to unload a set of modules from the kernel, with the restrictionthat they are not in use and that they are not referred to by other modules.
If more than one module is named on the command line, the moduleswill be removed in the given order. This supports unloading of stacked modules.
With the option '-r' a recursive removal of modules will be attempted.This means that if a top module in a stack is named on the command line,all modules that are used by this module will be removed as well, if possible.
OPTIONS
- -a --all
- Do autoclean: tag unused modules as "to be cleaned", and also removealready tagged modules.Modules stay tagged if they stay unused since previous autoclean.These two passes avoid removing transiently unused modules.
- -e --persist
- Save persistent data for the named modules, without unloading anymodules. If no module names are specified then data is saved for allmodules that have persistent data. Data is only saved if both thekernel and modutils support persistent data and /proc/ksyms contains anentry
__insmod_modulename_Ppersistent_filename - -h --help
- Print the help text.
- -r --stacks
- Remove a module stack.
- -s --syslog
- Output everything to syslog(3) instead of the terminal.
- -v --verbose
- Be verbose.
- -V --version
- Print the version of modutils.
PERSISTENT DATA
If a module contains persistent data (see
insmod(8)and
modules.conf(5))then removing the module always writes the persistent data to thefilename in the __insmod _P symbol entry. You can also save thepersistent data at any time by rmmod -e, this will not unload anymodules.
When the persistent data is written to file, it is preceded by agenerated comment line,
#% kernel_version timestamp
Generated comment lines start with '#%', all generated comments arestripped from the existing file, other comments are preserved. Thesaved data values are written to the file, preserving the existingorder of comments and assignments. New values are added at the end ofthe file. If the file contains values that do not exist in the modulethen these values are preserved but are preceded by a generated commentwarning that they are not being used. The latter operation allows auser to switch between kernels without losing persistent data andwithout getting any error messages.
Note:Comments are only supported when the first non-space character on aline is '#'. Any non-blank lines that do not start with '#' are moduleoptions, one per line. The option lines have leading spaces removed,the remainder of the line is passed to insmod as an option, includingany trailing characters.
SEE ALSO
insmod(8),
lsmod(8),
ksyms(8),
modprobe(8)
HISTORY
Module support was first conceived 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>
Updated for 2.1.17 by Richard Henderson <rthAATTtamu.edu>
Updated for 2.2.2 by by Bjorn Ekwall <bj0rnAATTblox.se>
Updated for modutils 2.3.20 by by Keith Owens <kaosAATTocs.com.au>
Persistent data for modutils 2.3.22 by by Keith Owens <kaosAATTocs.com.au>
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- PERSISTENT DATA
- SEE ALSO
- HISTORY
This document was created byman2html,using the manual pages.
