1OBJDUMP(1)                   GNU Development Tools                  OBJDUMP(1)
2
3
4

NAME

6       objdump - display information from object files
7

SYNOPSIS

9       objdump [-a|--archive-headers]
10               [-b bfdname|--target=bfdname]
11               [-C|--demangle[=style] ]
12               [-d|--disassemble[=symbol]]
13               [-D|--disassemble-all]
14               [-z|--disassemble-zeroes]
15               [-EB|-EL|--endian={big | little }]
16               [-f|--file-headers]
17               [-F|--file-offsets]
18               [--file-start-context]
19               [-g|--debugging]
20               [-e|--debugging-tags]
21               [-h|--section-headers|--headers]
22               [-i|--info]
23               [-j section|--section=section]
24               [-l|--line-numbers]
25               [-S|--source]
26               [--source-comment[=text]]
27               [-m machine|--architecture=machine]
28               [-M options|--disassembler-options=options]
29               [-p|--private-headers]
30               [-P options|--private=options]
31               [-r|--reloc]
32               [-R|--dynamic-reloc]
33               [-s|--full-contents]
34               [-W[lLiaprmfFsoORtUuTgAck]|
35                --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links]]
36               [-WK|--dwarf=follow-links]
37               [-WN|--dwarf=no-follow-links]
38               [-wD|--dwarf=use-debuginfod]
39               [-wE|--dwarf=do-not-use-debuginfod]
40               [-L|--process-links]
41               [--ctf=section]
42               [-G|--stabs]
43               [-t|--syms]
44               [-T|--dynamic-syms]
45               [-x|--all-headers]
46               [-w|--wide]
47               [--start-address=address]
48               [--stop-address=address]
49               [--no-addresses]
50               [--prefix-addresses]
51               [--[no-]show-raw-insn]
52               [--adjust-vma=offset]
53               [--dwarf-depth=n]
54               [--dwarf-start=n]
55               [--ctf-parent=section]
56               [--no-recurse-limit|--recurse-limit]
57               [--special-syms]
58               [--prefix=prefix]
59               [--prefix-strip=level]
60               [--insn-width=width]
61               [--visualize-jumps[=color|=extended-color|=off]
62               [-U method] [--unicode=method]
63               [-V|--version]
64               [-H|--help]
65               objfile...
66

DESCRIPTION

68       objdump displays information about one or more object files.  The
69       options control what particular information to display.  This
70       information is mostly useful to programmers who are working on the
71       compilation tools, as opposed to programmers who just want their
72       program to compile and work.
73
74       objfile... are the object files to be examined.  When you specify
75       archives, objdump shows information on each of the member object files.
76

OPTIONS

78       The long and short forms of options, shown here as alternatives, are
79       equivalent.  At least one option from the list
80       -a,-d,-D,-e,-f,-g,-G,-h,-H,-p,-P,-r,-R,-s,-S,-t,-T,-V,-x must be given.
81
82       -a
83       --archive-header
84           If any of the objfile files are archives, display the archive
85           header information (in a format similar to ls -l).  Besides the
86           information you could list with ar tv, objdump -a shows the object
87           file format of each archive member.
88
89       --adjust-vma=offset
90           When dumping information, first add offset to all the section
91           addresses.  This is useful if the section addresses do not
92           correspond to the symbol table, which can happen when putting
93           sections at particular addresses when using a format which can not
94           represent section addresses, such as a.out.
95
96       -b bfdname
97       --target=bfdname
98           Specify that the object-code format for the object files is
99           bfdname.  This option may not be necessary; objdump can
100           automatically recognize many formats.
101
102           For example,
103
104                   objdump -b oasys -m vax -h fu.o
105
106           displays summary information from the section headers (-h) of fu.o,
107           which is explicitly identified (-m) as a VAX object file in the
108           format produced by Oasys compilers.  You can list the formats
109           available with the -i option.
110
111       -C
112       --demangle[=style]
113           Decode (demangle) low-level symbol names into user-level names.
114           Besides removing any initial underscore prepended by the system,
115           this makes C++ function names readable.  Different compilers have
116           different mangling styles. The optional demangling style argument
117           can be used to choose an appropriate demangling style for your
118           compiler.
119
120       --recurse-limit
121       --no-recurse-limit
122       --recursion-limit
123       --no-recursion-limit
124           Enables or disables a limit on the amount of recursion performed
125           whilst demangling strings.  Since the name mangling formats allow
126           for an infinite level of recursion it is possible to create strings
127           whose decoding will exhaust the amount of stack space available on
128           the host machine, triggering a memory fault.  The limit tries to
129           prevent this from happening by restricting recursion to 2048 levels
130           of nesting.
131
132           The default is for this limit to be enabled, but disabling it may
133           be necessary in order to demangle truly complicated names.  Note
134           however that if the recursion limit is disabled then stack
135           exhaustion is possible and any bug reports about such an event will
136           be rejected.
137
138       -g
139       --debugging
140           Display debugging information.  This attempts to parse STABS
141           debugging format information stored in the file and print it out
142           using a C like syntax.  If no STABS debugging was found this option
143           falls back on the -W option to print any DWARF information in the
144           file.
145
146       -e
147       --debugging-tags
148           Like -g, but the information is generated in a format compatible
149           with ctags tool.
150
151       -d
152       --disassemble
153       --disassemble=symbol
154           Display the assembler mnemonics for the machine instructions from
155           the input file.  This option only disassembles those sections which
156           are expected to contain instructions.  If the optional symbol
157           argument is given, then display the assembler mnemonics starting at
158           symbol.  If symbol is a function name then disassembly will stop at
159           the end of the function, otherwise it will stop when the next
160           symbol is encountered.  If there are no matches for symbol then
161           nothing will be displayed.
162
163           Note if the --dwarf=follow-links option is enabled then any symbol
164           tables in linked debug info files will be read in and used when
165           disassembling.
166
167       -D
168       --disassemble-all
169           Like -d, but disassemble the contents of all sections, not just
170           those expected to contain instructions.
171
172           This option also has a subtle effect on the disassembly of
173           instructions in code sections.  When option -d is in effect objdump
174           will assume that any symbols present in a code section occur on the
175           boundary between instructions and it will refuse to disassemble
176           across such a boundary.  When option -D is in effect however this
177           assumption is supressed.  This means that it is possible for the
178           output of -d and -D to differ if, for example, data is stored in
179           code sections.
180
181           If the target is an ARM architecture this switch also has the
182           effect of forcing the disassembler to decode pieces of data found
183           in code sections as if they were instructions.
184
185           Note if the --dwarf=follow-links option is enabled then any symbol
186           tables in linked debug info files will be read in and used when
187           disassembling.
188
189       --no-addresses
190           When disassembling, don't print addresses on each line or for
191           symbols and relocation offsets.  In combination with
192           --no-show-raw-insn this may be useful for comparing compiler
193           output.
194
195       --prefix-addresses
196           When disassembling, print the complete address on each line.  This
197           is the older disassembly format.
198
199       -EB
200       -EL
201       --endian={big|little}
202           Specify the endianness of the object files.  This only affects
203           disassembly.  This can be useful when disassembling a file format
204           which does not describe endianness information, such as S-records.
205
206       -f
207       --file-headers
208           Display summary information from the overall header of each of the
209           objfile files.
210
211       -F
212       --file-offsets
213           When disassembling sections, whenever a symbol is displayed, also
214           display the file offset of the region of data that is about to be
215           dumped.  If zeroes are being skipped, then when disassembly
216           resumes, tell the user how many zeroes were skipped and the file
217           offset of the location from where the disassembly resumes.  When
218           dumping sections, display the file offset of the location from
219           where the dump starts.
220
221       --file-start-context
222           Specify that when displaying interlisted source code/disassembly
223           (assumes -S) from a file that has not yet been displayed, extend
224           the context to the start of the file.
225
226       -h
227       --section-headers
228       --headers
229           Display summary information from the section headers of the object
230           file.
231
232           File segments may be relocated to nonstandard addresses, for
233           example by using the -Ttext, -Tdata, or -Tbss options to ld.
234           However, some object file formats, such as a.out, do not store the
235           starting address of the file segments.  In those situations,
236           although ld relocates the sections correctly, using objdump -h to
237           list the file section headers cannot show the correct addresses.
238           Instead, it shows the usual addresses, which are implicit for the
239           target.
240
241           Note, in some cases it is possible for a section to have both the
242           READONLY and the NOREAD attributes set.  In such cases the NOREAD
243           attribute takes precedence, but objdump will report both since the
244           exact setting of the flag bits might be important.
245
246       -H
247       --help
248           Print a summary of the options to objdump and exit.
249
250       -i
251       --info
252           Display a list showing all architectures and object formats
253           available for specification with -b or -m.
254
255       -j name
256       --section=name
257           Display information only for section name.
258
259       -L
260       --process-links
261           Display the contents of non-debug sections found in separate
262           debuginfo files that are linked to the main file.  This option
263           automatically implies the -WK option, and only sections requested
264           by other command line options will be displayed.
265
266       -l
267       --line-numbers
268           Label the display (using debugging information) with the filename
269           and source line numbers corresponding to the object code or relocs
270           shown.  Only useful with -d, -D, or -r.
271
272       -m machine
273       --architecture=machine
274           Specify the architecture to use when disassembling object files.
275           This can be useful when disassembling object files which do not
276           describe architecture information, such as S-records.  You can list
277           the available architectures with the -i option.
278
279           If the target is an ARM architecture then this switch has an
280           additional effect.  It restricts the disassembly to only those
281           instructions supported by the architecture specified by machine.
282           If it is necessary to use this switch because the input file does
283           not contain any architecture information, but it is also desired to
284           disassemble all the instructions use -marm.
285
286       -M options
287       --disassembler-options=options
288           Pass target specific information to the disassembler.  Only
289           supported on some targets.  If it is necessary to specify more than
290           one disassembler option then multiple -M options can be used or can
291           be placed together into a comma separated list.
292
293           For ARC, dsp controls the printing of DSP instructions, spfp
294           selects the printing of FPX single precision FP instructions, dpfp
295           selects the printing of FPX double precision FP instructions,
296           quarkse_em selects the printing of special QuarkSE-EM instructions,
297           fpuda selects the printing of double precision assist instructions,
298           fpus selects the printing of FPU single precision FP instructions,
299           while fpud selects the printing of FPU double precision FP
300           instructions.  Additionally, one can choose to have all the
301           immediates printed in hexadecimal using hex.  By default, the short
302           immediates are printed using the decimal representation, while the
303           long immediate values are printed as hexadecimal.
304
305           cpu=... allows one to enforce a particular ISA when disassembling
306           instructions, overriding the -m value or whatever is in the ELF
307           file.  This might be useful to select ARC EM or HS ISA, because
308           architecture is same for those and disassembler relies on private
309           ELF header data to decide if code is for EM or HS.  This option
310           might be specified multiple times - only the latest value will be
311           used.  Valid values are same as for the assembler -mcpu=... option.
312
313           If the target is an ARM architecture then this switch can be used
314           to select which register name set is used during disassembler.
315           Specifying -M reg-names-std (the default) will select the register
316           names as used in ARM's instruction set documentation, but with
317           register 13 called 'sp', register 14 called 'lr' and register 15
318           called 'pc'.  Specifying -M reg-names-apcs will select the name set
319           used by the ARM Procedure Call Standard, whilst specifying -M reg-
320           names-raw will just use r followed by the register number.
321
322           There are also two variants on the APCS register naming scheme
323           enabled by -M reg-names-atpcs and -M reg-names-special-atpcs which
324           use the ARM/Thumb Procedure Call Standard naming conventions.
325           (Either with the normal register names or the special register
326           names).
327
328           This option can also be used for ARM architectures to force the
329           disassembler to interpret all instructions as Thumb instructions by
330           using the switch --disassembler-options=force-thumb.  This can be
331           useful when attempting to disassemble thumb code produced by other
332           compilers.
333
334           For AArch64 targets this switch can be used to set whether
335           instructions are disassembled as the most general instruction using
336           the -M no-aliases option or whether instruction notes should be
337           generated as comments in the disasssembly using -M notes.
338
339           For the x86, some of the options duplicate functions of the -m
340           switch, but allow finer grained control.
341
342           "x86-64"
343           "i386"
344           "i8086"
345               Select disassembly for the given architecture.
346
347           "intel"
348           "att"
349               Select between intel syntax mode and AT&T syntax mode.
350
351           "amd64"
352           "intel64"
353               Select between AMD64 ISA and Intel64 ISA.
354
355           "intel-mnemonic"
356           "att-mnemonic"
357               Select between intel mnemonic mode and AT&T mnemonic mode.
358               Note: "intel-mnemonic" implies "intel" and "att-mnemonic"
359               implies "att".
360
361           "addr64"
362           "addr32"
363           "addr16"
364           "data32"
365           "data16"
366               Specify the default address size and operand size.  These five
367               options will be overridden if "x86-64", "i386" or "i8086"
368               appear later in the option string.
369
370           "suffix"
371               When in AT&T mode and also for a limited set of instructions
372               when in Intel mode, instructs the disassembler to print a
373               mnemonic suffix even when the suffix could be inferred by the
374               operands or, for certain instructions, the execution mode's
375               defaults.
376
377           For PowerPC, the -M argument raw selects disasssembly of hardware
378           insns rather than aliases.  For example, you will see "rlwinm"
379           rather than "clrlwi", and "addi" rather than "li".  All of the -m
380           arguments for gas that select a CPU are supported.  These are: 403,
381           405, 440, 464, 476, 601, 603, 604, 620, 7400, 7410, 7450, 7455,
382           750cl, 821, 850, 860, a2, booke, booke32, cell, com, e200z4, e300,
383           e500, e500mc, e500mc64, e500x2, e5500, e6500, efs, power4, power5,
384           power6, power7, power8, power9, power10, ppc, ppc32, ppc64,
385           ppc64bridge, ppcps, pwr, pwr2, pwr4, pwr5, pwr5x, pwr6, pwr7, pwr8,
386           pwr9, pwr10, pwrx, titan, and vle.  32 and 64 modify the default or
387           a prior CPU selection, disabling and enabling 64-bit insns
388           respectively.  In addition, altivec, any, htm, vsx, and spe add
389           capabilities to a previous or later CPU selection.  any will
390           disassemble any opcode known to binutils, but in cases where an
391           opcode has two different meanings or different arguments, you may
392           not see the disassembly you expect.  If you disassemble without
393           giving a CPU selection, a default will be chosen from information
394           gleaned by BFD from the object files headers, but the result again
395           may not be as you expect.
396
397           For MIPS, this option controls the printing of instruction mnemonic
398           names and register names in disassembled instructions.  Multiple
399           selections from the following may be specified as a comma separated
400           string, and invalid options are ignored:
401
402           "no-aliases"
403               Print the 'raw' instruction mnemonic instead of some pseudo
404               instruction mnemonic.  I.e., print 'daddu' or 'or' instead of
405               'move', 'sll' instead of 'nop', etc.
406
407           "msa"
408               Disassemble MSA instructions.
409
410           "virt"
411               Disassemble the virtualization ASE instructions.
412
413           "xpa"
414               Disassemble the eXtended Physical Address (XPA) ASE
415               instructions.
416
417           "gpr-names=ABI"
418               Print GPR (general-purpose register) names as appropriate for
419               the specified ABI.  By default, GPR names are selected
420               according to the ABI of the binary being disassembled.
421
422           "fpr-names=ABI"
423               Print FPR (floating-point register) names as appropriate for
424               the specified ABI.  By default, FPR numbers are printed rather
425               than names.
426
427           "cp0-names=ARCH"
428               Print CP0 (system control coprocessor; coprocessor 0) register
429               names as appropriate for the CPU or architecture specified by
430               ARCH.  By default, CP0 register names are selected according to
431               the architecture and CPU of the binary being disassembled.
432
433           "hwr-names=ARCH"
434               Print HWR (hardware register, used by the "rdhwr" instruction)
435               names as appropriate for the CPU or architecture specified by
436               ARCH.  By default, HWR names are selected according to the
437               architecture and CPU of the binary being disassembled.
438
439           "reg-names=ABI"
440               Print GPR and FPR names as appropriate for the selected ABI.
441
442           "reg-names=ARCH"
443               Print CPU-specific register names (CP0 register and HWR names)
444               as appropriate for the selected CPU or architecture.
445
446           For any of the options listed above, ABI or ARCH may be specified
447           as numeric to have numbers printed rather than names, for the
448           selected types of registers.  You can list the available values of
449           ABI and ARCH using the --help option.
450
451           For VAX, you can specify function entry addresses with -M
452           entry:0xf00ba.  You can use this multiple times to properly
453           disassemble VAX binary files that don't contain symbol tables (like
454           ROM dumps).  In these cases, the function entry mask would
455           otherwise be decoded as VAX instructions, which would probably lead
456           the rest of the function being wrongly disassembled.
457
458       -p
459       --private-headers
460           Print information that is specific to the object file format.  The
461           exact information printed depends upon the object file format.  For
462           some object file formats, no additional information is printed.
463
464       -P options
465       --private=options
466           Print information that is specific to the object file format.  The
467           argument options is a comma separated list that depends on the
468           format (the lists of options is displayed with the help).
469
470           For XCOFF, the available options are:
471
472           "header"
473           "aout"
474           "sections"
475           "syms"
476           "relocs"
477           "lineno,"
478           "loader"
479           "except"
480           "typchk"
481           "traceback"
482           "toc"
483           "ldinfo"
484
485           Not all object formats support this option.  In particular the ELF
486           format does not use it.
487
488       -r
489       --reloc
490           Print the relocation entries of the file.  If used with -d or -D,
491           the relocations are printed interspersed with the disassembly.
492
493       -R
494       --dynamic-reloc
495           Print the dynamic relocation entries of the file.  This is only
496           meaningful for dynamic objects, such as certain types of shared
497           libraries.  As for -r, if used with -d or -D, the relocations are
498           printed interspersed with the disassembly.
499
500       -s
501       --full-contents
502           Display the full contents of any sections requested.  By default
503           all non-empty sections are displayed.
504
505       -S
506       --source
507           Display source code intermixed with disassembly, if possible.
508           Implies -d.
509
510       --source-comment[=txt]
511           Like the -S option, but all source code lines are displayed with a
512           prefix of txt.  Typically txt will be a comment string which can be
513           used to distinguish the assembler code from the source code.  If
514           txt is not provided then a default string of "# " (hash followed by
515           a space), will be used.
516
517       --prefix=prefix
518           Specify prefix to add to the absolute paths when used with -S.
519
520       --prefix-strip=level
521           Indicate how many initial directory names to strip off the
522           hardwired absolute paths. It has no effect without --prefix=prefix.
523
524       --show-raw-insn
525           When disassembling instructions, print the instruction in hex as
526           well as in symbolic form.  This is the default except when
527           --prefix-addresses is used.
528
529       --no-show-raw-insn
530           When disassembling instructions, do not print the instruction
531           bytes.  This is the default when --prefix-addresses is used.
532
533       --insn-width=width
534           Display width bytes on a single line when disassembling
535           instructions.
536
537       --visualize-jumps[=color|=extended-color|=off]
538           Visualize jumps that stay inside a function by drawing ASCII art
539           between the start and target addresses.  The optional =color
540           argument adds color to the output using simple terminal colors.
541           Alternatively the =extended-color argument will add color using
542           8bit colors, but these might not work on all terminals.
543
544           If it is necessary to disable the visualize-jumps option after it
545           has previously been enabled then use visualize-jumps=off.
546
547       -W[lLiaprmfFsoORtUuTgAckK]
548       --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]
549           Displays the contents of the DWARF debug sections in the file, if
550           any are present.  Compressed debug sections are automatically
551           decompressed (temporarily) before they are displayed.  If one or
552           more of the optional letters or words follows the switch then only
553           those type(s) of data will be dumped.  The letters and words refer
554           to the following information:
555
556           "a"
557           "=abbrev"
558               Displays the contents of the .debug_abbrev section.
559
560           "A"
561           "=addr"
562               Displays the contents of the .debug_addr section.
563
564           "c"
565           "=cu_index"
566               Displays the contents of the .debug_cu_index and/or
567               .debug_tu_index sections.
568
569           "f"
570           "=frames"
571               Display the raw contents of a .debug_frame section.
572
573           "F"
574           "=frames-interp"
575               Display the interpreted contents of a .debug_frame section.
576
577           "g"
578           "=gdb_index"
579               Displays the contents of the .gdb_index and/or .debug_names
580               sections.
581
582           "i"
583           "=info"
584               Displays the contents of the .debug_info section.  Note: the
585               output from this option can also be restricted by the use of
586               the --dwarf-depth and --dwarf-start options.
587
588           "k"
589           "=links"
590               Displays the contents of the .gnu_debuglink, .gnu_debugaltlink
591               and .debug_sup sections, if any of them are present.  Also
592               displays any links to separate dwarf object files (dwo), if
593               they are specified by the DW_AT_GNU_dwo_name or DW_AT_dwo_name
594               attributes in the .debug_info section.
595
596           "K"
597           "=follow-links"
598               Display the contents of any selected debug sections that are
599               found in linked, separate debug info file(s).  This can result
600               in multiple versions of the same debug section being displayed
601               if it exists in more than one file.
602
603               In addition, when displaying DWARF attributes, if a form is
604               found that references the separate debug info file, then the
605               referenced contents will also be displayed.
606
607               Note - in some distributions this option is enabled by default.
608               It can be disabled via the N debug option.  The default can be
609               chosen when configuring the binutils via the
610               --enable-follow-debug-links=yes or
611               --enable-follow-debug-links=no options.  If these are not used
612               then the default is to enable the following of debug links.
613
614               Note - if support for the debuginfod protocol was enabled when
615               the binutils were built then this option will also include an
616               attempt to contact any debuginfod servers mentioned in the
617               DEBUGINFOD_URLS environment variable.  This could take some
618               time to resolve.  This behaviour can be disabled via the
619               =do-not-use-debuginfod debug option.
620
621           "N"
622           "=no-follow-links"
623               Disables the following of links to separate debug info files.
624
625           "D"
626           "=use-debuginfod"
627               Enables contacting debuginfod servers if there is a need to
628               follow debug links.  This is the default behaviour.
629
630           "E"
631           "=do-not-use-debuginfod"
632               Disables contacting debuginfod servers when there is a need to
633               follow debug links.
634
635           "l"
636           "=rawline"
637               Displays the contents of the .debug_line section in a raw
638               format.
639
640           "L"
641           "=decodedline"
642               Displays the interpreted contents of the .debug_line section.
643
644           "m"
645           "=macro"
646               Displays the contents of the .debug_macro and/or .debug_macinfo
647               sections.
648
649           "o"
650           "=loc"
651               Displays the contents of the .debug_loc and/or .debug_loclists
652               sections.
653
654           "O"
655           "=str-offsets"
656               Displays the contents of the .debug_str_offsets section.
657
658           "p"
659           "=pubnames"
660               Displays the contents of the .debug_pubnames and/or
661               .debug_gnu_pubnames sections.
662
663           "r"
664           "=aranges"
665               Displays the contents of the .debug_aranges section.
666
667           "R"
668           "=Ranges"
669               Displays the contents of the .debug_ranges and/or
670               .debug_rnglists sections.
671
672           "s"
673           "=str"
674               Displays the contents of the .debug_str, .debug_line_str and/or
675               .debug_str_offsets sections.
676
677           "t"
678           "=pubtype"
679               Displays the contents of the .debug_pubtypes and/or
680               .debug_gnu_pubtypes sections.
681
682           "T"
683           "=trace_aranges"
684               Displays the contents of the .trace_aranges section.
685
686           "u"
687           "=trace_abbrev"
688               Displays the contents of the .trace_abbrev section.
689
690           "U"
691           "=trace_info"
692               Displays the contents of the .trace_info section.
693
694           Note: displaying the contents of .debug_static_funcs,
695           .debug_static_vars and debug_weaknames sections is not currently
696           supported.
697
698       --dwarf-depth=n
699           Limit the dump of the ".debug_info" section to n children.  This is
700           only useful with --debug-dump=info.  The default is to print all
701           DIEs; the special value 0 for n will also have this effect.
702
703           With a non-zero value for n, DIEs at or deeper than n levels will
704           not be printed.  The range for n is zero-based.
705
706       --dwarf-start=n
707           Print only DIEs beginning with the DIE numbered n.  This is only
708           useful with --debug-dump=info.
709
710           If specified, this option will suppress printing of any header
711           information and all DIEs before the DIE numbered n.  Only siblings
712           and children of the specified DIE will be printed.
713
714           This can be used in conjunction with --dwarf-depth.
715
716       --dwarf-check
717           Enable additional checks for consistency of Dwarf information.
718
719       --ctf[=section]
720           Display the contents of the specified CTF section.  CTF sections
721           themselves contain many subsections, all of which are displayed in
722           order.
723
724           By default, display the name of the section named .ctf, which is
725           the name emitted by ld.
726
727       --ctf-parent=member
728           If the CTF section contains ambiguously-defined types, it will
729           consist of an archive of many CTF dictionaries, all inheriting from
730           one dictionary containing unambiguous types.  This member is by
731           default named .ctf, like the section containing it, but it is
732           possible to change this name using the
733           "ctf_link_set_memb_name_changer" function at link time.  When
734           looking at CTF archives that have been created by a linker that
735           uses the name changer to rename the parent archive member,
736           --ctf-parent can be used to specify the name used for the parent.
737
738       -G
739       --stabs
740           Display the full contents of any sections requested.  Display the
741           contents of the .stab and .stab.index and .stab.excl sections from
742           an ELF file.  This is only useful on systems (such as Solaris 2.0)
743           in which ".stab" debugging symbol-table entries are carried in an
744           ELF section.  In most other file formats, debugging symbol-table
745           entries are interleaved with linkage symbols, and are visible in
746           the --syms output.
747
748       --start-address=address
749           Start displaying data at the specified address.  This affects the
750           output of the -d, -r and -s options.
751
752       --stop-address=address
753           Stop displaying data at the specified address.  This affects the
754           output of the -d, -r and -s options.
755
756       -t
757       --syms
758           Print the symbol table entries of the file.  This is similar to the
759           information provided by the nm program, although the display format
760           is different.  The format of the output depends upon the format of
761           the file being dumped, but there are two main types.  One looks
762           like this:
763
764                   [  4](sec  3)(fl 0x00)(ty   0)(scl   3) (nx 1) 0x00000000 .bss
765                   [  6](sec  1)(fl 0x00)(ty   0)(scl   2) (nx 0) 0x00000000 fred
766
767           where the number inside the square brackets is the number of the
768           entry in the symbol table, the sec number is the section number,
769           the fl value are the symbol's flag bits, the ty number is the
770           symbol's type, the scl number is the symbol's storage class and the
771           nx value is the number of auxiliary entries associated with the
772           symbol.  The last two fields are the symbol's value and its name.
773
774           The other common output format, usually seen with ELF based files,
775           looks like this:
776
777                   00000000 l    d  .bss   00000000 .bss
778                   00000000 g       .text  00000000 fred
779
780           Here the first number is the symbol's value (sometimes referred to
781           as its address).  The next field is actually a set of characters
782           and spaces indicating the flag bits that are set on the symbol.
783           These characters are described below.  Next is the section with
784           which the symbol is associated or *ABS* if the section is absolute
785           (ie not connected with any section), or *UND* if the section is
786           referenced in the file being dumped, but not defined there.
787
788           After the section name comes another field, a number, which for
789           common symbols is the alignment and for other symbol is the size.
790           Finally the symbol's name is displayed.
791
792           The flag characters are divided into 7 groups as follows:
793
794           "l"
795           "g"
796           "u"
797           "!" The symbol is a local (l), global (g), unique global (u),
798               neither global nor local (a space) or both global and local
799               (!).  A symbol can be neither local or global for a variety of
800               reasons, e.g., because it is used for debugging, but it is
801               probably an indication of a bug if it is ever both local and
802               global.  Unique global symbols are a GNU extension to the
803               standard set of ELF symbol bindings.  For such a symbol the
804               dynamic linker will make sure that in the entire process there
805               is just one symbol with this name and type in use.
806
807           "w" The symbol is weak (w) or strong (a space).
808
809           "C" The symbol denotes a constructor (C) or an ordinary symbol (a
810               space).
811
812           "W" The symbol is a warning (W) or a normal symbol (a space).  A
813               warning symbol's name is a message to be displayed if the
814               symbol following the warning symbol is ever referenced.
815
816           "I"
817           "i" The symbol is an indirect reference to another symbol (I), a
818               function to be evaluated during reloc processing (i) or a
819               normal symbol (a space).
820
821           "d"
822           "D" The symbol is a debugging symbol (d) or a dynamic symbol (D) or
823               a normal symbol (a space).
824
825           "F"
826           "f"
827           "O" The symbol is the name of a function (F) or a file (f) or an
828               object (O) or just a normal symbol (a space).
829
830       -T
831       --dynamic-syms
832           Print the dynamic symbol table entries of the file.  This is only
833           meaningful for dynamic objects, such as certain types of shared
834           libraries.  This is similar to the information provided by the nm
835           program when given the -D (--dynamic) option.
836
837           The output format is similar to that produced by the --syms option,
838           except that an extra field is inserted before the symbol's name,
839           giving the version information associated with the symbol.  If the
840           version is the default version to be used when resolving
841           unversioned references to the symbol then it's displayed as is,
842           otherwise it's put into parentheses.
843
844       --special-syms
845           When displaying symbols include those which the target considers to
846           be special in some way and which would not normally be of interest
847           to the user.
848
849       -U [d|i|l|e|x|h]
850       --unicode=[default|invalid|locale|escape|hex|highlight]
851           Controls the display of UTF-8 encoded multibyte characters in
852           strings.  The default (--unicode=default) is to give them no
853           special treatment.  The --unicode=locale option displays the
854           sequence in the current locale, which may or may not support them.
855           The options --unicode=hex and --unicode=invalid display them as hex
856           byte sequences enclosed by either angle brackets or curly braces.
857
858           The --unicode=escape option displays them as escape sequences
859           (\uxxxx) and the --unicode=highlight option displays them as escape
860           sequences highlighted in red (if supported by the output device).
861           The colouring is intended to draw attention to the presence of
862           unicode sequences where they might not be expected.
863
864       -V
865       --version
866           Print the version number of objdump and exit.
867
868       -x
869       --all-headers
870           Display all available header information, including the symbol
871           table and relocation entries.  Using -x is equivalent to specifying
872           all of -a -f -h -p -r -t.
873
874       -w
875       --wide
876           Format some lines for output devices that have more than 80
877           columns.  Also do not truncate symbol names when they are
878           displayed.
879
880       -z
881       --disassemble-zeroes
882           Normally the disassembly output will skip blocks of zeroes.  This
883           option directs the disassembler to disassemble those blocks, just
884           like any other data.
885
886       @file
887           Read command-line options from file.  The options read are inserted
888           in place of the original @file option.  If file does not exist, or
889           cannot be read, then the option will be treated literally, and not
890           removed.
891
892           Options in file are separated by whitespace.  A whitespace
893           character may be included in an option by surrounding the entire
894           option in either single or double quotes.  Any character (including
895           a backslash) may be included by prefixing the character to be
896           included with a backslash.  The file may itself contain additional
897           @file options; any such options will be processed recursively.
898

SEE ALSO

900       nm(1), readelf(1), and the Info entries for binutils.
901
903       Copyright (c) 1991-2022 Free Software Foundation, Inc.
904
905       Permission is granted to copy, distribute and/or modify this document
906       under the terms of the GNU Free Documentation License, Version 1.3 or
907       any later version published by the Free Software Foundation; with no
908       Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
909       Texts.  A copy of the license is included in the section entitled "GNU
910       Free Documentation License".
911
912
913
914binutils-2.38                     2022-11-16                        OBJDUMP(1)
Impressum