version 2 showing authors affecting page license.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
RMMOD |
|
|
2 |
!!!RMMOD |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
PERSISTENT DATA |
|
|
7 |
SEE ALSO |
|
|
8 |
BUGS |
|
|
9 |
HISTORY |
|
|
10 |
---- |
|
|
11 |
!!NAME |
|
|
12 |
|
|
|
13 |
|
|
|
14 |
rmmod - unload loadable modules |
|
|
15 |
!!SYNOPSIS |
|
|
16 |
|
|
|
17 |
|
|
|
18 |
__rmmod__ [[ -aehrsvV ] module ... |
|
|
19 |
!!DESCRIPTION |
|
|
20 |
|
|
|
21 |
|
|
|
22 |
__rmmod__ unloads loadable modules from the running |
|
|
23 |
kernel. |
|
|
24 |
|
|
|
25 |
|
|
|
26 |
__rmmod__ tries to unload a set of modules from the |
|
|
27 |
kernel, with the restriction that they are not in use and |
|
|
28 |
that they are not referred to by other modules. |
|
|
29 |
|
|
|
30 |
|
|
|
31 |
If more than one module is named on the command line, the |
|
|
32 |
modules will be removed in the given order. This supports |
|
|
33 |
unloading of stacked modules. |
|
|
34 |
|
|
|
35 |
|
|
|
36 |
With the option '__-r__', a recursive removal of modules |
|
|
37 |
will be attempted. This means that if a top module in a |
|
|
38 |
stack is named on the command line, all modules that are |
|
|
39 |
used by this module will be removed as well, if |
|
|
40 |
possible. |
|
|
41 |
|
|
|
42 |
|
|
|
43 |
__OPTIONS__ |
|
|
44 |
|
|
|
45 |
|
|
|
46 |
__-a__, __--all__ |
|
|
47 |
|
|
|
48 |
|
|
|
49 |
Do autoclean: tag unused modules as |
|
|
50 |
|
|
|
51 |
|
|
|
52 |
__-e__, __--persist__ |
|
|
53 |
|
|
|
54 |
|
|
|
55 |
Save persistent data for the named modules, without |
|
|
56 |
unloading any modules. If no module names are specified then |
|
|
57 |
data is saved for all modules that have persistent data. |
|
|
58 |
Data is only saved if both the kernel and modutils support |
|
|
59 |
persistent data and ''/proc/ksyms'' contains an entry |
|
|
60 |
__insmod_''modulename''_P''persistent_filename'' |
|
|
61 |
|
|
|
62 |
|
|
|
63 |
__-h__, __--help__ |
|
|
64 |
|
|
|
65 |
|
|
|
66 |
Display a summary of options and immediately |
|
|
67 |
exit. |
|
|
68 |
|
|
|
69 |
|
|
|
70 |
__-r__, __--stacks__ |
|
|
71 |
|
|
|
72 |
|
|
|
73 |
Remove a module stack. |
|
|
74 |
|
|
|
75 |
|
|
|
76 |
__-s__, __--syslog__ |
|
|
77 |
|
|
|
78 |
|
|
|
79 |
Output everything to syslog(3) instead of the |
|
|
80 |
terminal. |
|
|
81 |
|
|
|
82 |
|
|
|
83 |
__-v__, __--verbose__ |
|
|
84 |
|
|
|
85 |
|
|
|
86 |
Be verbose. |
|
|
87 |
|
|
|
88 |
|
|
|
89 |
__-V__, __--version__ |
|
|
90 |
|
|
|
91 |
|
|
|
92 |
Print the version of __modutils__. |
|
|
93 |
!!PERSISTENT DATA |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
If a module contains persistent data (see insmod(8) |
|
|
97 |
and modules.conf(5)) then removing the module always |
|
|
98 |
writes the persistent data to the filename in the __insmod |
|
|
99 |
_P symbol entry. You can also save the persistent data at |
|
|
100 |
any time by __rmmod -e__, this will not unload any |
|
|
101 |
modules. |
|
|
102 |
|
|
|
103 |
|
|
|
104 |
When the persistent data is written to file, it is preceded |
|
|
105 |
by a generated comment line, |
|
|
106 |
#% ''kernel_version timestamp'' |
|
|
107 |
Generated comment lines start with '#%', all generated |
|
|
108 |
comments are stripped from the existing file, other comments |
|
|
109 |
are preserved. The saved data values are written to the |
|
|
110 |
file, preserving the existing order of comments and |
|
|
111 |
assignments. New values are added at the end of the file. If |
|
|
112 |
the file contains values that do not exist in the module |
|
|
113 |
then these values are preserved but are preceded by a |
|
|
114 |
generated comment warning that they are not being used. The |
|
|
115 |
latter operation allows a user to switch between kernels |
|
|
116 |
without losing persistent data and without getting any error |
|
|
117 |
messages. |
|
|
118 |
|
|
|
119 |
|
|
|
120 |
__Note:__ Comments are only supported when the first |
|
|
121 |
non-space character on a line is '#'. Any non-blank lines |
|
|
122 |
that do not start with '#' are module options, one per line. |
|
|
123 |
The option lines have leading spaces removed, the remainder |
|
|
124 |
of the line is passed to insmod as an option, including any |
|
|
125 |
trailing characters. |
|
|
126 |
!!SEE ALSO |
|
|
127 |
|
|
|
128 |
|
|
|
129 |
insmod(8), lsmod(8), ksyms(8), |
|
|
130 |
modprobe(8). |
|
|
131 |
!!BUGS |
|
|
132 |
|
|
|
133 |
|
|
|
134 |
__rmmod__ [[__-V__ | __--version__] should display |
|
|
135 |
version information and then exit immediately. Instead, it |
|
|
136 |
prints the version information and behaves as if no options |
|
|
137 |
were given. |
|
|
138 |
!!HISTORY |
|
|
139 |
|
|
|
140 |
|
|
|
141 |
Module support was first conceived by Anonymous |
|
|
142 |
Initial Linux version by Bas Laarhoven |
|
|
143 |
Version 0.99.14 by Jon Tombs |
|
|
144 |
Extended by Bjorn Ekwall |
|
|
145 |
Updated for 2.1.17 by Richard Henderson |
|
|
146 |
Updated for 2.2.2 by by Bjorn Ekwall |
|
|
147 |
Updated for modutils 2.3.20 by by Keith Owens |
|
|
148 |
Persistent data for modutils 2.3.22 by by Keith Owens |
|
|
149 |
---- |