OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-stable/] [binutils-2.20.1/] [binutils/] [doc/] [objdump.1] - Blame information for rev 818

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 205 julius
.\" 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 "2009-10-16" "binutils-2.20" "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[lLiaprmfFsoR]\fR|
168
         \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges]]
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[lLiaprmfFsoR]\fR" 4
581
.IX Item "-W[lLiaprmfFsoR]"
582
.PD 0
583
.IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges]\fR" 4
584
.IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges]"
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
.IP "\fB\-G\fR" 4
590
.IX Item "-G"
591
.PD 0
592
.IP "\fB\-\-stabs\fR" 4
593
.IX Item "--stabs"
594
.PD
595
Display the full contents of any sections requested.  Display the
596
contents of the .stab and .stab.index and .stab.excl sections from an
597
\&\s-1ELF\s0 file.  This is only useful on systems (such as Solaris 2.0) in which
598
\&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
599
section.  In most other file formats, debugging symbol-table entries are
600
interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
601
output.
602
.IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
603
.IX Item "--start-address=address"
604
Start displaying data at the specified address.  This affects the output
605
of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
606
.IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
607
.IX Item "--stop-address=address"
608
Stop displaying data at the specified address.  This affects the output
609
of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
610
.IP "\fB\-t\fR" 4
611
.IX Item "-t"
612
.PD 0
613
.IP "\fB\-\-syms\fR" 4
614
.IX Item "--syms"
615
.PD
616
Print the symbol table entries of the file.
617
This is similar to the information provided by the \fBnm\fR program,
618
although the display format is different.  The format of the output
619
depends upon the format of the file being dumped, but there are two main
620
types.  One looks like this:
621
.Sp
622
.Vb 2
623
\&        [  4](sec  3)(fl 0x00)(ty   0)(scl   3) (nx 1) 0x00000000 .bss
624
\&        [  6](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x00000000 fred
625
.Ve
626
.Sp
627
where the number inside the square brackets is the number of the entry
628
in the symbol table, the \fIsec\fR number is the section number, the
629
\&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
630
symbol's type, the \fIscl\fR number is the symbol's storage class and
631
the \fInx\fR value is the number of auxilary entries associated with
632
the symbol.  The last two fields are the symbol's value and its name.
633
.Sp
634
The other common output format, usually seen with \s-1ELF\s0 based files,
635
looks like this:
636
.Sp
637
.Vb 2
638
\&        00000000 l    d  .bss   00000000 .bss
639
\&        00000000 g       .text  00000000 fred
640
.Ve
641
.Sp
642
Here the first number is the symbol's value (sometimes refered to as
643
its address).  The next field is actually a set of characters and
644
spaces indicating the flag bits that are set on the symbol.  These
645
characters are described below.  Next is the section with which the
646
symbol is associated or \fI*ABS*\fR if the section is absolute (ie
647
not connected with any section), or \fI*UND*\fR if the section is
648
referenced in the file being dumped, but not defined there.
649
.Sp
650
After the section name comes another field, a number, which for common
651
symbols is the alignment and for other symbol is the size.  Finally
652
the symbol's name is displayed.
653
.Sp
654
The flag characters are divided into 7 groups as follows:
655
.RS 4
656
.ie n .IP """l""" 4
657
.el .IP "\f(CWl\fR" 4
658
.IX Item "l"
659
.PD 0
660
.ie n .IP """g""" 4
661
.el .IP "\f(CWg\fR" 4
662
.IX Item "g"
663
.ie n .IP """u""" 4
664
.el .IP "\f(CWu\fR" 4
665
.IX Item "u"
666
.ie n .IP """!""" 4
667
.el .IP "\f(CW!\fR" 4
668
.IX Item "!"
669
.PD
670
The symbol is a local (l), global (g), unique global (u), neither
671
global nor local (a space) or both global and local (!).  A
672
symbol can be neither local or global for a variety of reasons, e.g.,
673
because it is used for debugging, but it is probably an indication of
674
a bug if it is ever both local and global.  Unique global symbols are
675
a \s-1GNU\s0 extension to the standard set of \s-1ELF\s0 symbol bindings.  For such
676
a symbol the dynamic linker will make sure that in the entire process
677
there is just one symbol with this name and type in use.
678
.ie n .IP """w""" 4
679
.el .IP "\f(CWw\fR" 4
680
.IX Item "w"
681
The symbol is weak (w) or strong (a space).
682
.ie n .IP """C""" 4
683
.el .IP "\f(CWC\fR" 4
684
.IX Item "C"
685
The symbol denotes a constructor (C) or an ordinary symbol (a space).
686
.ie n .IP """W""" 4
687
.el .IP "\f(CWW\fR" 4
688
.IX Item "W"
689
The symbol is a warning (W) or a normal symbol (a space).  A warning
690
symbol's name is a message to be displayed if the symbol following the
691
warning symbol is ever referenced.
692
.ie n .IP """I""" 4
693
.el .IP "\f(CWI\fR" 4
694
.IX Item "I"
695
.PD 0
696
.ie n .IP """i""" 4
697
.el .IP "\f(CWi\fR" 4
698
.IX Item "i"
699
.PD
700
The symbol is an indirect reference to another symbol (I), a function
701
to be evaluated during reloc processing (i) or a normal symbol (a
702
space).
703
.ie n .IP """d""" 4
704
.el .IP "\f(CWd\fR" 4
705
.IX Item "d"
706
.PD 0
707
.ie n .IP """D""" 4
708
.el .IP "\f(CWD\fR" 4
709
.IX Item "D"
710
.PD
711
The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
712
normal symbol (a space).
713
.ie n .IP """F""" 4
714
.el .IP "\f(CWF\fR" 4
715
.IX Item "F"
716
.PD 0
717
.ie n .IP """f""" 4
718
.el .IP "\f(CWf\fR" 4
719
.IX Item "f"
720
.ie n .IP """O""" 4
721
.el .IP "\f(CWO\fR" 4
722
.IX Item "O"
723
.PD
724
The symbol is the name of a function (F) or a file (f) or an object
725
(O) or just a normal symbol (a space).
726
.RE
727
.RS 4
728
.RE
729
.IP "\fB\-T\fR" 4
730
.IX Item "-T"
731
.PD 0
732
.IP "\fB\-\-dynamic\-syms\fR" 4
733
.IX Item "--dynamic-syms"
734
.PD
735
Print the dynamic symbol table entries of the file.  This is only
736
meaningful for dynamic objects, such as certain types of shared
737
libraries.  This is similar to the information provided by the \fBnm\fR
738
program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
739
.IP "\fB\-\-special\-syms\fR" 4
740
.IX Item "--special-syms"
741
When displaying symbols include those which the target considers to be
742
special in some way and which would not normally be of interest to the
743
user.
744
.IP "\fB\-V\fR" 4
745
.IX Item "-V"
746
.PD 0
747
.IP "\fB\-\-version\fR" 4
748
.IX Item "--version"
749
.PD
750
Print the version number of \fBobjdump\fR and exit.
751
.IP "\fB\-x\fR" 4
752
.IX Item "-x"
753
.PD 0
754
.IP "\fB\-\-all\-headers\fR" 4
755
.IX Item "--all-headers"
756
.PD
757
Display all available header information, including the symbol table and
758
relocation entries.  Using \fB\-x\fR is equivalent to specifying all of
759
\&\fB\-a \-f \-h \-p \-r \-t\fR.
760
.IP "\fB\-w\fR" 4
761
.IX Item "-w"
762
.PD 0
763
.IP "\fB\-\-wide\fR" 4
764
.IX Item "--wide"
765
.PD
766
Format some lines for output devices that have more than 80 columns.
767
Also do not truncate symbol names when they are displayed.
768
.IP "\fB\-z\fR" 4
769
.IX Item "-z"
770
.PD 0
771
.IP "\fB\-\-disassemble\-zeroes\fR" 4
772
.IX Item "--disassemble-zeroes"
773
.PD
774
Normally the disassembly output will skip blocks of zeroes.  This
775
option directs the disassembler to disassemble those blocks, just like
776
any other data.
777
.IP "\fB@\fR\fIfile\fR" 4
778
.IX Item "@file"
779
Read command-line options from \fIfile\fR.  The options read are
780
inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
781
does not exist, or cannot be read, then the option will be treated
782
literally, and not removed.
783
.Sp
784
Options in \fIfile\fR are separated by whitespace.  A whitespace
785
character may be included in an option by surrounding the entire
786
option in either single or double quotes.  Any character (including a
787
backslash) may be included by prefixing the character to be included
788
with a backslash.  The \fIfile\fR may itself contain additional
789
@\fIfile\fR options; any such options will be processed recursively.
790
.SH "SEE ALSO"
791
.IX Header "SEE ALSO"
792
\&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
793
.SH "COPYRIGHT"
794
.IX Header "COPYRIGHT"
795
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
796
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
797
.PP
798
Permission is granted to copy, distribute and/or modify this document
799
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
800
or any later version published by the Free Software Foundation;
801
with no Invariant Sections, with no Front-Cover Texts, and with no
802
Back-Cover Texts.  A copy of the license is included in the
803
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.