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               [--sframe=section]
43               [-G|--stabs]
44               [-t|--syms]
45               [-T|--dynamic-syms]
46               [-x|--all-headers]
47               [-w|--wide]
48               [--start-address=address]
49               [--stop-address=address]
50               [--no-addresses]
51               [--prefix-addresses]
52               [--[no-]show-raw-insn]
53               [--adjust-vma=offset]
54               [--show-all-symbols]
55               [--dwarf-depth=n]
56               [--dwarf-start=n]
57               [--ctf-parent=section]
58               [--no-recurse-limit|--recurse-limit]
59               [--special-syms]
60               [--prefix=prefix]
61               [--prefix-strip=level]
62               [--insn-width=width]
63               [--visualize-jumps[=color|=extended-color|=off]
64               [--disassembler-color=[off|terminal|on|extended]
65               [-U method] [--unicode=method]
66               [-V|--version]
67               [-H|--help]
68               objfile...
69

DESCRIPTION

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

OPTIONS

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

SEE ALSO

939       nm(1), readelf(1), and the Info entries for binutils.
940
942       Copyright (c) 1991-2023 Free Software Foundation, Inc.
943
944       Permission is granted to copy, distribute and/or modify this document
945       under the terms of the GNU Free Documentation License, Version 1.3 or
946       any later version published by the Free Software Foundation; with no
947       Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
948       Texts.  A copy of the license is included in the section entitled "GNU
949       Free Documentation License".
950
951
952
953binutils-2.40.00                  2023-07-30                        OBJDUMP(1)
Impressum