Penguin
Annotated edit history of rmmod(8) version 2, including all changes. View license author blame.
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)
2 perry 97 and modules.conf(5)) then removing the module always
1 perry 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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.