1 .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
9 .de Vb \" Begin verbatim text
14 .de Ve \" End verbatim text
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
53 . tm Index:\\$1\t\\n%\t"\\$2"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80 . \" simple accents for nroff and troff
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
124 .\" ========================================================================
126 .IX Title "OBJDUMP 1"
127 .TH OBJDUMP 1 "2013-11-18" "binutils-2.23.91" "GNU Development Tools"
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
133 objdump \- display information from object files.
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\-P\fR \fIoptions\fR|\fB\-\-private=\fR\fIoptions\fR]
157 [\fB\-r\fR|\fB\-\-reloc\fR]
158 [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
159 [\fB\-s\fR|\fB\-\-full\-contents\fR]
160 [\fB\-W[lLiaprmfFsoRt]\fR|
161 \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]]
162 [\fB\-G\fR|\fB\-\-stabs\fR]
163 [\fB\-t\fR|\fB\-\-syms\fR]
164 [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
165 [\fB\-x\fR|\fB\-\-all\-headers\fR]
166 [\fB\-w\fR|\fB\-\-wide\fR]
167 [\fB\-\-start\-address=\fR\fIaddress\fR]
168 [\fB\-\-stop\-address=\fR\fIaddress\fR]
169 [\fB\-\-prefix\-addresses\fR]
170 [\fB\-\-[no\-]show\-raw\-insn\fR]
171 [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
172 [\fB\-\-special\-syms\fR]
173 [\fB\-\-prefix=\fR\fIprefix\fR]
174 [\fB\-\-prefix\-strip=\fR\fIlevel\fR]
175 [\fB\-\-insn\-width=\fR\fIwidth\fR]
176 [\fB\-V\fR|\fB\-\-version\fR]
177 [\fB\-H\fR|\fB\-\-help\fR]
180 .IX Header "DESCRIPTION"
181 \&\fBobjdump\fR displays information about one or more object files.
182 The options control what particular information to display. This
183 information is mostly useful to programmers who are working on the
184 compilation tools, as opposed to programmers who just want their
185 program to compile and work.
187 \&\fIobjfile\fR... are the object files to be examined. When you
188 specify archives, \fBobjdump\fR shows information on each of the member
192 The long and short forms of options, shown here as alternatives, are
193 equivalent. At least one option from the list
194 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-P,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
198 .IP "\fB\-\-archive\-header\fR" 4
199 .IX Item "--archive-header"
201 If any of the \fIobjfile\fR files are archives, display the archive
202 header information (in a format similar to \fBls \-l\fR). Besides the
203 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
204 the object file format of each archive member.
205 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
206 .IX Item "--adjust-vma=offset"
207 When dumping information, first add \fIoffset\fR to all the section
208 addresses. This is useful if the section addresses do not correspond to
209 the symbol table, which can happen when putting sections at particular
210 addresses when using a format which can not represent section addresses,
212 .IP "\fB\-b\fR \fIbfdname\fR" 4
213 .IX Item "-b bfdname"
215 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
216 .IX Item "--target=bfdname"
218 Specify that the object-code format for the object files is
219 \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
220 automatically recognize many formats.
225 \& objdump \-b oasys \-m vax \-h fu.o
228 displays summary information from the section headers (\fB\-h\fR) of
229 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
230 file in the format produced by Oasys compilers. You can list the
231 formats available with the \fB\-i\fR option.
235 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
236 .IX Item "--demangle[=style]"
238 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
239 Besides removing any initial underscore prepended by the system, this
240 makes \*(C+ function names readable. Different compilers have different
241 mangling styles. The optional demangling style argument can be used to
242 choose an appropriate demangling style for your compiler.
246 .IP "\fB\-\-debugging\fR" 4
247 .IX Item "--debugging"
249 Display debugging information. This attempts to parse \s-1STABS\s0 and \s-1IEEE\s0
250 debugging format information stored in the file and print it out using
251 a C like syntax. If neither of these formats are found this option
252 falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
257 .IP "\fB\-\-debugging\-tags\fR" 4
258 .IX Item "--debugging-tags"
260 Like \fB\-g\fR, but the information is generated in a format compatible
265 .IP "\fB\-\-disassemble\fR" 4
266 .IX Item "--disassemble"
268 Display the assembler mnemonics for the machine instructions from
269 \&\fIobjfile\fR. This option only disassembles those sections which are
270 expected to contain instructions.
274 .IP "\fB\-\-disassemble\-all\fR" 4
275 .IX Item "--disassemble-all"
277 Like \fB\-d\fR, but disassemble the contents of all sections, not just
278 those expected to contain instructions.
280 If the target is an \s-1ARM\s0 architecture this switch also has the effect
281 of forcing the disassembler to decode pieces of data found in code
282 sections as if they were instructions.
283 .IP "\fB\-\-prefix\-addresses\fR" 4
284 .IX Item "--prefix-addresses"
285 When disassembling, print the complete address on each line. This is
286 the older disassembly format.
292 .IP "\fB\-\-endian={big|little}\fR" 4
293 .IX Item "--endian={big|little}"
295 Specify the endianness of the object files. This only affects
296 disassembly. This can be useful when disassembling a file format which
297 does not describe endianness information, such as S\-records.
301 .IP "\fB\-\-file\-headers\fR" 4
302 .IX Item "--file-headers"
304 Display summary information from the overall header of
305 each of the \fIobjfile\fR files.
309 .IP "\fB\-\-file\-offsets\fR" 4
310 .IX Item "--file-offsets"
312 When disassembling sections, whenever a symbol is displayed, also
313 display the file offset of the region of data that is about to be
314 dumped. If zeroes are being skipped, then when disassembly resumes,
315 tell the user how many zeroes were skipped and the file offset of the
316 location from where the disassembly resumes. When dumping sections,
317 display the file offset of the location from where the dump starts.
318 .IP "\fB\-\-file\-start\-context\fR" 4
319 .IX Item "--file-start-context"
320 Specify that when displaying interlisted source code/disassembly
321 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
322 context to the start of the file.
326 .IP "\fB\-\-section\-headers\fR" 4
327 .IX Item "--section-headers"
328 .IP "\fB\-\-headers\fR" 4
331 Display summary information from the section headers of the
334 File segments may be relocated to nonstandard addresses, for example by
335 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
336 \&\fBld\fR. However, some object file formats, such as a.out, do not
337 store the starting address of the file segments. In those situations,
338 although \fBld\fR relocates the sections correctly, using \fBobjdump
339 \&\-h\fR to list the file section headers cannot show the correct addresses.
340 Instead, it shows the usual addresses, which are implicit for the
345 .IP "\fB\-\-help\fR" 4
348 Print a summary of the options to \fBobjdump\fR and exit.
352 .IP "\fB\-\-info\fR" 4
355 Display a list showing all architectures and object formats available
356 for specification with \fB\-b\fR or \fB\-m\fR.
357 .IP "\fB\-j\fR \fIname\fR" 4
360 .IP "\fB\-\-section=\fR\fIname\fR" 4
361 .IX Item "--section=name"
363 Display information only for section \fIname\fR.
367 .IP "\fB\-\-line\-numbers\fR" 4
368 .IX Item "--line-numbers"
370 Label the display (using debugging information) with the filename and
371 source line numbers corresponding to the object code or relocs shown.
372 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
373 .IP "\fB\-m\fR \fImachine\fR" 4
374 .IX Item "-m machine"
376 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
377 .IX Item "--architecture=machine"
379 Specify the architecture to use when disassembling object files. This
380 can be useful when disassembling object files which do not describe
381 architecture information, such as S\-records. You can list the available
382 architectures with the \fB\-i\fR option.
384 If the target is an \s-1ARM\s0 architecture then this switch has an
385 additional effect. It restricts the disassembly to only those
386 instructions supported by the architecture specified by \fImachine\fR.
387 If it is necessary to use this switch because the input file does not
388 contain any architecture information, but it is also desired to
389 disassemble all the instructions use \fB\-marm\fR.
390 .IP "\fB\-M\fR \fIoptions\fR" 4
391 .IX Item "-M options"
393 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
394 .IX Item "--disassembler-options=options"
396 Pass target specific information to the disassembler. Only supported on
397 some targets. If it is necessary to specify more than one
398 disassembler option then multiple \fB\-M\fR options can be used or
399 can be placed together into a comma separated list.
401 If the target is an \s-1ARM\s0 architecture then this switch can be used to
402 select which register name set is used during disassembler. Specifying
403 \&\fB\-M reg-names-std\fR (the default) will select the register names as
404 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
405 \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying
406 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
407 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
408 just use \fBr\fR followed by the register number.
410 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
411 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
412 use the ARM/Thumb Procedure Call Standard naming conventions. (Either
413 with the normal register names or the special register names).
415 This option can also be used for \s-1ARM\s0 architectures to force the
416 disassembler to interpret all instructions as Thumb instructions by
417 using the switch \fB\-\-disassembler\-options=force\-thumb\fR. This can be
418 useful when attempting to disassemble thumb code produced by other
421 For the x86, some of the options duplicate functions of the \fB\-m\fR
422 switch, but allow finer grained control. Multiple selections from the
423 following may be specified as a comma separated string.
424 \&\fBx86\-64\fR, \fBi386\fR and \fBi8086\fR select disassembly for
425 the given architecture. \fBintel\fR and \fBatt\fR select between
426 intel syntax mode and \s-1AT&T\s0 syntax mode.
427 \&\fBintel-mnemonic\fR and \fBatt-mnemonic\fR select between
428 intel mnemonic mode and \s-1AT&T\s0 mnemonic mode. \fBintel-mnemonic\fR
429 implies \fBintel\fR and \fBatt-mnemonic\fR implies \fBatt\fR.
430 \&\fBaddr64\fR, \fBaddr32\fR,
431 \&\fBaddr16\fR, \fBdata32\fR and \fBdata16\fR specify the default
432 address size and operand size. These four options will be overridden if
433 \&\fBx86\-64\fR, \fBi386\fR or \fBi8086\fR appear later in the
434 option string. Lastly, \fBsuffix\fR, when in \s-1AT&T\s0 mode,
435 instructs the disassembler to print a mnemonic suffix even when the
436 suffix could be inferred by the operands.
438 For PowerPC, \fBbooke\fR controls the disassembly of BookE
439 instructions. \fB32\fR and \fB64\fR select PowerPC and
440 PowerPC64 disassembly, respectively. \fBe300\fR selects
441 disassembly for the e300 family. \fB440\fR selects disassembly for
442 the PowerPC 440. \fBppcps\fR selects disassembly for the paired
443 single instructions of the \s-1PPC750CL\s0.
445 For \s-1MIPS\s0, this option controls the printing of instruction mnemonic
446 names and register names in disassembled instructions. Multiple
447 selections from the following may be specified as a comma separated
448 string, and invalid options are ignored:
450 .ie n .IP """no\-aliases""" 4
451 .el .IP "\f(CWno\-aliases\fR" 4
452 .IX Item "no-aliases"
453 Print the 'raw' instruction mnemonic instead of some pseudo
454 instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move',
455 \&'sll' instead of 'nop', etc.
456 .ie n .IP """virt""" 4
457 .el .IP "\f(CWvirt\fR" 4
459 Disassemble the virtualization \s-1ASE\s0 instructions.
460 .ie n .IP """gpr\-names=\f(CIABI\f(CW""" 4
461 .el .IP "\f(CWgpr\-names=\f(CIABI\f(CW\fR" 4
462 .IX Item "gpr-names=ABI"
463 Print \s-1GPR\s0 (general-purpose register) names as appropriate
464 for the specified \s-1ABI\s0. By default, \s-1GPR\s0 names are selected according to
465 the \s-1ABI\s0 of the binary being disassembled.
466 .ie n .IP """fpr\-names=\f(CIABI\f(CW""" 4
467 .el .IP "\f(CWfpr\-names=\f(CIABI\f(CW\fR" 4
468 .IX Item "fpr-names=ABI"
469 Print \s-1FPR\s0 (floating-point register) names as
470 appropriate for the specified \s-1ABI\s0. By default, \s-1FPR\s0 numbers are printed
472 .ie n .IP """cp0\-names=\f(CIARCH\f(CW""" 4
473 .el .IP "\f(CWcp0\-names=\f(CIARCH\f(CW\fR" 4
474 .IX Item "cp0-names=ARCH"
475 Print \s-1CP0\s0 (system control coprocessor; coprocessor 0) register names
476 as appropriate for the \s-1CPU\s0 or architecture specified by
477 \&\fI\s-1ARCH\s0\fR. By default, \s-1CP0\s0 register names are selected according to
478 the architecture and \s-1CPU\s0 of the binary being disassembled.
479 .ie n .IP """hwr\-names=\f(CIARCH\f(CW""" 4
480 .el .IP "\f(CWhwr\-names=\f(CIARCH\f(CW\fR" 4
481 .IX Item "hwr-names=ARCH"
482 Print \s-1HWR\s0 (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
483 as appropriate for the \s-1CPU\s0 or architecture specified by
484 \&\fI\s-1ARCH\s0\fR. By default, \s-1HWR\s0 names are selected according to
485 the architecture and \s-1CPU\s0 of the binary being disassembled.
486 .ie n .IP """reg\-names=\f(CIABI\f(CW""" 4
487 .el .IP "\f(CWreg\-names=\f(CIABI\f(CW\fR" 4
488 .IX Item "reg-names=ABI"
489 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI\s0.
490 .ie n .IP """reg\-names=\f(CIARCH\f(CW""" 4
491 .el .IP "\f(CWreg\-names=\f(CIARCH\f(CW\fR" 4
492 .IX Item "reg-names=ARCH"
493 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
494 as appropriate for the selected \s-1CPU\s0 or architecture.
498 For any of the options listed above, \fI\s-1ABI\s0\fR or
499 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
500 rather than names, for the selected types of registers.
501 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
502 the \fB\-\-help\fR option.
504 For \s-1VAX\s0, you can specify function entry addresses with \fB\-M
505 entry:0xf00ba\fR. You can use this multiple times to properly
506 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
507 \&\s-1ROM\s0 dumps). In these cases, the function entry mask would otherwise
508 be decoded as \s-1VAX\s0 instructions, which would probably lead the rest
509 of the function being wrongly disassembled.
514 .IP "\fB\-\-private\-headers\fR" 4
515 .IX Item "--private-headers"
517 Print information that is specific to the object file format. The exact
518 information printed depends upon the object file format. For some
519 object file formats, no additional information is printed.
520 .IP "\fB\-P\fR \fIoptions\fR" 4
521 .IX Item "-P options"
523 .IP "\fB\-\-private=\fR\fIoptions\fR" 4
524 .IX Item "--private=options"
526 Print information that is specific to the object file format. The
527 argument \fIoptions\fR is a comma separated list that depends on the
528 format (the lists of options is displayed with the help).
530 For \s-1XCOFF\s0, the available options are: \fBheader\fR, \fBaout\fR,
531 \&\fBsections\fR, \fBsyms\fR, \fBrelocs\fR, \fBlineno\fR,
532 \&\fBloader\fR, \fBexcept\fR, \fBtypchk\fR, \fBtraceback\fR,
533 \&\fBtoc\fR and \fBldinfo\fR.
537 .IP "\fB\-\-reloc\fR" 4
540 Print the relocation entries of the file. If used with \fB\-d\fR or
541 \&\fB\-D\fR, the relocations are printed interspersed with the
546 .IP "\fB\-\-dynamic\-reloc\fR" 4
547 .IX Item "--dynamic-reloc"
549 Print the dynamic relocation entries of the file. This is only
550 meaningful for dynamic objects, such as certain types of shared
551 libraries. As for \fB\-r\fR, if used with \fB\-d\fR or
552 \&\fB\-D\fR, the relocations are printed interspersed with the
557 .IP "\fB\-\-full\-contents\fR" 4
558 .IX Item "--full-contents"
560 Display the full contents of any sections requested. By default all
561 non-empty sections are displayed.
565 .IP "\fB\-\-source\fR" 4
568 Display source code intermixed with disassembly, if possible. Implies
570 .IP "\fB\-\-prefix=\fR\fIprefix\fR" 4
571 .IX Item "--prefix=prefix"
572 Specify \fIprefix\fR to add to the absolute paths when used with
574 .IP "\fB\-\-prefix\-strip=\fR\fIlevel\fR" 4
575 .IX Item "--prefix-strip=level"
576 Indicate how many initial directory names to strip off the hardwired
577 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
578 .IP "\fB\-\-show\-raw\-insn\fR" 4
579 .IX Item "--show-raw-insn"
580 When disassembling instructions, print the instruction in hex as well as
581 in symbolic form. This is the default except when
582 \&\fB\-\-prefix\-addresses\fR is used.
583 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
584 .IX Item "--no-show-raw-insn"
585 When disassembling instructions, do not print the instruction bytes.
586 This is the default when \fB\-\-prefix\-addresses\fR is used.
587 .IP "\fB\-\-insn\-width=\fR\fIwidth\fR" 4
588 .IX Item "--insn-width=width"
589 Display \fIwidth\fR bytes on a single line when disassembling
591 .IP "\fB\-W[lLiaprmfFsoRt]\fR" 4
592 .IX Item "-W[lLiaprmfFsoRt]"
594 .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
595 .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]"
597 Displays the contents of the debug sections in the file, if any are
598 present. If one of the optional letters or words follows the switch
599 then only data found in those specific sections will be dumped.
601 Note that there is no single letter option to display the content of
602 trace sections or .gdb_index.
604 Note: the output from the \fB=info\fR option can also be affected
605 by the options \fB\-\-dwarf\-depth\fR, the \fB\-\-dwarf\-start\fR and
606 the \fB\-\-dwarf\-check\fR.
607 .IP "\fB\-\-dwarf\-depth=\fR\fIn\fR" 4
608 .IX Item "--dwarf-depth=n"
609 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
610 This is only useful with \fB\-\-dwarf=info\fR. The default is
611 to print all DIEs; the special value 0 for \fIn\fR will also have this
614 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
615 levels will not be printed. The range for \fIn\fR is zero-based.
616 .IP "\fB\-\-dwarf\-start=\fR\fIn\fR" 4
617 .IX Item "--dwarf-start=n"
618 Print only DIEs beginning with the \s-1DIE\s0 numbered \fIn\fR. This is only
619 useful with \fB\-\-dwarf=info\fR.
621 If specified, this option will suppress printing of any header
622 information and all DIEs before the \s-1DIE\s0 numbered \fIn\fR. Only
623 siblings and children of the specified \s-1DIE\s0 will be printed.
625 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
626 .IP "\fB\-\-dwarf\-check\fR" 4
627 .IX Item "--dwarf-check"
628 Enable additional checks for consistency of Dwarf information.
632 .IP "\fB\-\-stabs\fR" 4
635 Display the full contents of any sections requested. Display the
636 contents of the .stab and .stab.index and .stab.excl sections from an
637 \&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which
638 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
639 section. In most other file formats, debugging symbol-table entries are
640 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
642 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
643 .IX Item "--start-address=address"
644 Start displaying data at the specified address. This affects the output
645 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
646 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
647 .IX Item "--stop-address=address"
648 Stop displaying data at the specified address. This affects the output
649 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
653 .IP "\fB\-\-syms\fR" 4
656 Print the symbol table entries of the file.
657 This is similar to the information provided by the \fBnm\fR program,
658 although the display format is different. The format of the output
659 depends upon the format of the file being dumped, but there are two main
660 types. One looks like this:
663 \& [ 4](sec 3)(fl 0x00)(ty 0)(scl 3) (nx 1) 0x00000000 .bss
664 \& [ 6](sec 1)(fl 0x00)(ty 0)(scl 2) (nx 0) 0x00000000 fred
667 where the number inside the square brackets is the number of the entry
668 in the symbol table, the \fIsec\fR number is the section number, the
669 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
670 symbol's type, the \fIscl\fR number is the symbol's storage class and
671 the \fInx\fR value is the number of auxilary entries associated with
672 the symbol. The last two fields are the symbol's value and its name.
674 The other common output format, usually seen with \s-1ELF\s0 based files,
678 \& 00000000 l d .bss 00000000 .bss
679 \& 00000000 g .text 00000000 fred
682 Here the first number is the symbol's value (sometimes refered to as
683 its address). The next field is actually a set of characters and
684 spaces indicating the flag bits that are set on the symbol. These
685 characters are described below. Next is the section with which the
686 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
687 not connected with any section), or \fI*UND*\fR if the section is
688 referenced in the file being dumped, but not defined there.
690 After the section name comes another field, a number, which for common
691 symbols is the alignment and for other symbol is the size. Finally
692 the symbol's name is displayed.
694 The flag characters are divided into 7 groups as follows:
697 .el .IP "\f(CWl\fR" 4
701 .el .IP "\f(CWg\fR" 4
704 .el .IP "\f(CWu\fR" 4
707 .el .IP "\f(CW!\fR" 4
710 The symbol is a local (l), global (g), unique global (u), neither
711 global nor local (a space) or both global and local (!). A
712 symbol can be neither local or global for a variety of reasons, e.g.,
713 because it is used for debugging, but it is probably an indication of
714 a bug if it is ever both local and global. Unique global symbols are
715 a \s-1GNU\s0 extension to the standard set of \s-1ELF\s0 symbol bindings. For such
716 a symbol the dynamic linker will make sure that in the entire process
717 there is just one symbol with this name and type in use.
719 .el .IP "\f(CWw\fR" 4
721 The symbol is weak (w) or strong (a space).
723 .el .IP "\f(CWC\fR" 4
725 The symbol denotes a constructor (C) or an ordinary symbol (a space).
727 .el .IP "\f(CWW\fR" 4
729 The symbol is a warning (W) or a normal symbol (a space). A warning
730 symbol's name is a message to be displayed if the symbol following the
731 warning symbol is ever referenced.
733 .el .IP "\f(CWI\fR" 4
737 .el .IP "\f(CWi\fR" 4
740 The symbol is an indirect reference to another symbol (I), a function
741 to be evaluated during reloc processing (i) or a normal symbol (a
744 .el .IP "\f(CWd\fR" 4
748 .el .IP "\f(CWD\fR" 4
751 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
752 normal symbol (a space).
754 .el .IP "\f(CWF\fR" 4
758 .el .IP "\f(CWf\fR" 4
761 .el .IP "\f(CWO\fR" 4
764 The symbol is the name of a function (F) or a file (f) or an object
765 (O) or just a normal symbol (a space).
772 .IP "\fB\-\-dynamic\-syms\fR" 4
773 .IX Item "--dynamic-syms"
775 Print the dynamic symbol table entries of the file. This is only
776 meaningful for dynamic objects, such as certain types of shared
777 libraries. This is similar to the information provided by the \fBnm\fR
778 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
779 .IP "\fB\-\-special\-syms\fR" 4
780 .IX Item "--special-syms"
781 When displaying symbols include those which the target considers to be
782 special in some way and which would not normally be of interest to the
787 .IP "\fB\-\-version\fR" 4
790 Print the version number of \fBobjdump\fR and exit.
794 .IP "\fB\-\-all\-headers\fR" 4
795 .IX Item "--all-headers"
797 Display all available header information, including the symbol table and
798 relocation entries. Using \fB\-x\fR is equivalent to specifying all of
799 \&\fB\-a \-f \-h \-p \-r \-t\fR.
803 .IP "\fB\-\-wide\fR" 4
806 Format some lines for output devices that have more than 80 columns.
807 Also do not truncate symbol names when they are displayed.
811 .IP "\fB\-\-disassemble\-zeroes\fR" 4
812 .IX Item "--disassemble-zeroes"
814 Normally the disassembly output will skip blocks of zeroes. This
815 option directs the disassembler to disassemble those blocks, just like
817 .IP "\fB@\fR\fIfile\fR" 4
819 Read command-line options from \fIfile\fR. The options read are
820 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
821 does not exist, or cannot be read, then the option will be treated
822 literally, and not removed.
824 Options in \fIfile\fR are separated by whitespace. A whitespace
825 character may be included in an option by surrounding the entire
826 option in either single or double quotes. Any character (including a
827 backslash) may be included by prefixing the character to be included
828 with a backslash. The \fIfile\fR may itself contain additional
829 @\fIfile\fR options; any such options will be processed recursively.
831 .IX Header "SEE ALSO"
832 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
834 .IX Header "COPYRIGHT"
835 Copyright (c) 1991\-2013 Free Software Foundation, Inc.
837 Permission is granted to copy, distribute and/or modify this document
838 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
839 or any later version published by the Free Software Foundation;
840 with no Invariant Sections, with no Front-Cover Texts, and with no
841 Back-Cover Texts. A copy of the license is included in the
842 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
tuxillo's projects / dragonfly.git / blob