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