| blob | b80ee70659fdebdc2a33ec7199e62066b1d4a6f3 |
1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
32 .tr \(*W-|\(bv\*(Tr
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 . ds -- \(*W-
36 . ds PI pi
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39 . ds L" ""
40 . ds R" ""
41 . ds C` ""
42 . ds C' ""
43 'br\}
44 .el\{\
45 . ds -- \|\(em\|
46 . ds PI \(*p
47 . ds L" ``
48 . ds R" ''
49 'br\}
50 .\"
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
55 .if \nF \{\
56 . de IX
57 . tm Index:\\$1\t\\n%\t"\\$2"
58 ..
59 . nr % 0
60 . rr F
61 .\}
62 .\"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
65 .hy 0
66 .\"
67 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
68 .\" Fear. Run. Save yourself. No user-serviceable parts.
69 . \" fudge factors for nroff and troff
70 .if n \{\
71 . ds #H 0
72 . ds #V .8m
73 . ds #F .3m
74 . ds #[ \f1
75 . ds #] \fP
76 .\}
77 .if t \{\
78 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
79 . ds #V .6m
80 . ds #F 0
81 . ds #[ \&
82 . ds #] \&
83 .\}
84 . \" simple accents for nroff and troff
85 .if n \{\
86 . ds ' \&
87 . ds ` \&
88 . ds ^ \&
89 . ds , \&
90 . ds ~ ~
91 . ds /
92 .\}
93 .if t \{\
94 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
95 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
96 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
97 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
98 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
99 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
100 .\}
101 . \" troff and (daisy-wheel) nroff accents
102 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
103 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
104 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
105 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
106 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
107 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
108 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
109 .ds ae a\h'-(\w'a'u*4/10)'e
110 .ds Ae A\h'-(\w'A'u*4/10)'E
111 . \" corrections for vroff
112 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
113 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
114 . \" for low resolution devices (crt and lpr)
115 .if \n(.H>23 .if \n(.V>19 \
116 \{\
117 . ds : e
118 . ds 8 ss
119 . ds o a
120 . ds d- d\h'-1'\(ga
121 . ds D- D\h'-1'\(hy
122 . ds th \o'bp'
123 . ds Th \o'LP'
124 . ds ae ae
125 . ds Ae AE
126 .\}
127 .rm #[ #] #H #V #F C
128 .\" ========================================================================
129 .\"
130 .IX Title "OBJDUMP 1"
131 .TH OBJDUMP 1 "2008-09-10" "binutils-2.18.90" "GNU Development Tools"
132 .SH "NAME"
133 objdump \- display information from object files.
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
137 [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
138 [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ]
139 [\fB\-d\fR|\fB\-\-disassemble\fR]
140 [\fB\-D\fR|\fB\-\-disassemble\-all\fR]
141 [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR]
142 [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }]
143 [\fB\-f\fR|\fB\-\-file\-headers\fR]
144 [\fB\-F\fR|\fB\-\-file\-offsets\fR]
145 [\fB\-\-file\-start\-context\fR]
146 [\fB\-g\fR|\fB\-\-debugging\fR]
147 [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
148 [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
149 [\fB\-i\fR|\fB\-\-info\fR]
150 [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
151 [\fB\-l\fR|\fB\-\-line\-numbers\fR]
152 [\fB\-S\fR|\fB\-\-source\fR]
153 [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
154 [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
155 [\fB\-p\fR|\fB\-\-private\-headers\fR]
156 [\fB\-r\fR|\fB\-\-reloc\fR]
157 [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
158 [\fB\-s\fR|\fB\-\-full\-contents\fR]
159 [\fB\-W\fR|\fB\-\-dwarf\fR]
160 [\fB\-G\fR|\fB\-\-stabs\fR]
161 [\fB\-t\fR|\fB\-\-syms\fR]
162 [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
163 [\fB\-x\fR|\fB\-\-all\-headers\fR]
164 [\fB\-w\fR|\fB\-\-wide\fR]
165 [\fB\-\-start\-address=\fR\fIaddress\fR]
166 [\fB\-\-stop\-address=\fR\fIaddress\fR]
167 [\fB\-\-prefix\-addresses\fR]
168 [\fB\-\-[no\-]show\-raw\-insn\fR]
169 [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
170 [\fB\-\-special\-syms\fR]
171 [\fB\-V\fR|\fB\-\-version\fR]
172 [\fB\-H\fR|\fB\-\-help\fR]
173 \fIobjfile\fR...
174 .SH "DESCRIPTION"
175 .IX Header "DESCRIPTION"
176 \&\fBobjdump\fR displays information about one or more object files.
177 The options control what particular information to display. This
178 information is mostly useful to programmers who are working on the
179 compilation tools, as opposed to programmers who just want their
180 program to compile and work.
181 .PP
182 \&\fIobjfile\fR... are the object files to be examined. When you
183 specify archives, \fBobjdump\fR shows information on each of the member
184 object files.
185 .SH "OPTIONS"
186 .IX Header "OPTIONS"
187 The long and short forms of options, shown here as alternatives, are
188 equivalent. At least one option from the list
189 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
190 .IP "\fB\-a\fR" 4
191 .IX Item "-a"
192 .PD 0
193 .IP "\fB\-\-archive\-header\fR" 4
194 .IX Item "--archive-header"
195 .PD
196 If any of the \fIobjfile\fR files are archives, display the archive
197 header information (in a format similar to \fBls \-l\fR). Besides the
198 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
199 the object file format of each archive member.
200 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
201 .IX Item "--adjust-vma=offset"
202 When dumping information, first add \fIoffset\fR to all the section
203 addresses. This is useful if the section addresses do not correspond to
204 the symbol table, which can happen when putting sections at particular
205 addresses when using a format which can not represent section addresses,
206 such as a.out.
207 .IP "\fB\-b\fR \fIbfdname\fR" 4
208 .IX Item "-b bfdname"
209 .PD 0
210 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
211 .IX Item "--target=bfdname"
212 .PD
213 Specify that the object-code format for the object files is
214 \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
215 automatically recognize many formats.
216 .Sp
217 For example,
218 .Sp
219 .Vb 1
220 \& objdump -b oasys -m vax -h fu.o
221 .Ve
222 .Sp
223 displays summary information from the section headers (\fB\-h\fR) of
224 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
225 file in the format produced by Oasys compilers. You can list the
226 formats available with the \fB\-i\fR option.
227 .IP "\fB\-C\fR" 4
228 .IX Item "-C"
229 .PD 0
230 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
231 .IX Item "--demangle[=style]"
232 .PD
233 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
234 Besides removing any initial underscore prepended by the system, this
235 makes \*(C+ function names readable. Different compilers have different
236 mangling styles. The optional demangling style argument can be used to
237 choose an appropriate demangling style for your compiler.
238 .IP "\fB\-g\fR" 4
239 .IX Item "-g"
240 .PD 0
241 .IP "\fB\-\-debugging\fR" 4
242 .IX Item "--debugging"
243 .PD
244 Display debugging information. This attempts to parse \s-1STABS\s0 and \s-1IEEE\s0
245 debugging format information stored in the file and print it out using
246 a C like syntax. If neither of these formats are found this option
247 falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
248 the file.
249 .IP "\fB\-e\fR" 4
250 .IX Item "-e"
251 .PD 0
252 .IP "\fB\-\-debugging\-tags\fR" 4
253 .IX Item "--debugging-tags"
254 .PD
255 Like \fB\-g\fR, but the information is generated in a format compatible
256 with ctags tool.
257 .IP "\fB\-d\fR" 4
258 .IX Item "-d"
259 .PD 0
260 .IP "\fB\-\-disassemble\fR" 4
261 .IX Item "--disassemble"
262 .PD
263 Display the assembler mnemonics for the machine instructions from
264 \&\fIobjfile\fR. This option only disassembles those sections which are
265 expected to contain instructions.
266 .IP "\fB\-D\fR" 4
267 .IX Item "-D"
268 .PD 0
269 .IP "\fB\-\-disassemble\-all\fR" 4
270 .IX Item "--disassemble-all"
271 .PD
272 Like \fB\-d\fR, but disassemble the contents of all sections, not just
273 those expected to contain instructions.
274 .IP "\fB\-\-prefix\-addresses\fR" 4
275 .IX Item "--prefix-addresses"
276 When disassembling, print the complete address on each line. This is
277 the older disassembly format.
278 .IP "\fB\-EB\fR" 4
279 .IX Item "-EB"
280 .PD 0
281 .IP "\fB\-EL\fR" 4
282 .IX Item "-EL"
283 .IP "\fB\-\-endian={big|little}\fR" 4
284 .IX Item "--endian={big|little}"
285 .PD
286 Specify the endianness of the object files. This only affects
287 disassembly. This can be useful when disassembling a file format which
288 does not describe endianness information, such as S\-records.
289 .IP "\fB\-f\fR" 4
290 .IX Item "-f"
291 .PD 0
292 .IP "\fB\-\-file\-headers\fR" 4
293 .IX Item "--file-headers"
294 .PD
295 Display summary information from the overall header of
296 each of the \fIobjfile\fR files.
297 .IP "\fB\-F\fR" 4
298 .IX Item "-F"
299 .PD 0
300 .IP "\fB\-\-file\-offsets\fR" 4
301 .IX Item "--file-offsets"
302 .PD
303 When disassembling sections, whenever a symbol is displayed, also
304 display the file offset of the region of data that is about to be
305 dumped. If zeroes are being skipped, then when disassembly resumes,
306 tell the user how many zeroes were skipped and the file offset of the
307 location from where the disassembly resumes. When dumping sections,
308 display the file offset of the location from where the dump starts.
309 .IP "\fB\-\-file\-start\-context\fR" 4
310 .IX Item "--file-start-context"
311 Specify that when displaying interlisted source code/disassembly
312 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
313 context to the start of the file.
314 .IP "\fB\-h\fR" 4
315 .IX Item "-h"
316 .PD 0
317 .IP "\fB\-\-section\-headers\fR" 4
318 .IX Item "--section-headers"
319 .IP "\fB\-\-headers\fR" 4
320 .IX Item "--headers"
321 .PD
322 Display summary information from the section headers of the
323 object file.
324 .Sp
325 File segments may be relocated to nonstandard addresses, for example by
326 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
327 \&\fBld\fR. However, some object file formats, such as a.out, do not
328 store the starting address of the file segments. In those situations,
329 although \fBld\fR relocates the sections correctly, using \fBobjdump
330 \&\-h\fR to list the file section headers cannot show the correct addresses.
331 Instead, it shows the usual addresses, which are implicit for the
332 target.
333 .IP "\fB\-H\fR" 4
334 .IX Item "-H"
335 .PD 0
336 .IP "\fB\-\-help\fR" 4
337 .IX Item "--help"
338 .PD
339 Print a summary of the options to \fBobjdump\fR and exit.
340 .IP "\fB\-i\fR" 4
341 .IX Item "-i"
342 .PD 0
343 .IP "\fB\-\-info\fR" 4
344 .IX Item "--info"
345 .PD
346 Display a list showing all architectures and object formats available
347 for specification with \fB\-b\fR or \fB\-m\fR.
348 .IP "\fB\-j\fR \fIname\fR" 4
349 .IX Item "-j name"
350 .PD 0
351 .IP "\fB\-\-section=\fR\fIname\fR" 4
352 .IX Item "--section=name"
353 .PD
354 Display information only for section \fIname\fR.
355 .IP "\fB\-l\fR" 4
356 .IX Item "-l"
357 .PD 0
358 .IP "\fB\-\-line\-numbers\fR" 4
359 .IX Item "--line-numbers"
360 .PD
361 Label the display (using debugging information) with the filename and
362 source line numbers corresponding to the object code or relocs shown.
363 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
364 .IP "\fB\-m\fR \fImachine\fR" 4
365 .IX Item "-m machine"
366 .PD 0
367 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
368 .IX Item "--architecture=machine"
369 .PD
370 Specify the architecture to use when disassembling object files. This
371 can be useful when disassembling object files which do not describe
372 architecture information, such as S\-records. You can list the available
373 architectures with the \fB\-i\fR option.
374 .IP "\fB\-M\fR \fIoptions\fR" 4
375 .IX Item "-M options"
376 .PD 0
377 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
378 .IX Item "--disassembler-options=options"
379 .PD
380 Pass target specific information to the disassembler. Only supported on
381 some targets. If it is necessary to specify more than one
382 disassembler option then multiple \fB\-M\fR options can be used or
383 can be placed together into a comma separated list.
384 .Sp
385 If the target is an \s-1ARM\s0 architecture then this switch can be used to
386 select which register name set is used during disassembler. Specifying
387 \&\fB\-M reg-names-std\fR (the default) will select the register names as
388 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
389 \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying
390 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
391 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
392 just use \fBr\fR followed by the register number.
393 .Sp
394 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
395 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
396 use the ARM/Thumb Procedure Call Standard naming conventions. (Either
397 with the normal register names or the special register names).
398 .Sp
399 This option can also be used for \s-1ARM\s0 architectures to force the
400 disassembler to interpret all instructions as Thumb instructions by
401 using the switch \fB\-\-disassembler\-options=force\-thumb\fR. This can be
402 useful when attempting to disassemble thumb code produced by other
403 compilers.
404 .Sp
405 For the x86, some of the options duplicate functions of the \fB\-m\fR
406 switch, but allow finer grained control. Multiple selections from the
407 following may be specified as a comma separated string.
408 \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for
409 the given architecture. \fBintel\fR and \fBatt\fR select between
410 intel syntax mode and \s-1AT&T\s0 syntax mode.
411 \&\fBintel-mnemonic\fR and \fBatt-mnemonic\fR select between
412 intel mnemonic mode and \s-1AT&T\s0 mnemonic mode. \fBintel-mnemonic\fR
413 implies \fBintel\fR and \fBatt-mnemonic\fR implies \fBatt\fR.
414 \&\fBaddr64\fR, \fBaddr32\fR,
415 \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default
416 address size and operand size. These four options will be overridden if
417 \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the
418 option string. Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode,
419 instructs the disassembler to print a mnemonic suffix even when the
420 suffix could be inferred by the operands.
421 .Sp
422 For \s-1PPC\s0, \fBbooke\fR, \fBbooke32\fR and \fBbooke64\fR select
423 disassembly of BookE instructions. \fB32\fR and \fB64\fR select
424 PowerPC and PowerPC64 disassembly, respectively. \fBe300\fR
425 selects disassembly for the e300 family. \fB440\fR selects
426 disassembly for the PowerPC 440. \fBppcps\fR selects disassembly
427 for the paired single instructions of the \s-1PPC750CL\s0.
428 .Sp
429 For \s-1MIPS\s0, this option controls the printing of instruction mnemonic
430 names and register names in disassembled instructions. Multiple
431 selections from the following may be specified as a comma separated
432 string, and invalid options are ignored:
433 .RS 4
434 .ie n .IP """no\-aliases""" 4
435 .el .IP "\f(CWno\-aliases\fR" 4
436 .IX Item "no-aliases"
437 Print the 'raw' instruction mnemonic instead of some pseudo
438 instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move',
439 \&'sll' instead of 'nop', etc.
440 .ie n .IP """gpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
441 .el .IP "\f(CWgpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
442 .IX Item "gpr-names=ABI"
443 Print \s-1GPR\s0 (general\-purpose register) names as appropriate
444 for the specified \s-1ABI\s0. By default, \s-1GPR\s0 names are selected according to
445 the \s-1ABI\s0 of the binary being disassembled.
446 .ie n .IP """fpr\-names=\f(CI\s-1ABI\s0\f(CW""" 4
447 .el .IP "\f(CWfpr\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
448 .IX Item "fpr-names=ABI"
449 Print \s-1FPR\s0 (floating\-point register) names as
450 appropriate for the specified \s-1ABI\s0. By default, \s-1FPR\s0 numbers are printed
451 rather than names.
452 .ie n .IP """cp0\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
453 .el .IP "\f(CWcp0\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
454 .IX Item "cp0-names=ARCH"
455 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
456 as appropriate for the \s-1CPU\s0 or architecture specified by
457 \&\fI\s-1ARCH\s0\fR. By default, \s-1CP0\s0 register names are selected according to
458 the architecture and \s-1CPU\s0 of the binary being disassembled.
459 .ie n .IP """hwr\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
460 .el .IP "\f(CWhwr\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
461 .IX Item "hwr-names=ARCH"
462 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
463 as appropriate for the \s-1CPU\s0 or architecture specified by
464 \&\fI\s-1ARCH\s0\fR. By default, \s-1HWR\s0 names are selected according to
465 the architecture and \s-1CPU\s0 of the binary being disassembled.
466 .ie n .IP """reg\-names=\f(CI\s-1ABI\s0\f(CW""" 4
467 .el .IP "\f(CWreg\-names=\f(CI\s-1ABI\s0\f(CW\fR" 4
468 .IX Item "reg-names=ABI"
469 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0.
470 .ie n .IP """reg\-names=\f(CI\s-1ARCH\s0\f(CW""" 4
471 .el .IP "\f(CWreg\-names=\f(CI\s-1ARCH\s0\f(CW\fR" 4
472 .IX Item "reg-names=ARCH"
473 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
474 as appropriate for the selected \s-1CPU\s0 or architecture.
475 .RE
476 .RS 4
477 .Sp
478 For any of the options listed above, \fI\s-1ABI\s0\fR or
479 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
480 rather than names, for the selected types of registers.
481 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
482 the \fB\-\-help\fR option.
483 .Sp
484 For \s-1VAX\s0, you can specify function entry addresses with \fB\-M
485 entry:0xf00ba\fR. You can use this multiple times to properly
486 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
487 \&\s-1ROM\s0 dumps). In these cases, the function entry mask would otherwise
488 be decoded as \s-1VAX\s0 instructions, which would probably lead the rest
489 of the function being wrongly disassembled.
490 .RE
491 .IP "\fB\-p\fR" 4
492 .IX Item "-p"
493 .PD 0
494 .IP "\fB\-\-private\-headers\fR" 4
495 .IX Item "--private-headers"
496 .PD
497 Print information that is specific to the object file format. The exact
498 information printed depends upon the object file format. For some
499 object file formats, no additional information is printed.
500 .IP "\fB\-r\fR" 4
501 .IX Item "-r"
502 .PD 0
503 .IP "\fB\-\-reloc\fR" 4
504 .IX Item "--reloc"
505 .PD
506 Print the relocation entries of the file. If used with \fB\-d\fR or
507 \&\fB\-D\fR, the relocations are printed interspersed with the
508 disassembly.
509 .IP "\fB\-R\fR" 4
510 .IX Item "-R"
511 .PD 0
512 .IP "\fB\-\-dynamic\-reloc\fR" 4
513 .IX Item "--dynamic-reloc"
514 .PD
515 Print the dynamic relocation entries of the file. This is only
516 meaningful for dynamic objects, such as certain types of shared
517 libraries.
518 .IP "\fB\-s\fR" 4
519 .IX Item "-s"
520 .PD 0
521 .IP "\fB\-\-full\-contents\fR" 4
522 .IX Item "--full-contents"
523 .PD
524 Display the full contents of any sections requested. By default all
525 non-empty sections are displayed.
526 .IP "\fB\-S\fR" 4
527 .IX Item "-S"
528 .PD 0
529 .IP "\fB\-\-source\fR" 4
530 .IX Item "--source"
531 .PD
532 Display source code intermixed with disassembly, if possible. Implies
533 \&\fB\-d\fR.
534 .IP "\fB\-\-show\-raw\-insn\fR" 4
535 .IX Item "--show-raw-insn"
536 When disassembling instructions, print the instruction in hex as well as
537 in symbolic form. This is the default except when
538 \&\fB\-\-prefix\-addresses\fR is used.
539 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
540 .IX Item "--no-show-raw-insn"
541 When disassembling instructions, do not print the instruction bytes.
542 This is the default when \fB\-\-prefix\-addresses\fR is used.
543 .IP "\fB\-W\fR" 4
544 .IX Item "-W"
545 .PD 0
546 .IP "\fB\-\-dwarf\fR" 4
547 .IX Item "--dwarf"
548 .PD
549 Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any
550 are present.
551 .IP "\fB\-G\fR" 4
552 .IX Item "-G"
553 .PD 0
554 .IP "\fB\-\-stabs\fR" 4
555 .IX Item "--stabs"
556 .PD
557 Display the full contents of any sections requested. Display the
558 contents of the .stab and .stab.index and .stab.excl sections from an
559 \&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which
560 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
561 section. In most other file formats, debugging symbol-table entries are
562 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
563 output.
564 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
565 .IX Item "--start-address=address"
566 Start displaying data at the specified address. This affects the output
567 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
568 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
569 .IX Item "--stop-address=address"
570 Stop displaying data at the specified address. This affects the output
571 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
572 .IP "\fB\-t\fR" 4
573 .IX Item "-t"
574 .PD 0
575 .IP "\fB\-\-syms\fR" 4
576 .IX Item "--syms"
577 .PD
578 Print the symbol table entries of the file.
579 This is similar to the information provided by the \fBnm\fR program,
580 although the display format is different. The format of the output
581 depends upon the format of the file being dumped, but there are two main
582 types. One looks like this:
583 .Sp
584 .Vb 2
585 \& [ 4](sec 3)(fl 0x00)(ty 0)(scl 3) (nx 1) 0x00000000 .bss
586 \& [ 6](sec 1)(fl 0x00)(ty 0)(scl 2) (nx 0) 0x00000000 fred
587 .Ve
588 .Sp
589 where the number inside the square brackets is the number of the entry
590 in the symbol table, the \fIsec\fR number is the section number, the
591 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
592 symbol's type, the \fIscl\fR number is the symbol's storage class and
593 the \fInx\fR value is the number of auxilary entries associated with
594 the symbol. The last two fields are the symbol's value and its name.
595 .Sp
596 The other common output format, usually seen with \s-1ELF\s0 based files,
597 looks like this:
598 .Sp
599 .Vb 2
600 \& 00000000 l d .bss 00000000 .bss
601 \& 00000000 g .text 00000000 fred
602 .Ve
603 .Sp
604 Here the first number is the symbol's value (sometimes refered to as
605 its address). The next field is actually a set of characters and
606 spaces indicating the flag bits that are set on the symbol. These
607 characters are described below. Next is the section with which the
608 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
609 not connected with any section), or \fI*UND*\fR if the section is
610 referenced in the file being dumped, but not defined there.
611 .Sp
612 After the section name comes another field, a number, which for common
613 symbols is the alignment and for other symbol is the size. Finally
614 the symbol's name is displayed.
615 .Sp
616 The flag characters are divided into 7 groups as follows:
617 .RS 4
618 .ie n .IP """l""" 4
619 .el .IP "\f(CWl\fR" 4
620 .IX Item "l"
621 .PD 0
622 .ie n .IP """g""" 4
623 .el .IP "\f(CWg\fR" 4
624 .IX Item "g"
625 .ie n .IP """!""" 4
626 .el .IP "\f(CW!\fR" 4
627 .IX Item "!"
628 .PD
629 The symbol is local (l), global (g), neither (a space) or both (!). A
630 symbol can be neither local or global for a variety of reasons, e.g.,
631 because it is used for debugging, but it is probably an indication of
632 a bug if it is ever both local and global.
633 .ie n .IP """w""" 4
634 .el .IP "\f(CWw\fR" 4
635 .IX Item "w"
636 The symbol is weak (w) or strong (a space).
637 .ie n .IP """C""" 4
638 .el .IP "\f(CWC\fR" 4
639 .IX Item "C"
640 The symbol denotes a constructor (C) or an ordinary symbol (a space).
641 .ie n .IP """W""" 4
642 .el .IP "\f(CWW\fR" 4
643 .IX Item "W"
644 The symbol is a warning (W) or a normal symbol (a space). A warning
645 symbol's name is a message to be displayed if the symbol following the
646 warning symbol is ever referenced.
647 .ie n .IP """I""" 4
648 .el .IP "\f(CWI\fR" 4
649 .IX Item "I"
650 The symbol is an indirect reference to another symbol (I) or a normal
651 symbol (a space).
652 .ie n .IP """d""" 4
653 .el .IP "\f(CWd\fR" 4
654 .IX Item "d"
655 .PD 0
656 .ie n .IP """D""" 4
657 .el .IP "\f(CWD\fR" 4
658 .IX Item "D"
659 .PD
660 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
661 normal symbol (a space).
662 .ie n .IP """F""" 4
663 .el .IP "\f(CWF\fR" 4
664 .IX Item "F"
665 .PD 0
666 .ie n .IP """f""" 4
667 .el .IP "\f(CWf\fR" 4
668 .IX Item "f"
669 .ie n .IP """O""" 4
670 .el .IP "\f(CWO\fR" 4
671 .IX Item "O"
672 .PD
673 The symbol is the name of a function (F) or a file (f) or an object
674 (O) or just a normal symbol (a space).
675 .RE
676 .RS 4
677 .RE
678 .IP "\fB\-T\fR" 4
679 .IX Item "-T"
680 .PD 0
681 .IP "\fB\-\-dynamic\-syms\fR" 4
682 .IX Item "--dynamic-syms"
683 .PD
684 Print the dynamic symbol table entries of the file. This is only
685 meaningful for dynamic objects, such as certain types of shared
686 libraries. This is similar to the information provided by the \fBnm\fR
687 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
688 .IP "\fB\-\-special\-syms\fR" 4
689 .IX Item "--special-syms"
690 When displaying symbols include those which the target considers to be
691 special in some way and which would not normally be of interest to the
692 user.
693 .IP "\fB\-V\fR" 4
694 .IX Item "-V"
695 .PD 0
696 .IP "\fB\-\-version\fR" 4
697 .IX Item "--version"
698 .PD
699 Print the version number of \fBobjdump\fR and exit.
700 .IP "\fB\-x\fR" 4
701 .IX Item "-x"
702 .PD 0
703 .IP "\fB\-\-all\-headers\fR" 4
704 .IX Item "--all-headers"
705 .PD
706 Display all available header information, including the symbol table and
707 relocation entries. Using \fB\-x\fR is equivalent to specifying all of
708 \&\fB\-a \-f \-h \-p \-r \-t\fR.
709 .IP "\fB\-w\fR" 4
710 .IX Item "-w"
711 .PD 0
712 .IP "\fB\-\-wide\fR" 4
713 .IX Item "--wide"
714 .PD
715 Format some lines for output devices that have more than 80 columns.
716 Also do not truncate symbol names when they are displayed.
717 .IP "\fB\-z\fR" 4
718 .IX Item "-z"
719 .PD 0
720 .IP "\fB\-\-disassemble\-zeroes\fR" 4
721 .IX Item "--disassemble-zeroes"
722 .PD
723 Normally the disassembly output will skip blocks of zeroes. This
724 option directs the disassembler to disassemble those blocks, just like
725 any other data.
726 .IP "\fB@\fR\fIfile\fR" 4
727 .IX Item "@file"
728 Read command-line options from \fIfile\fR. The options read are
729 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
730 does not exist, or cannot be read, then the option will be treated
731 literally, and not removed.
732 .Sp
733 Options in \fIfile\fR are separated by whitespace. A whitespace
734 character may be included in an option by surrounding the entire
735 option in either single or double quotes. Any character (including a
736 backslash) may be included by prefixing the character to be included
737 with a backslash. The \fIfile\fR may itself contain additional
738 @\fIfile\fR options; any such options will be processed recursively.
739 .SH "SEE ALSO"
740 .IX Header "SEE ALSO"
741 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
742 .SH "COPYRIGHT"
743 .IX Header "COPYRIGHT"
744 Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
745 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
746 .PP
747 Permission is granted to copy, distribute and/or modify this document
748 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2
749 or any later version published by the Free Software Foundation;
750 with no Invariant Sections, with no Front-Cover Texts, and with no
751 Back-Cover Texts. A copy of the license is included in the
752 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".