Debian Codegraph @

upstream/fedora-44/man1/objdump.1

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