Commit | Line | Data |
---|---|---|
458bbd1f | 1 | .\" Copyright (c) 1991, 1996 Free Software Foundation |
19450a0c | 2 | .\" See section COPYING for conditions for redistribution |
19450a0c RP |
3 | .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools" |
4 | .de BP | |
5 | .sp | |
6 | .ti \-.2i | |
7 | \(** | |
8 | .. | |
9 | ||
10 | .SH NAME | |
938fa52b | 11 | objdump \- display information from object files. |
19450a0c RP |
12 | |
13 | .SH SYNOPSIS | |
14 | .hy 0 | |
15 | .na | |
16 | .TP | |
b26ac613 | 17 | .B objdump |
eae04238 | 18 | .RB "[\|" \-a | \-\-archive\-headers "\|]" |
19450a0c RP |
19 | .RB "[\|" "\-b\ "\c |
20 | .I bfdname\c | |
eae04238 DM |
21 | .RB " | " "\-\-target="\c |
22 | .I bfdname\c | |
19450a0c | 23 | \&\|] |
e1c14599 | 24 | .RB "[\|" \-\-debugging "\|]" |
eae04238 | 25 | .RB "[\|" \-d | \-\-disassemble "\|]" |
d5464baa | 26 | .RB "[\|" \-D | \-\-disassemble-all "\|]" |
67c8c901 ILT |
27 | .RB "[\|" \-EB | \-EL | \-\-endian=\c |
28 | .I {big|little}\c | |
29 | \&\|] | |
eae04238 DM |
30 | .RB "[\|" \-f | \-\-file\-headers "\|]" |
31 | .RB "[\|" \-h | \-\-section\-headers | |
32 | .RB "| " \-\-headers "\|]" | |
33 | .RB "[\|" \-i | \-\-info "\|]" | |
19450a0c RP |
34 | .RB "[\|" "\-j\ "\c |
35 | .I section\c | |
eae04238 DM |
36 | .RB " | " "\-\-section="\c |
37 | .I section\c | |
19450a0c | 38 | \&\|] |
eae04238 | 39 | .RB "[\|" \-l | \-\-line\-numbers "\|]" |
19450a0c RP |
40 | .RB "[\|" "\-m\ "\c |
41 | .I machine\c | |
eae04238 DM |
42 | .RB " | " "\-\-architecture="\c |
43 | .I machine\c | |
19450a0c | 44 | \&\|] |
1f72cab1 | 45 | .RB "[\|" \-r | \-\-reloc "\|]" |
de3b08ac | 46 | .RB "[\|" \-R | \-\-dynamic\-reloc "\|]" |
eae04238 | 47 | .RB "[\|" \-s | \-\-full\-contents "\|]" |
a8e27cc6 | 48 | .RB "[\|" \-S | \-\-source "\|]" |
458bbd1f | 49 | .RB "[\|" \-\-show\-raw\-insn "\|]" |
1f72cab1 DM |
50 | .RB "[\|" \-\-stabs "\|]" |
51 | .RB "[\|" \-t | \-\-syms "\|]" | |
de3b08ac | 52 | .RB "[\|" \-T | \-\-dynamic\-syms "\|]" |
eae04238 | 53 | .RB "[\|" \-x | \-\-all\-headers "\|]" |
aa21a2a9 ILT |
54 | .RB "[\|" "\-\-start\-address="\c |
55 | .I address\c | |
56 | \&\|] | |
57 | .RB "[\|" "\-\-stop\-address="\c | |
58 | .I address\c | |
59 | \&\|] | |
b26ac613 DM |
60 | .RB "[\|" \-\-version "\|]" |
61 | .RB "[\|" \-\-help "\|]" | |
1f72cab1 | 62 | .I objfile\c |
19450a0c RP |
63 | \&.\|.\|. |
64 | .ad b | |
65 | .hy 1 | |
66 | .SH DESCRIPTION | |
67 | \c | |
68 | .B objdump\c | |
69 | \& displays information about one or more object files. | |
70 | The options control what particular information to display. This | |
71 | information is mostly useful to programmers who are working on the | |
72 | compilation tools, as opposed to programmers who just want their | |
73 | program to compile and work. | |
b26ac613 | 74 | .PP |
1f72cab1 | 75 | .IR "objfile" .\|.\|. |
b26ac613 | 76 | are the object files to be examined. When you specify archives, |
19450a0c RP |
77 | \c |
78 | .B objdump\c | |
79 | \& shows information on each of the member object files. | |
80 | ||
b26ac613 DM |
81 | .SH OPTIONS |
82 | Where long and short forms of an option are shown together, they are | |
ed78872a DM |
83 | equivalent. At least one option besides |
84 | .B \-l | |
eae04238 | 85 | (\fB\-\-line\-numbers\fP) must be given. |
b26ac613 | 86 | |
19450a0c RP |
87 | .TP |
88 | .B \-a | |
eae04238 DM |
89 | .TP |
90 | .B \-\-archive\-headers | |
19450a0c | 91 | If any files from \c |
1f72cab1 | 92 | .I objfile\c |
19450a0c RP |
93 | \& are archives, display the archive |
94 | header information (in a format similar to `\|\c | |
95 | .B ls \-l\c | |
96 | \|'). Besides the | |
97 | information you could list with `\|\c | |
98 | .B ar tv\c | |
99 | \|', `\|\c | |
100 | .B objdump \-a\c | |
101 | \|' shows | |
102 | the object file format of each archive member. | |
103 | ||
104 | .TP | |
eae04238 DM |
105 | .BI "\-b " "bfdname"\c |
106 | .TP | |
5740d9df | 107 | .BI "\-\-target=" "bfdname" |
b26ac613 | 108 | Specify the object-code format for the object files to be |
19450a0c RP |
109 | \c |
110 | .I bfdname\c | |
111 | \&. This may not be necessary; \c | |
112 | .I objdump\c | |
113 | \& can | |
114 | automatically recognize many formats. For example, | |
115 | .sp | |
116 | .br | |
117 | objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o | |
118 | .br | |
119 | .sp | |
b26ac613 | 120 | display summary information from the section headers (`\|\c |
19450a0c RP |
121 | .B \-h\c |
122 | \|') of | |
123 | `\|\c | |
124 | .B fu.o\c | |
125 | \|', which is explicitly identified (`\|\c | |
126 | .B \-m\c | |
127 | \|') as a Vax object | |
128 | file in the format produced by Oasys compilers. You can list the | |
129 | formats available with the `\|\c | |
130 | .B \-i\c | |
131 | \|' option. | |
132 | ||
e1c14599 ILT |
133 | .TP |
134 | .B \-\-debugging | |
135 | Display debugging information. This attempts to parse debugging | |
136 | information stored in the file and print it out using a C like syntax. | |
137 | Only certain types of debugging information have been implemented. | |
138 | ||
19450a0c RP |
139 | .TP |
140 | .B \-d | |
eae04238 DM |
141 | .TP |
142 | .B \-\-disassemble | |
143 | Display the assembler mnemonics for the machine | |
19450a0c | 144 | instructions from \c |
1f72cab1 | 145 | .I objfile\c |
19450a0c | 146 | \&. |
d5464baa ILT |
147 | This option only disassembles those sections which are |
148 | expected to contain instructions. | |
149 | ||
150 | .TP | |
151 | .B \-D | |
152 | .TP | |
153 | .B \-\-disassemble-all | |
154 | Like \fB\-d\fP, but disassemble the contents of all sections, not just | |
155 | those expected to contain instructions. | |
19450a0c | 156 | |
67c8c901 ILT |
157 | .TP |
158 | .B \-EB | |
159 | .TP | |
160 | .B \-EL | |
161 | .TP | |
162 | .BI "\-\-endian=" "{big|little}" | |
163 | Specify the endianness of the object files. This only affects | |
164 | disassembly. This can be useful when disassembling a file format which | |
165 | does not describe endianness information, such as S-records. | |
166 | ||
19450a0c RP |
167 | .TP |
168 | .B \-f | |
eae04238 DM |
169 | .TP |
170 | .B \-\-file\-headers | |
171 | Display summary information from the overall header of | |
19450a0c | 172 | each file in \c |
1f72cab1 | 173 | .I objfile\c |
19450a0c RP |
174 | \&. |
175 | ||
176 | .TP | |
177 | .B \-h | |
178 | .TP | |
eae04238 DM |
179 | .B \-\-section\-headers |
180 | .TP | |
181 | .B \-\-headers | |
182 | Display summary information from the section headers of the | |
19450a0c RP |
183 | object file. |
184 | ||
b26ac613 DM |
185 | .TP |
186 | .B \-\-help | |
187 | Print a summary of the options to | |
188 | .B objdump | |
189 | and exit. | |
190 | ||
19450a0c RP |
191 | .TP |
192 | .B \-i | |
eae04238 DM |
193 | .TP |
194 | .B \-\-info | |
19450a0c RP |
195 | Display a list showing all architectures and object formats available |
196 | for specification with \c | |
197 | .B \-b\c | |
198 | \& or \c | |
199 | .B \-m\c | |
200 | \&. | |
201 | ||
202 | .TP | |
eae04238 DM |
203 | .BI "\-j " "name"\c |
204 | .TP | |
5740d9df | 205 | .BI "\-\-section=" "name" |
19450a0c RP |
206 | Display information only for section \c |
207 | .I name\c | |
5740d9df | 208 | \&. |
19450a0c RP |
209 | |
210 | .TP | |
211 | .B \-l | |
eae04238 DM |
212 | .TP |
213 | .B \-\-line\-numbers | |
214 | Label the display (using debugging information) with the filename | |
215 | and source line numbers corresponding to the object code shown. | |
11548211 | 216 | Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP. |
19450a0c RP |
217 | |
218 | .TP | |
eae04238 DM |
219 | .BI "\-m " "machine"\c |
220 | .TP | |
5740d9df | 221 | .BI "\-\-architecture=" "machine" |
67c8c901 ILT |
222 | Specify the architecture to use when disassembling object files. This |
223 | can be useful when disasembling object files which do not describe | |
224 | architecture information, such as S-records. You can list the available | |
225 | architectures with the \fB\-i\fP option. | |
19450a0c RP |
226 | |
227 | .TP | |
228 | .B \-r | |
229 | .TP | |
1f72cab1 | 230 | .B \-\-reloc |
d5464baa ILT |
231 | Print the relocation entries of the file. If used with \fB\-d\fP or |
232 | \fB\-d\fP, the relocations are printed interspersed with the | |
233 | disassembly. | |
19450a0c | 234 | |
de3b08ac ILT |
235 | .TP |
236 | .B \-R | |
237 | .TP | |
238 | .B \-\-dynamic\-reloc | |
239 | Print the dynamic relocation entries of the file. This is only | |
240 | meaningful for dynamic objects, such as certain types of shared | |
241 | libraries. | |
242 | ||
19450a0c RP |
243 | .TP |
244 | .B \-s | |
eae04238 DM |
245 | .TP |
246 | .B \-\-full\-contents | |
19450a0c RP |
247 | Display the full contents of any sections requested. |
248 | ||
a8e27cc6 ILT |
249 | .TP |
250 | .B \-S | |
251 | .TP | |
252 | .B \-\-source | |
253 | Display source code intermixed with disassembly, if possible. Implies | |
254 | \fB-d\fP. | |
255 | ||
458bbd1f DE |
256 | .TP |
257 | .B \-\-show-raw-insn | |
258 | When disassembling instructions, print the instruction in hex as well as | |
259 | in symbolic form. Not all targets handle this correctly yet. | |
260 | ||
c5f0c938 | 261 | .TP |
1f72cab1 | 262 | .B \-\-stabs |
c3c93fda JG |
263 | Display the contents of the .stab, .stab.index, and .stab.excl |
264 | sections from an ELF file. This is only useful on systems (such as | |
265 | Solaris 2.0) in which .stab debugging symbol-table entries are carried | |
266 | in an ELF section. In most other file formats, debugging symbol-table | |
267 | entries are interleaved with linkage symbols, and are visible in the | |
1f72cab1 | 268 | \-\-syms output. |
c5f0c938 | 269 | |
aa21a2a9 ILT |
270 | .TP |
271 | .BI "\-\-start\-address=" "address" | |
272 | Start displaying data at the specified address. This affects the output | |
273 | of the | |
274 | .B \-d\c | |
275 | , | |
276 | .B \-r | |
277 | and | |
278 | .B \-s | |
279 | options. | |
280 | ||
281 | .TP | |
282 | .BI "\-\-stop\-address=" "address" | |
283 | Stop displaying data at the specified address. This affects the output | |
284 | of the | |
285 | .B \-d\c | |
286 | , | |
287 | .B \-r | |
288 | and | |
289 | .B \-s | |
290 | options. | |
291 | ||
19450a0c RP |
292 | .TP |
293 | .B \-t | |
294 | .TP | |
1f72cab1 | 295 | .B \-\-syms |
19450a0c RP |
296 | Symbol Table. Print the symbol table entries of the file. |
297 | This is similar to the information provided by the `\|\c | |
298 | .B nm\c | |
299 | \|' program. | |
300 | ||
de3b08ac ILT |
301 | .TP |
302 | .B \-T | |
303 | .TP | |
304 | .B \-\-dynamic\-syms | |
305 | Dynamic Symbol Table. Print the dynamic symbol table entries of the | |
306 | file. This is only meaningful for dynamic objects, such as certain | |
307 | types of shared libraries. This is similar to the information | |
308 | provided by the `\|\c | |
309 | .B nm\c | |
310 | \|' program when given the | |
311 | .B \-D (\-\-dynamic) | |
312 | option. | |
313 | ||
b26ac613 DM |
314 | .TP |
315 | .B \-\-version | |
316 | Print the version number of | |
317 | .B objdump | |
318 | and exit. | |
319 | ||
19450a0c RP |
320 | .TP |
321 | .B \-x | |
eae04238 DM |
322 | .TP |
323 | .B \-\-all\-headers | |
19450a0c RP |
324 | Display all available header information, including the symbol table and |
325 | relocation entries. Using `\|\c | |
326 | .B \-x\c | |
327 | \|' is equivalent to specifying all of | |
328 | `\|\c | |
329 | .B \-a \-f \-h \-r \-t\c | |
330 | \|'. | |
331 | ||
19450a0c RP |
332 | .SH "SEE ALSO" |
333 | .RB "`\|" binutils "\|'" | |
334 | entry in | |
335 | .B | |
336 | info\c | |
337 | \&; | |
338 | .I | |
339 | The GNU Binary Utilities\c | |
340 | \&, Roland H. Pesch (October 1991); | |
341 | .BR nm "(" 1 ")." | |
342 | ||
343 | .SH COPYING | |
1a418120 | 344 | Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc. |
19450a0c RP |
345 | .PP |
346 | Permission is granted to make and distribute verbatim copies of | |
347 | this manual provided the copyright notice and this permission notice | |
348 | are preserved on all copies. | |
349 | .PP | |
350 | Permission is granted to copy and distribute modified versions of this | |
351 | manual under the conditions for verbatim copying, provided that the | |
352 | entire resulting derived work is distributed under the terms of a | |
353 | permission notice identical to this one. | |
354 | .PP | |
355 | Permission is granted to copy and distribute translations of this | |
356 | manual into another language, under the above conditions for modified | |
357 | versions, except that this permission notice may be included in | |
358 | translations approved by the Free Software Foundation instead of in | |
359 | the original English. |