Debian Codegraph @

upstream/debian-unstable/man1/objdump.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "OBJDUMP 1"
58 .TH OBJDUMP 1 2026-03-05 binutils-2.46 "GNU Development Tools"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 objdump \- display information from object files
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR]
68 [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR]
69 [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR] ]
70 [\fB\-d\fR|\fB\-\-disassemble\fR[=\fIsymbol\fR]]
71 [\fB\-D\fR|\fB\-\-disassemble\-all\fR]
72 [\fB\-z\fR|\fB\-\-disassemble\-zeroes\fR]
73 [\fB\-EB\fR|\fB\-EL\fR|\fB\-\-endian=\fR{big | little }]
74 [\fB\-f\fR|\fB\-\-file\-headers\fR]
75 [\fB\-F\fR|\fB\-\-file\-offsets\fR]
76 [\fB\-\-file\-start\-context\fR]
77 [\fB\-g\fR|\fB\-\-debugging\fR]
78 [\fB\-e\fR|\fB\-\-debugging\-tags\fR]
79 [\fB\-h\fR|\fB\-\-section\-headers\fR|\fB\-\-headers\fR]
80 [\fB\-i\fR|\fB\-\-info\fR]
81 [\fB\-j\fR \fIsection\fR|\fB\-\-section=\fR\fIsection\fR]
82 [\fB\-l\fR|\fB\-\-line\-numbers\fR]
83 [\fB\-S\fR|\fB\-\-source\fR]
84 [\fB\-\-source\-comment\fR[=\fItext\fR]]
85 [\fB\-m\fR \fImachine\fR|\fB\-\-architecture=\fR\fImachine\fR]
86 [\fB\-M\fR \fIoptions\fR|\fB\-\-disassembler\-options=\fR\fIoptions\fR]
87 [\fB\-p\fR|\fB\-\-private\-headers\fR]
88 [\fB\-P\fR \fIoptions\fR|\fB\-\-private=\fR\fIoptions\fR]
89 [\fB\-r\fR|\fB\-\-reloc\fR]
90 [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR]
91 [\fB\-s\fR|\fB\-\-full\-contents\fR]
92 [\fB\-Z\fR|\fB\-\-decompress\fR]
93 [\fB\-W[lLiaprmfFsoORtUuTgAck]\fR|
94 \fB\-\-dwarf\fR[=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]]
95 [\fB\-WK\fR|\fB\-\-dwarf=follow\-links\fR]
96 [\fB\-WN\fR|\fB\-\-dwarf=no\-follow\-links\fR]
97 [\fB\-wD\fR|\fB\-\-dwarf=use\-debuginfod\fR]
98 [\fB\-wE\fR|\fB\-\-dwarf=do\-not\-use\-debuginfod\fR]
99 [\fB\-L\fR|\fB\-\-process\-links\fR]
100 [\fB\-\-ctf=\fR\fIsection\fR]
101 [\fB\-\-sframe=\fR\fIsection\fR]
102 [\fB\-G\fR|\fB\-\-stabs\fR]
103 [\fB\-t\fR|\fB\-\-syms\fR]
104 [\fB\-T\fR|\fB\-\-dynamic\-syms\fR]
105 [\fB\-x\fR|\fB\-\-all\-headers\fR]
106 [\fB\-w\fR|\fB\-\-wide\fR]
107 [\fB\-\-start\-address=\fR\fIaddress\fR]
108 [\fB\-\-stop\-address=\fR\fIaddress\fR]
109 [\fB\-\-no\-addresses\fR]
110 [\fB\-\-prefix\-addresses\fR]
111 [\fB\-\-[no\-]show\-raw\-insn\fR]
112 [\fB\-\-adjust\-vma=\fR\fIoffset\fR]
113 [\fB\-\-show\-all\-symbols\fR]
114 [\fB\-\-dwarf\-depth=\fR\fIn\fR]
115 [\fB\-\-dwarf\-start=\fR\fIn\fR]
116 [\fB\-\-ctf\-parent=\fR\fIsection\fR]
117 [\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR]
118 [\fB\-\-special\-syms\fR]
119 [\fB\-\-prefix=\fR\fIprefix\fR]
120 [\fB\-\-prefix\-strip=\fR\fIlevel\fR]
121 [\fB\-\-insn\-width=\fR\fIwidth\fR]
122 [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR
123 [\fB\-\-disassembler\-color=[off|terminal|on|extended]\fR
124 [\fB\-U\fR \fImethod\fR] [\fB\-\-unicode=\fR\fImethod\fR]
125 [\fB\-V\fR|\fB\-\-version\fR]
126 [\fB\-H\fR|\fB\-\-help\fR]
127 \fIobjfile\fR...
128 .SH DESCRIPTION
129 .IX Header "DESCRIPTION"
130 \&\fBobjdump\fR displays information about one or more object files.
131 The options control what particular information to display. This
132 information is mostly useful to programmers who are working on the
133 compilation tools, as opposed to programmers who just want their
134 program to compile and work.
135 .PP
136 \&\fIobjfile\fR... are the object files to be examined. When you
137 specify archives, \fBobjdump\fR shows information on each of the member
138 object files.
139 .SH OPTIONS
140 .IX Header "OPTIONS"
141 The long and short forms of options, shown here as alternatives, are
142 equivalent. At least one option from the list
143 \&\fB\-a,\-d,\-D,\-e,\-f,\-g,\-G,\-h,\-H,\-p,\-P,\-r,\-R,\-s,\-S,\-t,\-T,\-V,\-x\fR must be given.
144 .IP \fB\-a\fR 4
145 .IX Item "-a"
146 .PD 0
147 .IP \fB\-\-archive\-header\fR 4
148 .IX Item "--archive-header"
149 .PD
150 If any of the \fIobjfile\fR files are archives, display the archive
151 header information (in a format similar to \fBls \-l\fR). Besides the
152 information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
153 the object file format of each archive member.
154 .IP \fB\-\-adjust\-vma=\fR\fIoffset\fR 4
155 .IX Item "--adjust-vma=offset"
156 When dumping information, first add \fIoffset\fR to all the section
157 addresses. This is useful if the section addresses do not correspond to
158 the symbol table, which can happen when putting sections at particular
159 addresses when using a format which can not represent section addresses,
160 such as a.out.
161 .IP "\fB\-b\fR \fIbfdname\fR" 4
162 .IX Item "-b bfdname"
163 .PD 0
164 .IP \fB\-\-target=\fR\fIbfdname\fR 4
165 .IX Item "--target=bfdname"
166 .PD
167 Specify that the object-code format for the object files is
168 \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
169 automatically recognize many formats.
170 .Sp
171 For example,
172 .Sp
173 .Vb 1
174 \& objdump \-b oasys \-m vax \-h fu.o
175 .Ve
176 .Sp
177 displays summary information from the section headers (\fB\-h\fR) of
178 \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a VAX object
179 file in the format produced by Oasys compilers. You can list the
180 formats available with the \fB\-i\fR option.
181 .IP \fB\-C\fR 4
182 .IX Item "-C"
183 .PD 0
184 .IP \fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR 4
185 .IX Item "--demangle[=style]"
186 .PD
187 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
188 Besides removing any initial underscore prepended by the system, this
189 makes C++ function names readable. Different compilers have different
190 mangling styles. The optional demangling style argument can be used to
191 choose an appropriate demangling style for your compiler.
192 .IP \fB\-\-recurse\-limit\fR 4
193 .IX Item "--recurse-limit"
194 .PD 0
195 .IP \fB\-\-no\-recurse\-limit\fR 4
196 .IX Item "--no-recurse-limit"
197 .IP \fB\-\-recursion\-limit\fR 4
198 .IX Item "--recursion-limit"
199 .IP \fB\-\-no\-recursion\-limit\fR 4
200 .IX Item "--no-recursion-limit"
201 .PD
202 Enables or disables a limit on the amount of recursion performed
203 whilst demangling strings. Since the name mangling formats allow for
204 an infinite level of recursion it is possible to create strings whose
205 decoding will exhaust the amount of stack space available on the host
206 machine, triggering a memory fault. The limit tries to prevent this
207 from happening by restricting recursion to 2048 levels of nesting.
208 .Sp
209 The default is for this limit to be enabled, but disabling it may be
210 necessary in order to demangle truly complicated names. Note however
211 that if the recursion limit is disabled then stack exhaustion is
212 possible and any bug reports about such an event will be rejected.
213 .IP \fB\-g\fR 4
214 .IX Item "-g"
215 .PD 0
216 .IP \fB\-\-debugging\fR 4
217 .IX Item "--debugging"
218 .PD
219 Display debugging information. This attempts to parse STABS
220 debugging format information stored in the file and print it out using
221 a C like syntax. If no STABS debugging was found this option
222 falls back on the \fB\-W\fR option to print any DWARF information in
223 the file.
224 .IP \fB\-e\fR 4
225 .IX Item "-e"
226 .PD 0
227 .IP \fB\-\-debugging\-tags\fR 4
228 .IX Item "--debugging-tags"
229 .PD
230 Like \fB\-g\fR, but the information is generated in a format compatible
231 with ctags tool.
232 .IP \fB\-d\fR 4
233 .IX Item "-d"
234 .PD 0
235 .IP \fB\-\-disassemble\fR 4
236 .IX Item "--disassemble"
237 .IP \fB\-\-disassemble=\fR\fIsymbol\fR 4
238 .IX Item "--disassemble=symbol"
239 .PD
240 Display the assembler mnemonics for the machine instructions from the
241 input file. This option only disassembles those sections which are
242 expected to contain instructions. If the optional \fIsymbol\fR
243 argument is given (perhaps multiple times), then display the assembler
244 mnemonics starting at (all the) \fIsymbol\fR. If \fIsymbol\fR is a
245 function name then disassembly will stop at the end of the function,
246 otherwise it will stop when the next symbol is encountered. If there
247 are no matches for any \fIsymbol\fR then nothing will be displayed.
248 .Sp
249 Note if the \fB\-\-dwarf=follow\-links\fR option is enabled
250 then any symbol tables in linked debug info files will be read in and
251 used when disassembling.
252 .IP \fB\-D\fR 4
253 .IX Item "-D"
254 .PD 0
255 .IP \fB\-\-disassemble\-all\fR 4
256 .IX Item "--disassemble-all"
257 .PD
258 Like \fB\-d\fR, but disassemble the contents of all non-empty
259 non-bss sections, not just those expected to contain instructions.
260 \&\fB\-j\fR may be used to select specific sections.
261 .Sp
262 This option also has a subtle effect on the disassembly of
263 instructions in code sections. When option \fB\-d\fR is in effect
264 objdump will assume that any symbols present in a code section occur
265 on the boundary between instructions and it will refuse to disassemble
266 across such a boundary. When option \fB\-D\fR is in effect however
267 this assumption is supressed. This means that it is possible for the
268 output of \fB\-d\fR and \fB\-D\fR to differ if, for example, data
269 is stored in code sections.
270 .Sp
271 If the target is an ARM architecture this switch also has the effect
272 of forcing the disassembler to decode pieces of data found in code
273 sections as if they were instructions.
274 .Sp
275 Note if the \fB\-\-dwarf=follow\-links\fR option is enabled
276 then any symbol tables in linked debug info files will be read in and
277 used when disassembling.
278 .IP \fB\-\-no\-addresses\fR 4
279 .IX Item "--no-addresses"
280 When disassembling, don't print addresses on each line or for symbols
281 and relocation offsets. In combination with \fB\-\-no\-show\-raw\-insn\fR
282 this may be useful for comparing compiler output.
283 .IP \fB\-\-prefix\-addresses\fR 4
284 .IX Item "--prefix-addresses"
285 When disassembling, print the complete address on each line. This is
286 the older disassembly format.
287 .IP \fB\-EB\fR 4
288 .IX Item "-EB"
289 .PD 0
290 .IP \fB\-EL\fR 4
291 .IX Item "-EL"
292 .IP \fB\-\-endian={big|little}\fR 4
293 .IX Item "--endian={big|little}"
294 .PD
295 Specify the endianness of the object files. This only affects
296 disassembly. This can be useful when disassembling a file format which
297 does not describe endianness information, such as S\-records.
298 .IP \fB\-f\fR 4
299 .IX Item "-f"
300 .PD 0
301 .IP \fB\-\-file\-headers\fR 4
302 .IX Item "--file-headers"
303 .PD
304 Display summary information from the overall header of
305 each of the \fIobjfile\fR files.
306 .IP \fB\-F\fR 4
307 .IX Item "-F"
308 .PD 0
309 .IP \fB\-\-file\-offsets\fR 4
310 .IX Item "--file-offsets"
311 .PD
312 When disassembling sections, whenever a symbol is displayed, also
313 display the file offset of the region of data that is about to be
314 dumped. If zeroes are being skipped, then when disassembly resumes,
315 tell the user how many zeroes were skipped and the file offset of the
316 location from where the disassembly resumes. When dumping sections,
317 display the file offset of the location from where the dump starts.
318 .IP \fB\-\-file\-start\-context\fR 4
319 .IX Item "--file-start-context"
320 Specify that when displaying interlisted source code/disassembly
321 (assumes \fB\-S\fR) from a file that has not yet been displayed, extend the
322 context to the start of the file.
323 .IP \fB\-h\fR 4
324 .IX Item "-h"
325 .PD 0
326 .IP \fB\-\-section\-headers\fR 4
327 .IX Item "--section-headers"
328 .IP \fB\-\-headers\fR 4
329 .IX Item "--headers"
330 .PD
331 Display summary information from the section headers of the
332 object file.
333 .Sp
334 File segments may be relocated to nonstandard addresses, for example by
335 using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
336 \&\fBld\fR. However, some object file formats, such as a.out, do not
337 store the starting address of the file segments. In those situations,
338 although \fBld\fR relocates the sections correctly, using \fBobjdump
339 \&\-h\fR to list the file section headers cannot show the correct addresses.
340 Instead, it shows the usual addresses, which are implicit for the
341 target.
342 .Sp
343 Note, in some cases it is possible for a section to have both the
344 READONLY and the NOREAD attributes set. In such cases the NOREAD
345 attribute takes precedence, but \fBobjdump\fR will report both
346 since the exact setting of the flag bits might be important.
347 .IP \fB\-H\fR 4
348 .IX Item "-H"
349 .PD 0
350 .IP \fB\-\-help\fR 4
351 .IX Item "--help"
352 .PD
353 Print a summary of the options to \fBobjdump\fR and exit.
354 .IP \fB\-i\fR 4
355 .IX Item "-i"
356 .PD 0
357 .IP \fB\-\-info\fR 4
358 .IX Item "--info"
359 .PD
360 Display a list showing all architectures and object formats available
361 for specification with \fB\-b\fR or \fB\-m\fR.
362 .IP "\fB\-j\fR \fIname\fR" 4
363 .IX Item "-j name"
364 .PD 0
365 .IP \fB\-\-section=\fR\fIname\fR 4
366 .IX Item "--section=name"
367 .PD
368 Display information for section \fIname\fR. This option may be
369 specified multiple times.
370 .IP \fB\-L\fR 4
371 .IX Item "-L"
372 .PD 0
373 .IP \fB\-\-process\-links\fR 4
374 .IX Item "--process-links"
375 .PD
376 Display the contents of non-debug sections found in separate debuginfo
377 files that are linked to the main file. This option automatically
378 implies the \fB\-WK\fR option, and only sections requested by other
379 command line options will be displayed.
380 .IP \fB\-l\fR 4
381 .IX Item "-l"
382 .PD 0
383 .IP \fB\-\-line\-numbers\fR 4
384 .IX Item "--line-numbers"
385 .PD
386 Label the display (using debugging information) with the filename and
387 source line numbers corresponding to the object code or relocs shown.
388 Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
389 .IP "\fB\-m\fR \fImachine\fR" 4
390 .IX Item "-m machine"
391 .PD 0
392 .IP \fB\-\-architecture=\fR\fImachine\fR 4
393 .IX Item "--architecture=machine"
394 .PD
395 Specify the architecture to use when disassembling object files. This
396 can be useful when disassembling object files which do not describe
397 architecture information, such as S\-records. You can list the available
398 architectures with the \fB\-i\fR option.
399 .Sp
400 For most architectures it is possible to supply an architecture
401 name and a machine name, separated by a colon. For example
402 \&\fBfoo:bar\fR would refer to the \fBbar\fR machine type in the
403 \&\fBfoo\fR architecture. This can be helpful if objdump has been
404 configured to support multiple architectures.
405 .Sp
406 If the target is an ARM architecture then this switch has an
407 additional effect. It restricts the disassembly to only those
408 instructions supported by the architecture specified by \fImachine\fR.
409 If it is necessary to use this switch because the input file does not
410 contain any architecture information, but it is also desired to
411 disassemble all the instructions use \fB\-marm\fR.
412 .IP "\fB\-M\fR \fIoptions\fR" 4
413 .IX Item "-M options"
414 .PD 0
415 .IP \fB\-\-disassembler\-options=\fR\fIoptions\fR 4
416 .IX Item "--disassembler-options=options"
417 .PD
418 Pass target specific information to the disassembler. Only supported on
419 some targets. If it is necessary to specify more than one
420 disassembler option then multiple \fB\-M\fR options can be used or
421 can be placed together into a comma separated list.
422 .Sp
423 For ARC, \fBdsp\fR controls the printing of DSP instructions,
424 \&\fBspfp\fR selects the printing of FPX single precision FP
425 instructions, \fBdpfp\fR selects the printing of FPX double
426 precision FP instructions, \fBquarkse_em\fR selects the printing of
427 special QuarkSE-EM instructions, \fBfpuda\fR selects the printing
428 of double precision assist instructions, \fBfpus\fR selects the
429 printing of FPU single precision FP instructions, while \fBfpud\fR
430 selects the printing of FPU double precision FP instructions.
431 Additionally, one can choose to have all the immediates printed in
432 hexadecimal using \fBhex\fR. By default, the short immediates are
433 printed using the decimal representation, while the long immediate
434 values are printed as hexadecimal.
435 .Sp
436 \&\fBcpu=...\fR allows one to enforce a particular ISA when disassembling
437 instructions, overriding the \fB\-m\fR value or whatever is in the ELF file.
438 This might be useful to select ARC EM or HS ISA, because architecture is same
439 for those and disassembler relies on private ELF header data to decide if code
440 is for EM or HS. This option might be specified multiple times \- only the
441 latest value will be used. Valid values are same as for the assembler
442 \&\fB\-mcpu=...\fR option.
443 .Sp
444 If the target is an ARM architecture then this switch can be used to
445 select which register name set is used during disassembler. Specifying
446 \&\fB\-M reg-names-std\fR (the default) will select the register names as
447 used in ARM's instruction set documentation, but with register 13 called
448 \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying
449 \&\fB\-M reg-names-apcs\fR will select the name set used by the ARM
450 Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
451 just use \fBr\fR followed by the register number.
452 .Sp
453 There are also two variants on the APCS register naming scheme enabled
454 by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
455 use the ARM/Thumb Procedure Call Standard naming conventions. (Either
456 with the normal register names or the special register names).
457 .Sp
458 This option can also be used for ARM architectures to force the
459 disassembler to interpret all instructions as Thumb instructions by
460 using the switch \fB\-\-disassembler\-options=force\-thumb\fR. This can be
461 useful when attempting to disassemble thumb code produced by other
462 compilers.
463 .Sp
464 For AArch64 targets this switch can be used to set whether instructions are
465 disassembled as the most general instruction using the \fB\-M no-aliases\fR
466 option or whether instruction notes should be generated as comments in the
467 disasssembly using \fB\-M notes\fR.
468 .Sp
469 For the x86, some of the options duplicate functions of the \fB\-m\fR
470 switch, but allow finer grained control.
471 .RS 4
472 .ie n .IP """x86\-64""" 4
473 .el .IP \f(CWx86\-64\fR 4
474 .IX Item "x86-64"
475 .PD 0
476 .ie n .IP """i386""" 4
477 .el .IP \f(CWi386\fR 4
478 .IX Item "i386"
479 .ie n .IP """i8086""" 4
480 .el .IP \f(CWi8086\fR 4
481 .IX Item "i8086"
482 .PD
483 Select disassembly for the given architecture.
484 .ie n .IP """intel""" 4
485 .el .IP \f(CWintel\fR 4
486 .IX Item "intel"
487 .PD 0
488 .ie n .IP """att""" 4
489 .el .IP \f(CWatt\fR 4
490 .IX Item "att"
491 .PD
492 Select between intel syntax mode and AT&T syntax mode.
493 .ie n .IP """amd64""" 4
494 .el .IP \f(CWamd64\fR 4
495 .IX Item "amd64"
496 .PD 0
497 .ie n .IP """intel64""" 4
498 .el .IP \f(CWintel64\fR 4
499 .IX Item "intel64"
500 .PD
501 Select between AMD64 ISA and Intel64 ISA.
502 .ie n .IP """intel\-mnemonic""" 4
503 .el .IP \f(CWintel\-mnemonic\fR 4
504 .IX Item "intel-mnemonic"
505 .PD 0
506 .ie n .IP """att\-mnemonic""" 4
507 .el .IP \f(CWatt\-mnemonic\fR 4
508 .IX Item "att-mnemonic"
509 .PD
510 Select between intel mnemonic mode and AT&T mnemonic mode.
511 Note: \f(CW\*(C`intel\-mnemonic\*(C'\fR implies \f(CW\*(C`intel\*(C'\fR and
512 \&\f(CW\*(C`att\-mnemonic\*(C'\fR implies \f(CW\*(C`att\*(C'\fR.
513 .ie n .IP """addr64""" 4
514 .el .IP \f(CWaddr64\fR 4
515 .IX Item "addr64"
516 .PD 0
517 .ie n .IP """addr32""" 4
518 .el .IP \f(CWaddr32\fR 4
519 .IX Item "addr32"
520 .ie n .IP """addr16""" 4
521 .el .IP \f(CWaddr16\fR 4
522 .IX Item "addr16"
523 .ie n .IP """data32""" 4
524 .el .IP \f(CWdata32\fR 4
525 .IX Item "data32"
526 .ie n .IP """data16""" 4
527 .el .IP \f(CWdata16\fR 4
528 .IX Item "data16"
529 .PD
530 Specify the default address size and operand size. These five options
531 will be overridden if \f(CW\*(C`x86\-64\*(C'\fR, \f(CW\*(C`i386\*(C'\fR or \f(CW\*(C`i8086\*(C'\fR
532 appear later in the option string.
533 .ie n .IP """suffix""" 4
534 .el .IP \f(CWsuffix\fR 4
535 .IX Item "suffix"
536 When in AT&T mode and also for a limited set of instructions when in Intel
537 mode, instructs the disassembler to print a mnemonic suffix even when the
538 suffix could be inferred by the operands or, for certain instructions, the
539 execution mode's defaults.
540 .RE
541 .RS 4
542 .Sp
543 For PowerPC, the \fB\-M\fR argument \fBraw\fR selects
544 disasssembly of hardware insns rather than aliases. For example, you
545 will see \f(CW\*(C`rlwinm\*(C'\fR rather than \f(CW\*(C`clrlwi\*(C'\fR, and \f(CW\*(C`addi\*(C'\fR
546 rather than \f(CW\*(C`li\*(C'\fR. All of the \fB\-m\fR arguments for
547 \&\fBgas\fR that select a CPU are supported. These are:
548 \&\fB403\fR, \fB405\fR, \fB440\fR, \fB464\fR, \fB476\fR,
549 \&\fB601\fR, \fB603\fR, \fB604\fR, \fB620\fR, \fB7400\fR,
550 \&\fB7410\fR, \fB7450\fR, \fB7455\fR, \fB750cl\fR,
551 \&\fB821\fR, \fB850\fR, \fB860\fR, \fBa2\fR, \fBbooke\fR,
552 \&\fBbooke32\fR, \fBcell\fR, \fBcom\fR, \fBe200z2\fR, \fBe200z4\fR,
553 \&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR,
554 \&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR,
555 \&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR,
556 \&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBpower11\fR,
557 \&\fBppc\fR, \fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR,
558 \&\fBppcps\fR, \fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR,
559 \&\fBpwr5x\fR, \fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR,
560 \&\fBpwr10\fR, \fBpwr11\fR, \fBpwrx\fR, \fBtitan\fR, \fBvle\fR,
561 and \fBfuture\fR.
562 \&\fB32\fR and \fB64\fR modify the default or a prior CPU
563 selection, disabling and enabling 64\-bit insns respectively. In
564 addition, \fBaltivec\fR, \fBany\fR, \fBlsp\fR, \fBhtm\fR,
565 \&\fBvsx\fR, \fBspe\fR and \fBspe2\fR add capabilities to a
566 previous \fIor later\fR CPU selection.
567 \&\fBany\fR will disassemble any opcode known to
568 binutils, but in cases where an opcode has two different meanings or
569 different arguments, you may not see the disassembly you expect.
570 If you disassemble without giving a CPU selection, a default will be
571 chosen from information gleaned by BFD from the object files headers,
572 but the result again may not be as you expect.
573 .Sp
574 For RISC-V, the following options are supported:
575 .ie n .IP """max""" 4
576 .el .IP \f(CWmax\fR 4
577 .IX Item "max"
578 Disassemble without checking architecture string. This is a best effort mode, so
579 for overlapping ISA extensions the first match (possibly incorrect in a given
580 context) will be used to decode the instruction. It's useful, if the ELF file
581 doesn't expose ISA string, preventing automatic ISA subset deduction, and the
582 default fallback ISA string (\f(CW\*(C`rv64gc\*(C'\fR) doesn't cover all instructions in
583 the binary.
584 .ie n .IP """numeric""" 4
585 .el .IP \f(CWnumeric\fR 4
586 .IX Item "numeric"
587 Print numeric register names, rather than ABI names (e.g., print \f(CW\*(C`x2\*(C'\fR
588 instead of \f(CW\*(C`sp\*(C'\fR).
589 .ie n .IP """no\-aliases""" 4
590 .el .IP \f(CWno\-aliases\fR 4
591 .IX Item "no-aliases"
592 Disassemble only into canonical instructions. For example, compressed
593 instructions will be represented as such (\f(CW\*(C`addi sp,sp,\-128\*(C'\fR will be
594 \&\f(CW\*(C`c.addi16sp sp,\-128\*(C'\fR).
595 .ie n .IP """priv\-spec=\fISPEC\fR""" 4
596 .el .IP \f(CWpriv\-spec=\fR\f(CISPEC\fR\f(CW\fR 4
597 .IX Item "priv-spec=SPEC"
598 Print the CSR according to the chosen privilege spec version (e.g.,
599 \&\f(CW1.10\fR, \f(CW1.11\fR, \f(CW1.12\fR, \f(CW1.13\fR).
600 .RE
601 .RS 4
602 .Sp
603 For MIPS, this option controls the printing of instruction mnemonic
604 names and register names in disassembled instructions. Multiple
605 selections from the following may be specified as a comma separated
606 string, and invalid options are ignored:
607 .ie n .IP """no\-aliases""" 4
608 .el .IP \f(CWno\-aliases\fR 4
609 .IX Item "no-aliases"
610 Print the 'raw' instruction mnemonic instead of some pseudo
611 instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move',
612 \&'sll' instead of 'nop', etc.
613 .ie n .IP """msa""" 4
614 .el .IP \f(CWmsa\fR 4
615 .IX Item "msa"
616 Disassemble MSA instructions.
617 .ie n .IP """virt""" 4
618 .el .IP \f(CWvirt\fR 4
619 .IX Item "virt"
620 Disassemble the virtualization ASE instructions.
621 .ie n .IP """xpa""" 4
622 .el .IP \f(CWxpa\fR 4
623 .IX Item "xpa"
624 Disassemble the eXtended Physical Address (XPA) ASE instructions.
625 .ie n .IP """gpr\-names=\fIABI\fR""" 4
626 .el .IP \f(CWgpr\-names=\fR\f(CIABI\fR\f(CW\fR 4
627 .IX Item "gpr-names=ABI"
628 Print GPR (general-purpose register) names as appropriate
629 for the specified ABI. By default, GPR names are selected according to
630 the ABI of the binary being disassembled.
631 .ie n .IP """fpr\-names=\fIABI\fR""" 4
632 .el .IP \f(CWfpr\-names=\fR\f(CIABI\fR\f(CW\fR 4
633 .IX Item "fpr-names=ABI"
634 Print FPR (floating-point register) names as
635 appropriate for the specified ABI. By default, FPR numbers are printed
636 rather than names.
637 .ie n .IP """cp0\-names=\fIARCH\fR""" 4
638 .el .IP \f(CWcp0\-names=\fR\f(CIARCH\fR\f(CW\fR 4
639 .IX Item "cp0-names=ARCH"
640 Print CP0 (system control coprocessor; coprocessor 0) register names
641 as appropriate for the CPU or architecture specified by
642 \&\fIARCH\fR. By default, CP0 register names are selected according to
643 the architecture and CPU of the binary being disassembled.
644 .ie n .IP """hwr\-names=\fIARCH\fR""" 4
645 .el .IP \f(CWhwr\-names=\fR\f(CIARCH\fR\f(CW\fR 4
646 .IX Item "hwr-names=ARCH"
647 Print HWR (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
648 as appropriate for the CPU or architecture specified by
649 \&\fIARCH\fR. By default, HWR names are selected according to
650 the architecture and CPU of the binary being disassembled.
651 .ie n .IP """reg\-names=\fIABI\fR""" 4
652 .el .IP \f(CWreg\-names=\fR\f(CIABI\fR\f(CW\fR 4
653 .IX Item "reg-names=ABI"
654 Print GPR and FPR names as appropriate for the selected ABI.
655 .ie n .IP """reg\-names=\fIARCH\fR""" 4
656 .el .IP \f(CWreg\-names=\fR\f(CIARCH\fR\f(CW\fR 4
657 .IX Item "reg-names=ARCH"
658 Print CPU-specific register names (CP0 register and HWR names)
659 as appropriate for the selected CPU or architecture.
660 .RE
661 .RS 4
662 .Sp
663 For any of the options listed above, \fIABI\fR or
664 \&\fIARCH\fR may be specified as \fBnumeric\fR to have numbers printed
665 rather than names, for the selected types of registers.
666 You can list the available values of \fIABI\fR and \fIARCH\fR using
667 the \fB\-\-help\fR option.
668 .Sp
669 For VAX, you can specify function entry addresses with \fB\-M
670 entry:0xf00ba\fR. You can use this multiple times to properly
671 disassemble VAX binary files that don't contain symbol tables (like
672 ROM dumps). In these cases, the function entry mask would otherwise
673 be decoded as VAX instructions, which would probably lead the rest
674 of the function being wrongly disassembled.
675 .RE
676 .IP \fB\-p\fR 4
677 .IX Item "-p"
678 .PD 0
679 .IP \fB\-\-private\-headers\fR 4
680 .IX Item "--private-headers"
681 .PD
682 Print information that is specific to the object file format. The exact
683 information printed depends upon the object file format. For some
684 object file formats, no additional information is printed.
685 .IP "\fB\-P\fR \fIoptions\fR" 4
686 .IX Item "-P options"
687 .PD 0
688 .IP \fB\-\-private=\fR\fIoptions\fR 4
689 .IX Item "--private=options"
690 .PD
691 Print information that is specific to the object file format. The
692 argument \fIoptions\fR is a comma separated list that depends on the
693 format (the lists of options is displayed with the help).
694 .Sp
695 For XCOFF, the available options are:
696 .RS 4
697 .ie n .IP """header""" 4
698 .el .IP \f(CWheader\fR 4
699 .IX Item "header"
700 .PD 0
701 .ie n .IP """aout""" 4
702 .el .IP \f(CWaout\fR 4
703 .IX Item "aout"
704 .ie n .IP """sections""" 4
705 .el .IP \f(CWsections\fR 4
706 .IX Item "sections"
707 .ie n .IP """syms""" 4
708 .el .IP \f(CWsyms\fR 4
709 .IX Item "syms"
710 .ie n .IP """relocs""" 4
711 .el .IP \f(CWrelocs\fR 4
712 .IX Item "relocs"
713 .ie n .IP """lineno,""" 4
714 .el .IP \f(CWlineno,\fR 4
715 .IX Item "lineno,"
716 .ie n .IP """loader""" 4
717 .el .IP \f(CWloader\fR 4
718 .IX Item "loader"
719 .ie n .IP """except""" 4
720 .el .IP \f(CWexcept\fR 4
721 .IX Item "except"
722 .ie n .IP """typchk""" 4
723 .el .IP \f(CWtypchk\fR 4
724 .IX Item "typchk"
725 .ie n .IP """traceback""" 4
726 .el .IP \f(CWtraceback\fR 4
727 .IX Item "traceback"
728 .ie n .IP """toc""" 4
729 .el .IP \f(CWtoc\fR 4
730 .IX Item "toc"
731 .ie n .IP """ldinfo""" 4
732 .el .IP \f(CWldinfo\fR 4
733 .IX Item "ldinfo"
734 .RE
735 .RS 4
736 .PD
737 .Sp
738 For PE, the available options are:
739 .ie n .IP """header""" 4
740 .el .IP \f(CWheader\fR 4
741 .IX Item "header"
742 .PD 0
743 .ie n .IP """sections""" 4
744 .el .IP \f(CWsections\fR 4
745 .IX Item "sections"
746 .RE
747 .RS 4
748 .PD
749 .Sp
750 Not all object formats support this option. In particular the ELF
751 format does not use it.
752 .RE
753 .IP \fB\-r\fR 4
754 .IX Item "-r"
755 .PD 0
756 .IP \fB\-\-reloc\fR 4
757 .IX Item "--reloc"
758 .PD
759 Print the relocation entries of the file. If used with \fB\-d\fR or
760 \&\fB\-D\fR, the relocations are printed interspersed with the
761 disassembly.
762 .IP \fB\-R\fR 4
763 .IX Item "-R"
764 .PD 0
765 .IP \fB\-\-dynamic\-reloc\fR 4
766 .IX Item "--dynamic-reloc"
767 .PD
768 Print the dynamic relocation entries of the file. This is only
769 meaningful for dynamic objects, such as certain types of shared
770 libraries. As for \fB\-r\fR, if used with \fB\-d\fR or
771 \&\fB\-D\fR, the relocations are printed interspersed with the
772 disassembly.
773 .Sp
774 Note: \fBobjdump\fR does not support displaying RELR type
775 relocations. These can be displayed by the \fBreadelf\fR program.
776 .IP \fB\-s\fR 4
777 .IX Item "-s"
778 .PD 0
779 .IP \fB\-\-full\-contents\fR 4
780 .IX Item "--full-contents"
781 .PD
782 Display the full contents of sections, often used in combination with
783 \&\fB\-j\fR to request specific sections. By default all non-empty
784 non-bss sections are displayed. By default any compressed section
785 will be displayed in its compressed form. In order to see the
786 contents in a decompressed form add the \fB\-Z\fR option to the
787 command line.
788 .IP \fB\-S\fR 4
789 .IX Item "-S"
790 .PD 0
791 .IP \fB\-\-source\fR 4
792 .IX Item "--source"
793 .PD
794 Display source code intermixed with disassembly, if possible. Implies
795 \&\fB\-d\fR.
796 .IP \fB\-\-show\-all\-symbols\fR 4
797 .IX Item "--show-all-symbols"
798 When disassembling, show all the symbols that match a given address,
799 not just the first one.
800 .IP \fB\-\-source\-comment[=\fR\fItxt\fR\fB]\fR 4
801 .IX Item "--source-comment[=txt]"
802 Like the \fB\-S\fR option, but all source code lines are displayed
803 with a prefix of \fItxt\fR. Typically \fItxt\fR will be a comment
804 string which can be used to distinguish the assembler code from the
805 source code. If \fItxt\fR is not provided then a default string of
806 \&\fI"# "\fR (hash followed by a space), will be used.
807 .IP \fB\-\-prefix=\fR\fIprefix\fR 4
808 .IX Item "--prefix=prefix"
809 Specify \fIprefix\fR to add to the absolute paths when used with
810 \&\fB\-S\fR.
811 .IP \fB\-\-prefix\-strip=\fR\fIlevel\fR 4
812 .IX Item "--prefix-strip=level"
813 Indicate how many initial directory names to strip off the hardwired
814 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
815 .IP \fB\-\-show\-raw\-insn\fR 4
816 .IX Item "--show-raw-insn"
817 When disassembling instructions, print the instruction in hex as well as
818 in symbolic form. This is the default except when
819 \&\fB\-\-prefix\-addresses\fR is used.
820 .IP \fB\-\-no\-show\-raw\-insn\fR 4
821 .IX Item "--no-show-raw-insn"
822 When disassembling instructions, do not print the instruction bytes.
823 This is the default when \fB\-\-prefix\-addresses\fR is used.
824 .IP \fB\-\-insn\-width=\fR\fIwidth\fR 4
825 .IX Item "--insn-width=width"
826 Display \fIwidth\fR bytes on a single line when disassembling
827 instructions.
828 .IP \fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR 4
829 .IX Item "--visualize-jumps[=color|=extended-color|=off]"
830 Visualize jumps that stay inside a function by drawing ASCII art between
831 the start and target addresses. The optional \fB=color\fR argument
832 adds color to the output using simple terminal colors. Alternatively
833 the \fB=extended\-color\fR argument will add color using 8bit
834 colors, but these might not work on all terminals.
835 .Sp
836 If it is necessary to disable the \fBvisualize-jumps\fR option
837 after it has previously been enabled then use
838 \&\fBvisualize\-jumps=off\fR.
839 .IP \fB\-\-disassembler\-color=off\fR 4
840 .IX Item "--disassembler-color=off"
841 .PD 0
842 .IP \fB\-\-disassembler\-color=terminal\fR 4
843 .IX Item "--disassembler-color=terminal"
844 .IP \fB\-\-disassembler\-color=on|color|colour\fR 4
845 .IX Item "--disassembler-color=on|color|colour"
846 .IP \fB\-\-disassembler\-color=extended|extended\-color|extended\-colour\fR 4
847 .IX Item "--disassembler-color=extended|extended-color|extended-colour"
848 .PD
849 Enables or disables the use of colored syntax highlighting in
850 disassembly output. The default behaviour is determined via a
851 configure time option. Note, not all architectures support colored
852 syntax highlighting, and depending upon the terminal used, colored
853 output may not actually be legible.
854 .Sp
855 The \fBon\fR argument adds colors using simple terminal colors.
856 .Sp
857 The \fBterminal\fR argument does the same, but only if the output
858 device is a terminal.
859 .Sp
860 The \fBextended-color\fR argument is similar to the \fBon\fR
861 argument, but it uses 8\-bit colors. These may not work on all
862 terminals.
863 .Sp
864 The \fBoff\fR argument disables colored disassembly.
865 .IP \fB\-W[lLiaprmfFsoORtUuTgAckK]\fR 4
866 .IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
867 .PD 0
868 .IP \fB\-\-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]\fR 4
869 .IX Item "--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]"
870 .PD
871 Displays the contents of the DWARF debug sections in the file, if any
872 are present. Compressed debug sections are automatically decompressed
873 (temporarily) before they are displayed. If one or more of the
874 optional letters or words follows the switch then only those type(s)
875 of data will be dumped. The letters and words refer to the following
876 information:
877 .RS 4
878 .ie n .IP """a""" 4
879 .el .IP \f(CWa\fR 4
880 .IX Item "a"
881 .PD 0
882 .ie n .IP """=abbrev""" 4
883 .el .IP \f(CW=abbrev\fR 4
884 .IX Item "=abbrev"
885 .PD
886 Displays the contents of the \fB.debug_abbrev\fR section.
887 .ie n .IP """A""" 4
888 .el .IP \f(CWA\fR 4
889 .IX Item "A"
890 .PD 0
891 .ie n .IP """=addr""" 4
892 .el .IP \f(CW=addr\fR 4
893 .IX Item "=addr"
894 .PD
895 Displays the contents of the \fB.debug_addr\fR section.
896 .ie n .IP """c""" 4
897 .el .IP \f(CWc\fR 4
898 .IX Item "c"
899 .PD 0
900 .ie n .IP """=cu_index""" 4
901 .el .IP \f(CW=cu_index\fR 4
902 .IX Item "=cu_index"
903 .PD
904 Displays the contents of the \fB.debug_cu_index\fR and/or
905 \&\fB.debug_tu_index\fR sections.
906 .ie n .IP """f""" 4
907 .el .IP \f(CWf\fR 4
908 .IX Item "f"
909 .PD 0
910 .ie n .IP """=frames""" 4
911 .el .IP \f(CW=frames\fR 4
912 .IX Item "=frames"
913 .PD
914 Display the raw contents of a \fB.debug_frame\fR section.
915 .ie n .IP """F""" 4
916 .el .IP \f(CWF\fR 4
917 .IX Item "F"
918 .PD 0
919 .ie n .IP """=frames\-interp""" 4
920 .el .IP \f(CW=frames\-interp\fR 4
921 .IX Item "=frames-interp"
922 .PD
923 Display the interpreted contents of a \fB.debug_frame\fR section.
924 .ie n .IP """g""" 4
925 .el .IP \f(CWg\fR 4
926 .IX Item "g"
927 .PD 0
928 .ie n .IP """=gdb_index""" 4
929 .el .IP \f(CW=gdb_index\fR 4
930 .IX Item "=gdb_index"
931 .PD
932 Displays the contents of the \fB.gdb_index\fR and/or
933 \&\fB.debug_names\fR sections.
934 .ie n .IP """i""" 4
935 .el .IP \f(CWi\fR 4
936 .IX Item "i"
937 .PD 0
938 .ie n .IP """=info""" 4
939 .el .IP \f(CW=info\fR 4
940 .IX Item "=info"
941 .PD
942 Displays the contents of the \fB.debug_info\fR section. Note: the
943 output from this option can also be restricted by the use of the
944 \&\fB\-\-dwarf\-depth\fR and \fB\-\-dwarf\-start\fR options.
945 .ie n .IP """k""" 4
946 .el .IP \f(CWk\fR 4
947 .IX Item "k"
948 .PD 0
949 .ie n .IP """=links""" 4
950 .el .IP \f(CW=links\fR 4
951 .IX Item "=links"
952 .PD
953 Displays the contents of the \fB.gnu_debuglink\fR,
954 \&\fB.gnu_debugaltlink\fR and \fB.debug_sup\fR sections, if any of
955 them are present. Also displays any links to separate dwarf object
956 files (dwo), if they are specified by the DW_AT_GNU_dwo_name or
957 DW_AT_dwo_name attributes in the \fB.debug_info\fR section.
958 .ie n .IP """K""" 4
959 .el .IP \f(CWK\fR 4
960 .IX Item "K"
961 .PD 0
962 .ie n .IP """=follow\-links""" 4
963 .el .IP \f(CW=follow\-links\fR 4
964 .IX Item "=follow-links"
965 .PD
966 Display the contents of any selected debug sections that are found in
967 linked, separate debug info file(s). This can result in multiple
968 versions of the same debug section being displayed if it exists in
969 more than one file.
970 .Sp
971 In addition, when displaying DWARF attributes, if a form is found that
972 references the separate debug info file, then the referenced contents
973 will also be displayed.
974 .Sp
975 Note \- in some distributions this option is enabled by default. It
976 can be disabled via the \fBN\fR debug option. The default can be
977 chosen when configuring the binutils via the
978 \&\fB\-\-enable\-follow\-debug\-links=yes\fR or
979 \&\fB\-\-enable\-follow\-debug\-links=no\fR options. If these are not
980 used then the default is to enable the following of debug links.
981 .Sp
982 Note \- if support for the debuginfod protocol was enabled when the
983 binutils were built then this option will also include an attempt to
984 contact any debuginfod servers mentioned in the \fIDEBUGINFOD_URLS\fR
985 environment variable. This could take some time to resolve. This
986 behaviour can be disabled via the \fB=do\-not\-use\-debuginfod\fR debug
987 option.
988 .ie n .IP """N""" 4
989 .el .IP \f(CWN\fR 4
990 .IX Item "N"
991 .PD 0
992 .ie n .IP """=no\-follow\-links""" 4
993 .el .IP \f(CW=no\-follow\-links\fR 4
994 .IX Item "=no-follow-links"
995 .PD
996 Disables the following of links to separate debug info files.
997 .ie n .IP """D""" 4
998 .el .IP \f(CWD\fR 4
999 .IX Item "D"
1000 .PD 0
1001 .ie n .IP """=use\-debuginfod""" 4
1002 .el .IP \f(CW=use\-debuginfod\fR 4
1003 .IX Item "=use-debuginfod"
1004 .PD
1005 Enables contacting debuginfod servers if there is a need to follow
1006 debug links. This is the default behaviour.
1007 .ie n .IP """E""" 4
1008 .el .IP \f(CWE\fR 4
1009 .IX Item "E"
1010 .PD 0
1011 .ie n .IP """=do\-not\-use\-debuginfod""" 4
1012 .el .IP \f(CW=do\-not\-use\-debuginfod\fR 4
1013 .IX Item "=do-not-use-debuginfod"
1014 .PD
1015 Disables contacting debuginfod servers when there is a need to follow
1016 debug links.
1017 .ie n .IP """l""" 4
1018 .el .IP \f(CWl\fR 4
1019 .IX Item "l"
1020 .PD 0
1021 .ie n .IP """=rawline""" 4
1022 .el .IP \f(CW=rawline\fR 4
1023 .IX Item "=rawline"
1024 .PD
1025 Displays the contents of the \fB.debug_line\fR section in a raw
1026 format.
1027 .ie n .IP """L""" 4
1028 .el .IP \f(CWL\fR 4
1029 .IX Item "L"
1030 .PD 0
1031 .ie n .IP """=decodedline""" 4
1032 .el .IP \f(CW=decodedline\fR 4
1033 .IX Item "=decodedline"
1034 .PD
1035 Displays the interpreted contents of the \fB.debug_line\fR section.
1036 .ie n .IP """m""" 4
1037 .el .IP \f(CWm\fR 4
1038 .IX Item "m"
1039 .PD 0
1040 .ie n .IP """=macro""" 4
1041 .el .IP \f(CW=macro\fR 4
1042 .IX Item "=macro"
1043 .PD
1044 Displays the contents of the \fB.debug_macro\fR and/or
1045 \&\fB.debug_macinfo\fR sections.
1046 .ie n .IP """o""" 4
1047 .el .IP \f(CWo\fR 4
1048 .IX Item "o"
1049 .PD 0
1050 .ie n .IP """=loc""" 4
1051 .el .IP \f(CW=loc\fR 4
1052 .IX Item "=loc"
1053 .PD
1054 Displays the contents of the \fB.debug_loc\fR and/or
1055 \&\fB.debug_loclists\fR sections.
1056 .ie n .IP """O""" 4
1057 .el .IP \f(CWO\fR 4
1058 .IX Item "O"
1059 .PD 0
1060 .ie n .IP """=str\-offsets""" 4
1061 .el .IP \f(CW=str\-offsets\fR 4
1062 .IX Item "=str-offsets"
1063 .PD
1064 Displays the contents of the \fB.debug_str_offsets\fR section.
1065 .ie n .IP """p""" 4
1066 .el .IP \f(CWp\fR 4
1067 .IX Item "p"
1068 .PD 0
1069 .ie n .IP """=pubnames""" 4
1070 .el .IP \f(CW=pubnames\fR 4
1071 .IX Item "=pubnames"
1072 .PD
1073 Displays the contents of the \fB.debug_pubnames\fR and/or
1074 \&\fB.debug_gnu_pubnames\fR sections.
1075 .ie n .IP """r""" 4
1076 .el .IP \f(CWr\fR 4
1077 .IX Item "r"
1078 .PD 0
1079 .ie n .IP """=aranges""" 4
1080 .el .IP \f(CW=aranges\fR 4
1081 .IX Item "=aranges"
1082 .PD
1083 Displays the contents of the \fB.debug_aranges\fR section.
1084 .ie n .IP """R""" 4
1085 .el .IP \f(CWR\fR 4
1086 .IX Item "R"
1087 .PD 0
1088 .ie n .IP """=Ranges""" 4
1089 .el .IP \f(CW=Ranges\fR 4
1090 .IX Item "=Ranges"
1091 .PD
1092 Displays the contents of the \fB.debug_ranges\fR and/or
1093 \&\fB.debug_rnglists\fR sections.
1094 .ie n .IP """s""" 4
1095 .el .IP \f(CWs\fR 4
1096 .IX Item "s"
1097 .PD 0
1098 .ie n .IP """=str""" 4
1099 .el .IP \f(CW=str\fR 4
1100 .IX Item "=str"
1101 .PD
1102 Displays the contents of the \fB.debug_str\fR, \fB.debug_line_str\fR
1103 and/or \fB.debug_str_offsets\fR sections.
1104 .ie n .IP """t""" 4
1105 .el .IP \f(CWt\fR 4
1106 .IX Item "t"
1107 .PD 0
1108 .ie n .IP """=pubtype""" 4
1109 .el .IP \f(CW=pubtype\fR 4
1110 .IX Item "=pubtype"
1111 .PD
1112 Displays the contents of the \fB.debug_pubtypes\fR and/or
1113 \&\fB.debug_gnu_pubtypes\fR sections.
1114 .ie n .IP """T""" 4
1115 .el .IP \f(CWT\fR 4
1116 .IX Item "T"
1117 .PD 0
1118 .ie n .IP """=trace_aranges""" 4
1119 .el .IP \f(CW=trace_aranges\fR 4
1120 .IX Item "=trace_aranges"
1121 .PD
1122 Displays the contents of the \fB.trace_aranges\fR section.
1123 .ie n .IP """u""" 4
1124 .el .IP \f(CWu\fR 4
1125 .IX Item "u"
1126 .PD 0
1127 .ie n .IP """=trace_abbrev""" 4
1128 .el .IP \f(CW=trace_abbrev\fR 4
1129 .IX Item "=trace_abbrev"
1130 .PD
1131 Displays the contents of the \fB.trace_abbrev\fR section.
1132 .ie n .IP """U""" 4
1133 .el .IP \f(CWU\fR 4
1134 .IX Item "U"
1135 .PD 0
1136 .ie n .IP """=trace_info""" 4
1137 .el .IP \f(CW=trace_info\fR 4
1138 .IX Item "=trace_info"
1139 .PD
1140 Displays the contents of the \fB.trace_info\fR section.
1141 .RE
1142 .RS 4
1143 .Sp
1144 Note: displaying the contents of \fB.debug_static_funcs\fR,
1145 \&\fB.debug_static_vars\fR and \fBdebug_weaknames\fR sections is not
1146 currently supported.
1147 .RE
1148 .IP \fB\-\-dwarf\-depth=\fR\fIn\fR 4
1149 .IX Item "--dwarf-depth=n"
1150 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
1151 This is only useful with \fB\-\-debug\-dump=info\fR. The default is
1152 to print all DIEs; the special value 0 for \fIn\fR will also have this
1153 effect.
1154 .Sp
1155 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
1156 levels will not be printed. The range for \fIn\fR is zero-based.
1157 .IP \fB\-\-dwarf\-start=\fR\fIn\fR 4
1158 .IX Item "--dwarf-start=n"
1159 Print only DIEs beginning with the DIE numbered \fIn\fR. This is only
1160 useful with \fB\-\-debug\-dump=info\fR.
1161 .Sp
1162 If specified, this option will suppress printing of any header
1163 information and all DIEs before the DIE numbered \fIn\fR. Only
1164 siblings and children of the specified DIE will be printed.
1165 .Sp
1166 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
1167 .IP \fB\-\-dwarf\-check\fR 4
1168 .IX Item "--dwarf-check"
1169 Enable additional checks for consistency of Dwarf information.
1170 .IP \fB\-\-ctf[=\fR\fIsection\fR\fB]\fR 4
1171 .IX Item "--ctf[=section]"
1172 Display the contents of the specified CTF section. CTF sections themselves
1173 contain many subsections, all of which are displayed in order.
1174 .Sp
1175 By default, display the name of the section named \fI.ctf\fR, which is the
1176 name emitted by \fBld\fR.
1177 .IP \fB\-\-ctf\-parent=\fR\fImember\fR 4
1178 .IX Item "--ctf-parent=member"
1179 If the CTF section contains ambiguously-defined types, it will consist
1180 of an archive of many CTF dictionaries, all inheriting from one
1181 dictionary containing unambiguous types. This member is by default
1182 named \fI.ctf\fR, like the section containing it, but it is possible to
1183 change this name using the \f(CW\*(C`ctf_link_set_memb_name_changer\*(C'\fR
1184 function at link time. When looking at CTF archives that have been
1185 created by a linker that uses the name changer to rename the parent
1186 archive member, \fB\-\-ctf\-parent\fR can be used to specify the name
1187 used for the parent.
1188 .IP \fB\-\-ctf\-parent\-section=\fR\fIsection\fR 4
1189 .IX Item "--ctf-parent-section=section"
1190 This option lets you pick a completely different section for the CTF
1191 parent dictionary containing unambiguous types than for the child
1192 dictionaries that contain the ambiguous remainder. The linker does
1193 not emit ELF objects structured like this, but some third-party linkers
1194 may. It's also convenient to inspect CTF written out as multiple raw
1195 files to compose them with objcopy, which can put them in different
1196 ELF sections but not in different members of a single CTF dict.
1197 .IP \fB\-\-sframe[=\fR\fIsection\fR\fB]\fR 4
1198 .IX Item "--sframe[=section]"
1199 Display the contents of the specified SFrame section.
1200 .Sp
1201 By default, display the name of the section named \fI.sframe\fR, which is the
1202 name emitted by \fBld\fR.
1203 .IP \fB\-G\fR 4
1204 .IX Item "-G"
1205 .PD 0
1206 .IP \fB\-\-stabs\fR 4
1207 .IX Item "--stabs"
1208 .PD
1209 Display the full contents of any sections requested. Display the
1210 contents of the .stab and .stab.index and .stab.excl sections from an
1211 ELF file. This is only useful on systems (such as Solaris 2.0) in which
1212 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an ELF
1213 section. In most other file formats, debugging symbol-table entries are
1214 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
1215 output.
1216 .IP \fB\-\-start\-address=\fR\fIaddress\fR 4
1217 .IX Item "--start-address=address"
1218 Start displaying data at the specified address. This affects the output
1219 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1220 .IP \fB\-\-stop\-address=\fR\fIaddress\fR 4
1221 .IX Item "--stop-address=address"
1222 Stop displaying data at the specified address. This affects the output
1223 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1224 .IP \fB\-t\fR 4
1225 .IX Item "-t"
1226 .PD 0
1227 .IP \fB\-\-syms\fR 4
1228 .IX Item "--syms"
1229 .PD
1230 Print the symbol table entries of the file.
1231 This is similar to the information provided by the \fBnm\fR program,
1232 although the display format is different. The format of the output
1233 depends upon the format of the file being dumped, but there are two main
1234 types. One looks like this:
1235 .Sp
1236 .Vb 2
1237 \& [ 4](sec 3)(fl 0x00)(ty 0)(scl 3) (nx 1) 0x00000000 .bss
1238 \& [ 6](sec 1)(fl 0x00)(ty 0)(scl 2) (nx 0) 0x00000000 fred
1239 .Ve
1240 .Sp
1241 where the number inside the square brackets is the number of the entry
1242 in the symbol table, the \fIsec\fR number is the section number, the
1243 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
1244 symbol's type, the \fIscl\fR number is the symbol's storage class and
1245 the \fInx\fR value is the number of auxiliary entries associated with
1246 the symbol. The last two fields are the symbol's value and its name.
1247 .Sp
1248 The other common output format, usually seen with ELF based files,
1249 looks like this:
1250 .Sp
1251 .Vb 2
1252 \& 00000000 l d .bss 00000000 .bss
1253 \& 00000000 g .text 00000000 fred
1254 .Ve
1255 .Sp
1256 Here the first number is the symbol's value (sometimes referred to as
1257 its address). The next field is actually a set of characters and
1258 spaces indicating the flag bits that are set on the symbol. These
1259 characters are described below. Next is the section with which the
1260 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
1261 not connected with any section), or \fI*UND*\fR if the section is
1262 referenced in the file being dumped, but not defined there.
1263 .Sp
1264 After the section name comes another field, a number, which for common
1265 symbols is the alignment and for other symbol is the size. Finally
1266 the symbol's name is displayed.
1267 .Sp
1268 The flag characters are divided into 7 groups as follows:
1269 .RS 4
1270 .ie n .IP """l""" 4
1271 .el .IP \f(CWl\fR 4
1272 .IX Item "l"
1273 .PD 0
1274 .ie n .IP """g""" 4
1275 .el .IP \f(CWg\fR 4
1276 .IX Item "g"
1277 .ie n .IP """u""" 4
1278 .el .IP \f(CWu\fR 4
1279 .IX Item "u"
1280 .ie n .IP """!""" 4
1281 .el .IP \f(CW!\fR 4
1282 .IX Item "!"
1283 .PD
1284 The symbol is a local (l), global (g), unique global (u), neither
1285 global nor local (a space) or both global and local (!). A
1286 symbol can be neither local or global for a variety of reasons, e.g.,
1287 because it is used for debugging, but it is probably an indication of
1288 a bug if it is ever both local and global. Unique global symbols are
1289 a GNU extension to the standard set of ELF symbol bindings. For such
1290 a symbol the dynamic linker will make sure that in the entire process
1291 there is just one symbol with this name and type in use.
1292 .ie n .IP """w""" 4
1293 .el .IP \f(CWw\fR 4
1294 .IX Item "w"
1295 The symbol is weak (w) or strong (a space).
1296 .ie n .IP """C""" 4
1297 .el .IP \f(CWC\fR 4
1298 .IX Item "C"
1299 The symbol denotes a constructor (C) or an ordinary symbol (a space).
1300 .ie n .IP """W""" 4
1301 .el .IP \f(CWW\fR 4
1302 .IX Item "W"
1303 The symbol is a warning (W) or a normal symbol (a space). A warning
1304 symbol's name is a message to be displayed if the symbol following the
1305 warning symbol is ever referenced.
1306 .ie n .IP """I""" 4
1307 .el .IP \f(CWI\fR 4
1308 .IX Item "I"
1309 .PD 0
1310 .ie n .IP """i""" 4
1311 .el .IP \f(CWi\fR 4
1312 .IX Item "i"
1313 .PD
1314 The symbol is an indirect reference to another symbol (I), a function
1315 to be evaluated during reloc processing (i) or a normal symbol (a
1316 space).
1317 .ie n .IP """d""" 4
1318 .el .IP \f(CWd\fR 4
1319 .IX Item "d"
1320 .PD 0
1321 .ie n .IP """D""" 4
1322 .el .IP \f(CWD\fR 4
1323 .IX Item "D"
1324 .PD
1325 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
1326 normal symbol (a space).
1327 .ie n .IP """F""" 4
1328 .el .IP \f(CWF\fR 4
1329 .IX Item "F"
1330 .PD 0
1331 .ie n .IP """f""" 4
1332 .el .IP \f(CWf\fR 4
1333 .IX Item "f"
1334 .ie n .IP """O""" 4
1335 .el .IP \f(CWO\fR 4
1336 .IX Item "O"
1337 .PD
1338 The symbol is the name of a function (F) or a file (f) or an object
1339 (O) or just a normal symbol (a space).
1340 .RE
1341 .RS 4
1342 .RE
1343 .IP \fB\-T\fR 4
1344 .IX Item "-T"
1345 .PD 0
1346 .IP \fB\-\-dynamic\-syms\fR 4
1347 .IX Item "--dynamic-syms"
1348 .PD
1349 Print the dynamic symbol table entries of the file. This is only
1350 meaningful for dynamic objects, such as certain types of shared
1351 libraries. This is similar to the information provided by the \fBnm\fR
1352 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
1353 .Sp
1354 The output format is similar to that produced by the \fB\-\-syms\fR
1355 option, except that an extra field is inserted before the symbol's
1356 name, giving the version information associated with the symbol.
1357 If the version is the default version to be used when resolving
1358 unversioned references to the symbol then it's displayed as is,
1359 otherwise it's put into parentheses.
1360 .IP \fB\-\-special\-syms\fR 4
1361 .IX Item "--special-syms"
1362 When displaying symbols include those which the target considers to be
1363 special in some way and which would not normally be of interest to the
1364 user.
1365 .IP "\fB\-U\fR \fI[d|i|l|e|x|h]\fR" 4
1366 .IX Item "-U [d|i|l|e|x|h]"
1367 .PD 0
1368 .IP \fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR 4
1369 .IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
1370 .PD
1371 Controls the display of UTF\-8 encoded multibyte characters in strings.
1372 The default (\fB\-\-unicode=default\fR) is to give them no special
1373 treatment. The \fB\-\-unicode=locale\fR option displays the sequence
1374 in the current locale, which may or may not support them. The options
1375 \&\fB\-\-unicode=hex\fR and \fB\-\-unicode=invalid\fR display them as
1376 hex byte sequences enclosed by either angle brackets or curly braces.
1377 .Sp
1378 The \fB\-\-unicode=escape\fR option displays them as escape sequences
1379 (\fI\euxxxx\fR) and the \fB\-\-unicode=highlight\fR option displays
1380 them as escape sequences highlighted in red (if supported by the
1381 output device). The colouring is intended to draw attention to the
1382 presence of unicode sequences where they might not be expected.
1383 .IP \fB\-V\fR 4
1384 .IX Item "-V"
1385 .PD 0
1386 .IP \fB\-\-version\fR 4
1387 .IX Item "--version"
1388 .PD
1389 Print the version number of \fBobjdump\fR and exit.
1390 .IP \fB\-x\fR 4
1391 .IX Item "-x"
1392 .PD 0
1393 .IP \fB\-\-all\-headers\fR 4
1394 .IX Item "--all-headers"
1395 .PD
1396 Display all available header information, including the symbol table and
1397 relocation entries. Using \fB\-x\fR is equivalent to specifying all of
1398 \&\fB\-a \-f \-h \-p \-r \-t\fR.
1399 .IP \fB\-w\fR 4
1400 .IX Item "-w"
1401 .PD 0
1402 .IP \fB\-\-wide\fR 4
1403 .IX Item "--wide"
1404 .PD
1405 Format some lines for output devices that have more than 80 columns.
1406 Also do not truncate symbol names when they are displayed.
1407 .IP \fB\-z\fR 4
1408 .IX Item "-z"
1409 .PD 0
1410 .IP \fB\-\-disassemble\-zeroes\fR 4
1411 .IX Item "--disassemble-zeroes"
1412 .PD
1413 Normally the disassembly output will skip blocks of zeroes. This
1414 option directs the disassembler to disassemble those blocks, just like
1415 any other data.
1416 .IP \fB\-Z\fR 4
1417 .IX Item "-Z"
1418 .PD 0
1419 .IP \fB\-\-decompress\fR 4
1420 .IX Item "--decompress"
1421 .PD
1422 The \fB\-Z\fR option is meant to be used in conunction with the
1423 \&\fB\-s\fR option. It instructs \fBobjdump\fR to decompress any
1424 compressed sections before displaying their contents.
1425 .IP \fB@\fR\fIfile\fR 4
1426 .IX Item "@file"
1427 Read command-line options from \fIfile\fR. The options read are
1428 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
1429 does not exist, or cannot be read, then the option will be treated
1430 literally, and not removed.
1431 .Sp
1432 Options in \fIfile\fR are separated by whitespace. A whitespace
1433 character may be included in an option by surrounding the entire
1434 option in either single or double quotes. Any character (including a
1435 backslash) may be included by prefixing the character to be included
1436 with a backslash. The \fIfile\fR may itself contain additional
1437 @\fIfile\fR options; any such options will be processed recursively.
1438 .SH "SEE ALSO"
1439 .IX Header "SEE ALSO"
1440 \&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
1441 .SH COPYRIGHT
1442 .IX Header "COPYRIGHT"
1443 Copyright (c) 1991\-2026 Free Software Foundation, Inc.
1444 .PP
1445 Permission is granted to copy, distribute and/or modify this document
1446 under the terms of the GNU Free Documentation License, Version 1.3
1447 or any later version published by the Free Software Foundation;
1448 with no Invariant Sections, with no Front-Cover Texts, and with no
1449 Back-Cover Texts. A copy of the license is included in the
1450 section entitled "GNU Free Documentation License".