-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmod.html
227 lines (198 loc) · 10.9 KB
/
mod.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="cache-control" content="max-age=0" />
<meta http-equiv="cache-control" content="no-cache" />
<meta http-equiv="expires" content="0" />
<meta http-equiv="expires" content="Tue, 01 Jan 1980 1:00:00 GMT" />
<meta http-equiv="pragma" content="no-cache" />
<!-- MAIN BODY TABLE is nested for scalability -->
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td colspan="3"><hr class="gray" noshade="noshade" /></td>
</tr>
<tr>
<td colspan="3"><img src="/img/pixel.gif" width="1" height="10" border="0" alt="" /></td>
</tr>
</table>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="100%">
<!--CONTENT begins here-->
<h3>crash utility help page: <tt><b> mod</b></tt></a></h3>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre>
NAME
mod - module information and loading of symbols and debugging data
SYNOPSIS
mod -s module [objfile] | -d module | -S [directory] [-D|-t|-r|-R|-o|-g]
DESCRIPTION
With no arguments, this command displays basic information of the currently
installed modules, consisting of the module address, name, base address,
size, the object file name (if known), and whether the module was compiled
with CONFIG_KALLSYMS.
The arguments are concerned with with the loading or deleting of symbolic
and debugging data from a module's object file. A modules's object file
always contains symbolic data (symbol names and addresses), but contains
debugging data only if the module was compiled with the -g CFLAG. In
addition, the module may have compiled with CONFIG_KALLSYMS, which means
that the module's symbolic data will have been loaded into the kernel's
address space when it was installed. If the module was not compiled with
CONFIG_KALLSYMS, then only the module's exported symbols will be loaded
into the kernel's address space. Therefore, for the purpose of this
command, it should noted that a kernel module may have been compiled in
one of following manners:
1. If the module was built without CONFIG_KALLSYMS and without the -g CFLAG,
then the loading of the module's additional non-exported symbols can
be accomplished with this command.
2. If the module was built with CONFIG_KALLSYMS, but without the -g CFLAG,
then there is no benefit in loading the symbols from the module object
file, because all of the module's symbols will have been loaded into the
kernel's address space when it was installed.
3. If the module was built with CONFIG_KALLSYMS and with the the -g CFLAG,
then the loading of the module's debugging data can be accomplished
with this command.
4. If the module was built without CONFIG_KALLSYMS but with the -g CFLAG,
then the loading of the both module's symbolic and debugging data can
be accomplished with this command.
-s module [objfile] Loads symbolic and debugging data from the object file
for the module specified. If no objfile argument is
appended, a search will be made for an object file
consisting of the module name with a .o or .ko suffix,
starting at the /lib/modules/<release> directory on
the host system, or if not found there, starting at the
directory containing the kernel namelist file. If an
objfile argument is appended, then that file will be
used.
-d module Deletes the symbolic and debugging data of the module
specified.
-S [directory] Load symbolic and debugging data from the object file
for all loaded modules. For each module, a search
will be made for an object file consisting of the
module name with a .o or .ko suffix, starting at the
/lib/modules/<release> directory of the host system,
or if not found there, starting at the directory
containing the kernel namelist file. If a directory
argument is appended, then the search will be restricted
to that directory.
-D Deletes the symbolic and debugging data of all modules.
-t Display the contents of the module's "taints" bitmask
if it is non-zero. When possible, the "taints" bits
are translated to symbolic letters of the taint type;
otherwise the hexadecimal value is shown. In older
kernels, the contents of the "license_gplok" field is
displayed in hexadecimal; the field may be either a
bitmask or a boolean, depending upon the kernel version.
The relevant kernel sources should be consulted for the
meaning of the letter(s) or hexadecimal bit value(s).
For modules that have a "gpgsig_ok" field that is zero
(unsigned), the notation "(U)" is shown.
-r Passes the -readnow flag to the embedded gdb module,
which will override the two-stage strategy that it uses
for reading symbol tables from module object files.
-R Reinitialize module data. All currently-loaded symbolic
and debugging data will be deleted, and the installed
module list will be updated (live system only).
-g When used with -s or -S, add a module object's section
start and end addresses to its symbol list.
-o Load module symbols with old mechanism.
If the crash session was invoked with the "--mod <directory>" option, or
a CRASH_MODULE_PATH environment variable exists, then /lib/modules/<release>
will be overridden as the default directory tree that is searched for module
object files.
After symbolic and debugging data have been loaded, backtraces and text
disassembly will be displayed appropriately. Depending upon the processor
architecture, data may also printed symbolically with the "p" command;
at a minimum, the "rd" command may be used with module data symbols.
If crash can recognize that the set of modules has changed while running a
session on a live kernel, the module data will be reinitialized the next
time this command is run; the -r option forces the reinitialization.
EXAMPLES
Display the currently-installed modules:
crash> mod
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 (not loaded)
f7e5a8a0 dm_log f7e59000 8354 (not loaded)
f7e66420 dm_region_hash f7e65000 9708 (not loaded)
f7e76b60 dm_mirror f7e74000 12609 (not loaded)
f7e8b8e0 ata_piix f7e87000 20637 (not loaded)
...
Display the currently-installed modules on a system where all modules were
compiled with CONFIG_KALLSYMS:
crash> mod
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 (not loaded) [CONFIG_KALLSYMS]
f7e5a8a0 dm_log f7e59000 8354 (not loaded) [CONFIG_KALLSYMS]
f7e66420 dm_region_hash f7e65000 9708 (not loaded) [CONFIG_KALLSYMS]
f7e76b60 dm_mirror f7e74000 12609 (not loaded) [CONFIG_KALLSYMS]
f7e8b8e0 ata_piix f7e87000 20637 (not loaded) [CONFIG_KALLSYMS]
...
Load the symbolic and debugging data of all modules:
crash> mod -S
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 /lib/modules/2.6.32/kernel/drivers/md/dm-mod.ko
f7e5a8a0 dm_log f7e59000 8354 /lib/modules/2.6.32/kernel/drivers/md/dm-log.ko
f7e66420 dm_region_hash f7e65000 9708 /lib/modules/2.6.32/kernel/drivers/md/dm-region-hash.ko
f7e76b60 dm_mirror f7e74000 12609 /lib/modules/2.6.32/kernel/drivers/md/dm-mirror.ko
f7e8b8e0 ata_piix f7e87000 20637 /lib/modules/2.6.32/kernel/drivers/ata/ata_piix.ko
...
Load the symbolic and debugging data of the dm_mod module from its
known location:
crash> mod -s dm_mod
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 /lib/modules/2.6.32/kernel/drivers/md/dm-mod.ko
Delete the current symbolic and debugging data of the dm_mod module,
and then re-load it from a specified object file:
crash> mod -d dm_mod
crash> mod -s dm_mod /tmp/dm_mod.ko
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 /tmp/dm-mod.ko
After installing a new kernel module on a live system, reinitialize the
installed module list:
crash> !modprobe soundcore
crash> mod
mod: NOTE: modules have changed on this system -- reinitializing
MODULE NAME BASE SIZE OBJECT FILE
f7e44c20 dm_mod f7e34000 88568 (not loaded)
f7e5a8a0 dm_log f7e59000 8354 (not loaded)
f7e62e40 soundcore f7e62000 6390 (not loaded)
f7e66420 dm_region_hash f7e65000 9708 (not loaded)
f7e76b60 dm_mirror f7e74000 12609 (not loaded)
f7e8b8e0 ata_piix f7e87000 20637 (not loaded)
...
Display modules that are "tainted", where in this case
where they are proprietary and unsigned:
crash> mod -t
NAME TAINT
vxspec P(U)
vxportal P(U)
fdd P(U)
vxfs P(U)
vxdmp P(U)
vxio P(U)
vxglm P(U)
vxgms P(U)
vxodm P(U)
</pre>
</td>
</tr>
</table>
<!--CONTENT ends here-->
</td>
</tr>
</table>
<hr class="gray" noshade="noshade" />
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td colspan="3"><img src="/img/pixel.gif" width="1" height="10" border="0" alt="" /></td>
</tr>
<tr>
<td colspan="3"><img src="/img/pixel.gif" width="1" height="30" border="0" alt="" /></td>
</tr>
</table>
</td>
</table>
</body>
</html>