1 .\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
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
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
49 .\" If the F register is turned on, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD. Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
54 .\" Avoid warning from groff about undefined register 'F'.
58 .if \n(.g .if rF .nr rF 1
59 .if (\n(rF:(\n(.g==0)) \{
62 . tm Index:\\$1\t\\n%\t"\\$2"
72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73 .\" Fear. Run. Save yourself. No user-serviceable parts.
74 . \" fudge factors for nroff and troff
83 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
89 . \" simple accents for nroff and troff
99 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
100 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
101 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
102 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
103 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
104 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
106 . \" troff and (daisy-wheel) nroff accents
107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
114 .ds ae a\h'-(\w'a'u*4/10)'e
115 .ds Ae A\h'-(\w'A'u*4/10)'E
116 . \" corrections for vroff
117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
119 . \" for low resolution devices (crt and lpr)
120 .if \n(.H>23 .if \n(.V>19 \
133 .\" ========================================================================
135 .IX Title "OBJDUMP 1"
136 .TH OBJDUMP 1 "2016-08-03" "binutils-2.27" "GNU Development Tools"
137 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138 .\" way too many mistakes in technical documents.
142 objdump \- display information from object files.
144 .IX Header "SYNOPSIS"
145 objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
146 [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
147 [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ]
148 [\fB\-d\fR|\fB\-\-disassemble\fR]
149 [\fB\-D\fR|\fB\-\-disassemble\-all\fR]
150 [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR]
151 [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }]
152 [\fB\-f\fR|\fB\-\-file\-headers\fR]
153 [\fB\-F\fR|\fB\-\-file\-offsets\fR]
154 [\fB\-\-file\-start\-context\fR]
155 [\fB\-g\fR|\fB\-\-debugging\fR]
156 [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
157 [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
158 [\fB\-i\fR|\fB\-\-info\fR]
159 [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
160 [\fB\-l\fR|\fB\-\-line\-numbers\fR]
161 [\fB\-S\fR|\fB\-\-source\fR]
162 [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
163 [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
164 [\fB\-p\fR|\fB\-\-private\-headers\fR]
165 [\fB\-P\fR \fIoptions\fR|\fB\-\-private=\fR\fIoptions\fR]
166 [\fB\-r\fR|\fB\-\-reloc\fR]
167 [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
168 [\fB\-s\fR|\fB\-\-full\-contents\fR]
169 [\fB\-W[lLiaprmfFsoRt]\fR|
170 \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames]
171 [=aranges,=macro,=frames,=frames\-interp,=str,=loc]
172 [=Ranges,=pubtypes,=trace_info,=trace_abbrev]
173 [=trace_aranges,=gdb_index]
174 [\fB\-G\fR|\fB\-\-stabs\fR]
175 [\fB\-t\fR|\fB\-\-syms\fR]
176 [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
177 [\fB\-x\fR|\fB\-\-all\-headers\fR]
178 [\fB\-w\fR|\fB\-\-wide\fR]
179 [\fB\-\-start\-address=\fR\fIaddress\fR]
180 [\fB\-\-stop\-address=\fR\fIaddress\fR]
181 [\fB\-\-prefix\-addresses\fR]
182 [\fB\-\-[no\-]show\-raw\-insn\fR]
183 [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
184 [\fB\-\-dwarf\-depth=\fR\fIn\fR]
185 [\fB\-\-dwarf\-start=\fR\fIn\fR]
186 [\fB\-\-special\-syms\fR]
187 [\fB\-\-prefix=\fR\fIprefix\fR]
188 [\fB\-\-prefix\-strip=\fR\fIlevel\fR]
189 [\fB\-\-insn\-width=\fR\fIwidth\fR]
190 [\fB\-V\fR|\fB\-\-version\fR]
191 [\fB\-H\fR|\fB\-\-help\fR]
194 .IX Header "DESCRIPTION"
195 \&\fBobjdump\fR displays information about one or more object files.
196 The options control what particular information to display. This
197 information is mostly useful to programmers who are working on the
198 compilation tools, as opposed to programmers who just want their
199 program to compile and work.
201 \&\fIobjfile\fR... are the object files to be examined. When you
202 specify archives, \fBobjdump\fR shows information on each of the member
206 The long and short forms of options, shown here as alternatives, are
207 equivalent. At least one option from the list
208 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-P,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
212 .IP "\fB\-\-archive\-header\fR" 4
213 .IX Item "--archive-header"
215 If any of the \fIobjfile\fR files are archives, display the archive
216 header information (in a format similar to \fBls \-l\fR). Besides the
217 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
218 the object file format of each archive member.
219 .IP "\fB\-\-adjust\-vma=\fR\fIoffset\fR" 4
220 .IX Item "--adjust-vma=offset"
221 When dumping information, first add \fIoffset\fR to all the section
222 addresses. This is useful if the section addresses do not correspond to
223 the symbol table, which can happen when putting sections at particular
224 addresses when using a format which can not represent section addresses,
226 .IP "\fB\-b\fR \fIbfdname\fR" 4
227 .IX Item "-b bfdname"
229 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4
230 .IX Item "--target=bfdname"
232 Specify that the object-code format for the object files is
233 \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
234 automatically recognize many formats.
239 \& objdump \-b oasys \-m vax \-h fu.o
242 displays summary information from the section headers (\fB\-h\fR) of
243 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
244 file in the format produced by Oasys compilers. You can list the
245 formats available with the \fB\-i\fR option.
249 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4
250 .IX Item "--demangle[=style]"
252 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
253 Besides removing any initial underscore prepended by the system, this
254 makes \*(C+ function names readable. Different compilers have different
255 mangling styles. The optional demangling style argument can be used to
256 choose an appropriate demangling style for your compiler.
260 .IP "\fB\-\-debugging\fR" 4
261 .IX Item "--debugging"
263 Display debugging information. This attempts to parse \s-1STABS\s0 and \s-1IEEE\s0
264 debugging format information stored in the file and print it out using
265 a C like syntax. If neither of these formats are found this option
266 falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in
271 .IP "\fB\-\-debugging\-tags\fR" 4
272 .IX Item "--debugging-tags"
274 Like \fB\-g\fR, but the information is generated in a format compatible
279 .IP "\fB\-\-disassemble\fR" 4
280 .IX Item "--disassemble"
282 Display the assembler mnemonics for the machine instructions from
283 \&\fIobjfile\fR. This option only disassembles those sections which are
284 expected to contain instructions.
288 .IP "\fB\-\-disassemble\-all\fR" 4
289 .IX Item "--disassemble-all"
291 Like \fB\-d\fR, but disassemble the contents of all sections, not just
292 those expected to contain instructions.
294 This option also has a subtle effect on the disassembly of
295 instructions in code sections. When option \fB\-d\fR is in effect
296 objdump will assume that any symbols present in a code section occur
297 on the boundary between instructions and it will refuse to disassemble
298 across such a boundary. When option \fB\-D\fR is in effect however
299 this assumption is supressed. This means that it is possible for the
300 output of \fB\-d\fR and \fB\-D\fR to differ if, for example, data
301 is stored in code sections.
303 If the target is an \s-1ARM\s0 architecture this switch also has the effect
304 of forcing the disassembler to decode pieces of data found in code
305 sections as if they were instructions.
306 .IP "\fB\-\-prefix\-addresses\fR" 4
307 .IX Item "--prefix-addresses"
308 When disassembling, print the complete address on each line. This is
309 the older disassembly format.
315 .IP "\fB\-\-endian={big|little}\fR" 4
316 .IX Item "--endian={big|little}"
318 Specify the endianness of the object files. This only affects
319 disassembly. This can be useful when disassembling a file format which
320 does not describe endianness information, such as S\-records.
324 .IP "\fB\-\-file\-headers\fR" 4
325 .IX Item "--file-headers"
327 Display summary information from the overall header of
328 each of the \fIobjfile\fR files.
332 .IP "\fB\-\-file\-offsets\fR" 4
333 .IX Item "--file-offsets"
335 When disassembling sections, whenever a symbol is displayed, also
336 display the file offset of the region of data that is about to be
337 dumped. If zeroes are being skipped, then when disassembly resumes,
338 tell the user how many zeroes were skipped and the file offset of the
339 location from where the disassembly resumes. When dumping sections,
340 display the file offset of the location from where the dump starts.
341 .IP "\fB\-\-file\-start\-context\fR" 4
342 .IX Item "--file-start-context"
343 Specify that when displaying interlisted source code/disassembly
344 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
345 context to the start of the file.
349 .IP "\fB\-\-section\-headers\fR" 4
350 .IX Item "--section-headers"
351 .IP "\fB\-\-headers\fR" 4
354 Display summary information from the section headers of the
357 File segments may be relocated to nonstandard addresses, for example by
358 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
359 \&\fBld\fR. However, some object file formats, such as a.out, do not
360 store the starting address of the file segments. In those situations,
361 although \fBld\fR relocates the sections correctly, using \fBobjdump
362 \&\-h\fR to list the file section headers cannot show the correct addresses.
363 Instead, it shows the usual addresses, which are implicit for the
366 Note, in some cases it is possible for a section to have both the
367 \&\s-1READONLY\s0 and the \s-1NOREAD\s0 attributes set. In such cases the \s-1NOREAD\s0
368 attribute takes precedence, but \fBobjdump\fR will report both
369 since the exact setting of the flag bits might be important.
373 .IP "\fB\-\-help\fR" 4
376 Print a summary of the options to \fBobjdump\fR and exit.
380 .IP "\fB\-\-info\fR" 4
383 Display a list showing all architectures and object formats available
384 for specification with \fB\-b\fR or \fB\-m\fR.
385 .IP "\fB\-j\fR \fIname\fR" 4
388 .IP "\fB\-\-section=\fR\fIname\fR" 4
389 .IX Item "--section=name"
391 Display information only for section \fIname\fR.
395 .IP "\fB\-\-line\-numbers\fR" 4
396 .IX Item "--line-numbers"
398 Label the display (using debugging information) with the filename and
399 source line numbers corresponding to the object code or relocs shown.
400 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
401 .IP "\fB\-m\fR \fImachine\fR" 4
402 .IX Item "-m machine"
404 .IP "\fB\-\-architecture=\fR\fImachine\fR" 4
405 .IX Item "--architecture=machine"
407 Specify the architecture to use when disassembling object files. This
408 can be useful when disassembling object files which do not describe
409 architecture information, such as S\-records. You can list the available
410 architectures with the \fB\-i\fR option.
412 If the target is an \s-1ARM\s0 architecture then this switch has an
413 additional effect. It restricts the disassembly to only those
414 instructions supported by the architecture specified by \fImachine\fR.
415 If it is necessary to use this switch because the input file does not
416 contain any architecture information, but it is also desired to
417 disassemble all the instructions use \fB\-marm\fR.
418 .IP "\fB\-M\fR \fIoptions\fR" 4
419 .IX Item "-M options"
421 .IP "\fB\-\-disassembler\-options=\fR\fIoptions\fR" 4
422 .IX Item "--disassembler-options=options"
424 Pass target specific information to the disassembler. Only supported on
425 some targets. If it is necessary to specify more than one
426 disassembler option then multiple \fB\-M\fR options can be used or
427 can be placed together into a comma separated list.
429 If the target is an \s-1ARM\s0 architecture then this switch can be used to
430 select which register name set is used during disassembler. Specifying
431 \&\fB\-M reg-names-std\fR (the default) will select the register names as
432 used in \s-1ARM\s0's instruction set documentation, but with register 13 called
433 \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying
434 \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
435 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
436 just use \fBr\fR followed by the register number.
438 There are also two variants on the \s-1APCS\s0 register naming scheme enabled
439 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
440 use the ARM/Thumb Procedure Call Standard naming conventions. (Either
441 with the normal register names or the special register names).
443 This option can also be used for \s-1ARM\s0 architectures to force the
444 disassembler to interpret all instructions as Thumb instructions by
445 using the switch \fB\-\-disassembler\-options=force\-thumb\fR. This can be
446 useful when attempting to disassemble thumb code produced by other
449 For the x86, some of the options duplicate functions of the \fB\-m\fR
450 switch, but allow finer grained control. Multiple selections from the
451 following may be specified as a comma separated string.
453 .ie n .IP """x86\-64""" 4
454 .el .IP "\f(CWx86\-64\fR" 4
457 .ie n .IP """i386""" 4
458 .el .IP "\f(CWi386\fR" 4
460 .ie n .IP """i8086""" 4
461 .el .IP "\f(CWi8086\fR" 4
464 Select disassembly for the given architecture.
465 .ie n .IP """intel""" 4
466 .el .IP "\f(CWintel\fR" 4
469 .ie n .IP """att""" 4
470 .el .IP "\f(CWatt\fR" 4
473 Select between intel syntax mode and \s-1AT&T\s0 syntax mode.
474 .ie n .IP """amd64""" 4
475 .el .IP "\f(CWamd64\fR" 4
478 .ie n .IP """intel64""" 4
479 .el .IP "\f(CWintel64\fR" 4
482 Select between \s-1AMD64 ISA\s0 and Intel64 \s-1ISA.\s0
483 .ie n .IP """intel\-mnemonic""" 4
484 .el .IP "\f(CWintel\-mnemonic\fR" 4
485 .IX Item "intel-mnemonic"
487 .ie n .IP """att\-mnemonic""" 4
488 .el .IP "\f(CWatt\-mnemonic\fR" 4
489 .IX Item "att-mnemonic"
491 Select between intel mnemonic mode and \s-1AT&T\s0 mnemonic mode.
492 Note: \f(CW\*(C`intel\-mnemonic\*(C'\fR implies \f(CW\*(C`intel\*(C'\fR and
493 \&\f(CW\*(C`att\-mnemonic\*(C'\fR implies \f(CW\*(C`att\*(C'\fR.
494 .ie n .IP """addr64""" 4
495 .el .IP "\f(CWaddr64\fR" 4
498 .ie n .IP """addr32""" 4
499 .el .IP "\f(CWaddr32\fR" 4
501 .ie n .IP """addr16""" 4
502 .el .IP "\f(CWaddr16\fR" 4
504 .ie n .IP """data32""" 4
505 .el .IP "\f(CWdata32\fR" 4
507 .ie n .IP """data16""" 4
508 .el .IP "\f(CWdata16\fR" 4
511 Specify the default address size and operand size. These four options
512 will be overridden if \f(CW\*(C`x86\-64\*(C'\fR, \f(CW\*(C`i386\*(C'\fR or \f(CW\*(C`i8086\*(C'\fR
513 appear later in the option string.
514 .ie n .IP """suffix""" 4
515 .el .IP "\f(CWsuffix\fR" 4
517 When in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic
518 suffix even when the suffix could be inferred by the operands.
522 For PowerPC, \fBbooke\fR controls the disassembly of BookE
523 instructions. \fB32\fR and \fB64\fR select PowerPC and
524 PowerPC64 disassembly, respectively. \fBe300\fR selects
525 disassembly for the e300 family. \fB440\fR selects disassembly for
526 the PowerPC 440. \fBppcps\fR selects disassembly for the paired
527 single instructions of the \s-1PPC750CL.\s0
529 For \s-1MIPS,\s0 this option controls the printing of instruction mnemonic
530 names and register names in disassembled instructions. Multiple
531 selections from the following may be specified as a comma separated
532 string, and invalid options are ignored:
533 .ie n .IP """no\-aliases""" 4
534 .el .IP "\f(CWno\-aliases\fR" 4
535 .IX Item "no-aliases"
536 Print the 'raw' instruction mnemonic instead of some pseudo
537 instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move',
538 \&'sll' instead of 'nop', etc.
539 .ie n .IP """msa""" 4
540 .el .IP "\f(CWmsa\fR" 4
542 Disassemble \s-1MSA\s0 instructions.
543 .ie n .IP """virt""" 4
544 .el .IP "\f(CWvirt\fR" 4
546 Disassemble the virtualization \s-1ASE\s0 instructions.
547 .ie n .IP """xpa""" 4
548 .el .IP "\f(CWxpa\fR" 4
550 Disassemble the eXtended Physical Address (\s-1XPA\s0) \s-1ASE\s0 instructions.
551 .ie n .IP """gpr\-names=\f(CIABI\f(CW""" 4
552 .el .IP "\f(CWgpr\-names=\f(CIABI\f(CW\fR" 4
553 .IX Item "gpr-names=ABI"
554 Print \s-1GPR \s0(general-purpose register) names as appropriate
555 for the specified \s-1ABI. \s0 By default, \s-1GPR\s0 names are selected according to
556 the \s-1ABI\s0 of the binary being disassembled.
557 .ie n .IP """fpr\-names=\f(CIABI\f(CW""" 4
558 .el .IP "\f(CWfpr\-names=\f(CIABI\f(CW\fR" 4
559 .IX Item "fpr-names=ABI"
560 Print \s-1FPR \s0(floating-point register) names as
561 appropriate for the specified \s-1ABI. \s0 By default, \s-1FPR\s0 numbers are printed
563 .ie n .IP """cp0\-names=\f(CIARCH\f(CW""" 4
564 .el .IP "\f(CWcp0\-names=\f(CIARCH\f(CW\fR" 4
565 .IX Item "cp0-names=ARCH"
566 Print \s-1CP0 \s0(system control coprocessor; coprocessor 0) register names
567 as appropriate for the \s-1CPU\s0 or architecture specified by
568 \&\fI\s-1ARCH\s0\fR. By default, \s-1CP0\s0 register names are selected according to
569 the architecture and \s-1CPU\s0 of the binary being disassembled.
570 .ie n .IP """hwr\-names=\f(CIARCH\f(CW""" 4
571 .el .IP "\f(CWhwr\-names=\f(CIARCH\f(CW\fR" 4
572 .IX Item "hwr-names=ARCH"
573 Print \s-1HWR \s0(hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
574 as appropriate for the \s-1CPU\s0 or architecture specified by
575 \&\fI\s-1ARCH\s0\fR. By default, \s-1HWR\s0 names are selected according to
576 the architecture and \s-1CPU\s0 of the binary being disassembled.
577 .ie n .IP """reg\-names=\f(CIABI\f(CW""" 4
578 .el .IP "\f(CWreg\-names=\f(CIABI\f(CW\fR" 4
579 .IX Item "reg-names=ABI"
580 Print \s-1GPR\s0 and \s-1FPR\s0 names as appropriate for the selected \s-1ABI.\s0
581 .ie n .IP """reg\-names=\f(CIARCH\f(CW""" 4
582 .el .IP "\f(CWreg\-names=\f(CIARCH\f(CW\fR" 4
583 .IX Item "reg-names=ARCH"
584 Print CPU-specific register names (\s-1CP0\s0 register and \s-1HWR\s0 names)
585 as appropriate for the selected \s-1CPU\s0 or architecture.
589 For any of the options listed above, \fI\s-1ABI\s0\fR or
590 \&\fI\s-1ARCH\s0\fR may be specified as \fBnumeric\fR to have numbers printed
591 rather than names, for the selected types of registers.
592 You can list the available values of \fI\s-1ABI\s0\fR and \fI\s-1ARCH\s0\fR using
593 the \fB\-\-help\fR option.
595 For \s-1VAX,\s0 you can specify function entry addresses with \fB\-M
596 entry:0xf00ba\fR. You can use this multiple times to properly
597 disassemble \s-1VAX\s0 binary files that don't contain symbol tables (like
598 \&\s-1ROM\s0 dumps). In these cases, the function entry mask would otherwise
599 be decoded as \s-1VAX\s0 instructions, which would probably lead the rest
600 of the function being wrongly disassembled.
605 .IP "\fB\-\-private\-headers\fR" 4
606 .IX Item "--private-headers"
608 Print information that is specific to the object file format. The exact
609 information printed depends upon the object file format. For some
610 object file formats, no additional information is printed.
611 .IP "\fB\-P\fR \fIoptions\fR" 4
612 .IX Item "-P options"
614 .IP "\fB\-\-private=\fR\fIoptions\fR" 4
615 .IX Item "--private=options"
617 Print information that is specific to the object file format. The
618 argument \fIoptions\fR is a comma separated list that depends on the
619 format (the lists of options is displayed with the help).
621 For \s-1XCOFF,\s0 the available options are:
623 .ie n .IP """header""" 4
624 .el .IP "\f(CWheader\fR" 4
627 .ie n .IP """aout""" 4
628 .el .IP "\f(CWaout\fR" 4
630 .ie n .IP """sections""" 4
631 .el .IP "\f(CWsections\fR" 4
633 .ie n .IP """syms""" 4
634 .el .IP "\f(CWsyms\fR" 4
636 .ie n .IP """relocs""" 4
637 .el .IP "\f(CWrelocs\fR" 4
639 .ie n .IP """lineno,""" 4
640 .el .IP "\f(CWlineno,\fR" 4
642 .ie n .IP """loader""" 4
643 .el .IP "\f(CWloader\fR" 4
645 .ie n .IP """except""" 4
646 .el .IP "\f(CWexcept\fR" 4
648 .ie n .IP """typchk""" 4
649 .el .IP "\f(CWtypchk\fR" 4
651 .ie n .IP """traceback""" 4
652 .el .IP "\f(CWtraceback\fR" 4
654 .ie n .IP """toc""" 4
655 .el .IP "\f(CWtoc\fR" 4
657 .ie n .IP """ldinfo""" 4
658 .el .IP "\f(CWldinfo\fR" 4
664 Not all object formats support this option. In particular the \s-1ELF\s0
665 format does not use it.
670 .IP "\fB\-\-reloc\fR" 4
673 Print the relocation entries of the file. If used with \fB\-d\fR or
674 \&\fB\-D\fR, the relocations are printed interspersed with the
679 .IP "\fB\-\-dynamic\-reloc\fR" 4
680 .IX Item "--dynamic-reloc"
682 Print the dynamic relocation entries of the file. This is only
683 meaningful for dynamic objects, such as certain types of shared
684 libraries. As for \fB\-r\fR, if used with \fB\-d\fR or
685 \&\fB\-D\fR, the relocations are printed interspersed with the
690 .IP "\fB\-\-full\-contents\fR" 4
691 .IX Item "--full-contents"
693 Display the full contents of any sections requested. By default all
694 non-empty sections are displayed.
698 .IP "\fB\-\-source\fR" 4
701 Display source code intermixed with disassembly, if possible. Implies
703 .IP "\fB\-\-prefix=\fR\fIprefix\fR" 4
704 .IX Item "--prefix=prefix"
705 Specify \fIprefix\fR to add to the absolute paths when used with
707 .IP "\fB\-\-prefix\-strip=\fR\fIlevel\fR" 4
708 .IX Item "--prefix-strip=level"
709 Indicate how many initial directory names to strip off the hardwired
710 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
711 .IP "\fB\-\-show\-raw\-insn\fR" 4
712 .IX Item "--show-raw-insn"
713 When disassembling instructions, print the instruction in hex as well as
714 in symbolic form. This is the default except when
715 \&\fB\-\-prefix\-addresses\fR is used.
716 .IP "\fB\-\-no\-show\-raw\-insn\fR" 4
717 .IX Item "--no-show-raw-insn"
718 When disassembling instructions, do not print the instruction bytes.
719 This is the default when \fB\-\-prefix\-addresses\fR is used.
720 .IP "\fB\-\-insn\-width=\fR\fIwidth\fR" 4
721 .IX Item "--insn-width=width"
722 Display \fIwidth\fR bytes on a single line when disassembling
724 .IP "\fB\-W[lLiaprmfFsoRt]\fR" 4
725 .IX Item "-W[lLiaprmfFsoRt]"
727 .IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames]\fR" 4
728 .IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames]"
729 .IP "\fB\-\-dwarf[=aranges,=macro,=frames,=frames\-interp,=str,=loc]\fR" 4
730 .IX Item "--dwarf[=aranges,=macro,=frames,=frames-interp,=str,=loc]"
731 .IP "\fB\-\-dwarf[=Ranges,=pubtypes,=trace_info,=trace_abbrev]\fR" 4
732 .IX Item "--dwarf[=Ranges,=pubtypes,=trace_info,=trace_abbrev]"
733 .IP "\fB\-\-dwarf[=trace_aranges,=gdb_index]\fR" 4
734 .IX Item "--dwarf[=trace_aranges,=gdb_index]"
736 Displays the contents of the debug sections in the file, if any are
737 present. If one of the optional letters or words follows the switch
738 then only data found in those specific sections will be dumped.
740 Note that there is no single letter option to display the content of
741 trace sections or .gdb_index.
743 Note: the output from the \fB=info\fR option can also be affected
744 by the options \fB\-\-dwarf\-depth\fR, the \fB\-\-dwarf\-start\fR and
745 the \fB\-\-dwarf\-check\fR.
746 .IP "\fB\-\-dwarf\-depth=\fR\fIn\fR" 4
747 .IX Item "--dwarf-depth=n"
748 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
749 This is only useful with \fB\-\-dwarf=info\fR. The default is
750 to print all DIEs; the special value 0 for \fIn\fR will also have this
753 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
754 levels will not be printed. The range for \fIn\fR is zero-based.
755 .IP "\fB\-\-dwarf\-start=\fR\fIn\fR" 4
756 .IX Item "--dwarf-start=n"
757 Print only DIEs beginning with the \s-1DIE\s0 numbered \fIn\fR. This is only
758 useful with \fB\-\-dwarf=info\fR.
760 If specified, this option will suppress printing of any header
761 information and all DIEs before the \s-1DIE\s0 numbered \fIn\fR. Only
762 siblings and children of the specified \s-1DIE\s0 will be printed.
764 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
765 .IP "\fB\-\-dwarf\-check\fR" 4
766 .IX Item "--dwarf-check"
767 Enable additional checks for consistency of Dwarf information.
771 .IP "\fB\-\-stabs\fR" 4
774 Display the full contents of any sections requested. Display the
775 contents of the .stab and .stab.index and .stab.excl sections from an
776 \&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which
777 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
778 section. In most other file formats, debugging symbol-table entries are
779 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
781 .IP "\fB\-\-start\-address=\fR\fIaddress\fR" 4
782 .IX Item "--start-address=address"
783 Start displaying data at the specified address. This affects the output
784 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
785 .IP "\fB\-\-stop\-address=\fR\fIaddress\fR" 4
786 .IX Item "--stop-address=address"
787 Stop displaying data at the specified address. This affects the output
788 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
792 .IP "\fB\-\-syms\fR" 4
795 Print the symbol table entries of the file.
796 This is similar to the information provided by the \fBnm\fR program,
797 although the display format is different. The format of the output
798 depends upon the format of the file being dumped, but there are two main
799 types. One looks like this:
802 \& [ 4](sec 3)(fl 0x00)(ty 0)(scl 3) (nx 1) 0x00000000 .bss
803 \& [ 6](sec 1)(fl 0x00)(ty 0)(scl 2) (nx 0) 0x00000000 fred
806 where the number inside the square brackets is the number of the entry
807 in the symbol table, the \fIsec\fR number is the section number, the
808 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
809 symbol's type, the \fIscl\fR number is the symbol's storage class and
810 the \fInx\fR value is the number of auxilary entries associated with
811 the symbol. The last two fields are the symbol's value and its name.
813 The other common output format, usually seen with \s-1ELF\s0 based files,
817 \& 00000000 l d .bss 00000000 .bss
818 \& 00000000 g .text 00000000 fred
821 Here the first number is the symbol's value (sometimes refered to as
822 its address). The next field is actually a set of characters and
823 spaces indicating the flag bits that are set on the symbol. These
824 characters are described below. Next is the section with which the
825 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
826 not connected with any section), or \fI*UND*\fR if the section is
827 referenced in the file being dumped, but not defined there.
829 After the section name comes another field, a number, which for common
830 symbols is the alignment and for other symbol is the size. Finally
831 the symbol's name is displayed.
833 The flag characters are divided into 7 groups as follows:
836 .el .IP "\f(CWl\fR" 4
840 .el .IP "\f(CWg\fR" 4
843 .el .IP "\f(CWu\fR" 4
846 .el .IP "\f(CW!\fR" 4
849 The symbol is a local (l), global (g), unique global (u), neither
850 global nor local (a space) or both global and local (!). A
851 symbol can be neither local or global for a variety of reasons, e.g.,
852 because it is used for debugging, but it is probably an indication of
853 a bug if it is ever both local and global. Unique global symbols are
854 a \s-1GNU\s0 extension to the standard set of \s-1ELF\s0 symbol bindings. For such
855 a symbol the dynamic linker will make sure that in the entire process
856 there is just one symbol with this name and type in use.
858 .el .IP "\f(CWw\fR" 4
860 The symbol is weak (w) or strong (a space).
862 .el .IP "\f(CWC\fR" 4
864 The symbol denotes a constructor (C) or an ordinary symbol (a space).
866 .el .IP "\f(CWW\fR" 4
868 The symbol is a warning (W) or a normal symbol (a space). A warning
869 symbol's name is a message to be displayed if the symbol following the
870 warning symbol is ever referenced.
872 .el .IP "\f(CWI\fR" 4
876 .el .IP "\f(CWi\fR" 4
879 The symbol is an indirect reference to another symbol (I), a function
880 to be evaluated during reloc processing (i) or a normal symbol (a
883 .el .IP "\f(CWd\fR" 4
887 .el .IP "\f(CWD\fR" 4
890 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
891 normal symbol (a space).
893 .el .IP "\f(CWF\fR" 4
897 .el .IP "\f(CWf\fR" 4
900 .el .IP "\f(CWO\fR" 4
903 The symbol is the name of a function (F) or a file (f) or an object
904 (O) or just a normal symbol (a space).
911 .IP "\fB\-\-dynamic\-syms\fR" 4
912 .IX Item "--dynamic-syms"
914 Print the dynamic symbol table entries of the file. This is only
915 meaningful for dynamic objects, such as certain types of shared
916 libraries. This is similar to the information provided by the \fBnm\fR
917 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
918 .IP "\fB\-\-special\-syms\fR" 4
919 .IX Item "--special-syms"
920 When displaying symbols include those which the target considers to be
921 special in some way and which would not normally be of interest to the
926 .IP "\fB\-\-version\fR" 4
929 Print the version number of \fBobjdump\fR and exit.
933 .IP "\fB\-\-all\-headers\fR" 4
934 .IX Item "--all-headers"
936 Display all available header information, including the symbol table and
937 relocation entries. Using \fB\-x\fR is equivalent to specifying all of
938 \&\fB\-a \-f \-h \-p \-r \-t\fR.
942 .IP "\fB\-\-wide\fR" 4
945 Format some lines for output devices that have more than 80 columns.
946 Also do not truncate symbol names when they are displayed.
950 .IP "\fB\-\-disassemble\-zeroes\fR" 4
951 .IX Item "--disassemble-zeroes"
953 Normally the disassembly output will skip blocks of zeroes. This
954 option directs the disassembler to disassemble those blocks, just like
956 .IP "\fB@\fR\fIfile\fR" 4
958 Read command-line options from \fIfile\fR. The options read are
959 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
960 does not exist, or cannot be read, then the option will be treated
961 literally, and not removed.
963 Options in \fIfile\fR are separated by whitespace. A whitespace
964 character may be included in an option by surrounding the entire
965 option in either single or double quotes. Any character (including a
966 backslash) may be included by prefixing the character to be included
967 with a backslash. The \fIfile\fR may itself contain additional
968 @\fIfile\fR options; any such options will be processed recursively.
970 .IX Header "SEE ALSO"
971 \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
973 .IX Header "COPYRIGHT"
974 Copyright (c) 1991\-2016 Free Software Foundation, Inc.
976 Permission is granted to copy, distribute and/or modify this document
977 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
978 or any later version published by the Free Software Foundation;
979 with no Invariant Sections, with no Front-Cover Texts, and with no
980 Back-Cover Texts. A copy of the license is included in the
981 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
projects / dragonfly.git / blob