Debian Codegraph @

upstream/debian-trixie/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 2025-03-03 binutils-2.44 "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, then display the assembler mnemonics starting at
244 \&\fIsymbol\fR. If \fIsymbol\fR is a function name then disassembly
245 will stop at the end of the function, otherwise it will stop when the
246 next symbol is encountered. If there are no matches for \fIsymbol\fR
247 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 MIPS, this option controls the printing of instruction mnemonic
575 names and register names in disassembled instructions. Multiple
576 selections from the following may be specified as a comma separated
577 string, and invalid options are ignored:
578 .ie n .IP """no\-aliases""" 4
579 .el .IP \f(CWno\-aliases\fR 4
580 .IX Item "no-aliases"
581 Print the 'raw' instruction mnemonic instead of some pseudo
582 instruction mnemonic. I.e., print 'daddu' or 'or' instead of 'move',
583 \&'sll' instead of 'nop', etc.
584 .ie n .IP """msa""" 4
585 .el .IP \f(CWmsa\fR 4
586 .IX Item "msa"
587 Disassemble MSA instructions.
588 .ie n .IP """virt""" 4
589 .el .IP \f(CWvirt\fR 4
590 .IX Item "virt"
591 Disassemble the virtualization ASE instructions.
592 .ie n .IP """xpa""" 4
593 .el .IP \f(CWxpa\fR 4
594 .IX Item "xpa"
595 Disassemble the eXtended Physical Address (XPA) ASE instructions.
596 .ie n .IP """gpr\-names=\fIABI\fR""" 4
597 .el .IP \f(CWgpr\-names=\fR\f(CIABI\fR\f(CW\fR 4
598 .IX Item "gpr-names=ABI"
599 Print GPR (general-purpose register) names as appropriate
600 for the specified ABI. By default, GPR names are selected according to
601 the ABI of the binary being disassembled.
602 .ie n .IP """fpr\-names=\fIABI\fR""" 4
603 .el .IP \f(CWfpr\-names=\fR\f(CIABI\fR\f(CW\fR 4
604 .IX Item "fpr-names=ABI"
605 Print FPR (floating-point register) names as
606 appropriate for the specified ABI. By default, FPR numbers are printed
607 rather than names.
608 .ie n .IP """cp0\-names=\fIARCH\fR""" 4
609 .el .IP \f(CWcp0\-names=\fR\f(CIARCH\fR\f(CW\fR 4
610 .IX Item "cp0-names=ARCH"
611 Print CP0 (system control coprocessor; coprocessor 0) register names
612 as appropriate for the CPU or architecture specified by
613 \&\fIARCH\fR. By default, CP0 register names are selected according to
614 the architecture and CPU of the binary being disassembled.
615 .ie n .IP """hwr\-names=\fIARCH\fR""" 4
616 .el .IP \f(CWhwr\-names=\fR\f(CIARCH\fR\f(CW\fR 4
617 .IX Item "hwr-names=ARCH"
618 Print HWR (hardware register, used by the \f(CW\*(C`rdhwr\*(C'\fR instruction) names
619 as appropriate for the CPU or architecture specified by
620 \&\fIARCH\fR. By default, HWR names are selected according to
621 the architecture and CPU of the binary being disassembled.
622 .ie n .IP """reg\-names=\fIABI\fR""" 4
623 .el .IP \f(CWreg\-names=\fR\f(CIABI\fR\f(CW\fR 4
624 .IX Item "reg-names=ABI"
625 Print GPR and FPR names as appropriate for the selected ABI.
626 .ie n .IP """reg\-names=\fIARCH\fR""" 4
627 .el .IP \f(CWreg\-names=\fR\f(CIARCH\fR\f(CW\fR 4
628 .IX Item "reg-names=ARCH"
629 Print CPU-specific register names (CP0 register and HWR names)
630 as appropriate for the selected CPU or architecture.
631 .RE
632 .RS 4
633 .Sp
634 For any of the options listed above, \fIABI\fR or
635 \&\fIARCH\fR may be specified as \fBnumeric\fR to have numbers printed
636 rather than names, for the selected types of registers.
637 You can list the available values of \fIABI\fR and \fIARCH\fR using
638 the \fB\-\-help\fR option.
639 .Sp
640 For VAX, you can specify function entry addresses with \fB\-M
641 entry:0xf00ba\fR. You can use this multiple times to properly
642 disassemble VAX binary files that don't contain symbol tables (like
643 ROM dumps). In these cases, the function entry mask would otherwise
644 be decoded as VAX instructions, which would probably lead the rest
645 of the function being wrongly disassembled.
646 .RE
647 .IP \fB\-p\fR 4
648 .IX Item "-p"
649 .PD 0
650 .IP \fB\-\-private\-headers\fR 4
651 .IX Item "--private-headers"
652 .PD
653 Print information that is specific to the object file format. The exact
654 information printed depends upon the object file format. For some
655 object file formats, no additional information is printed.
656 .IP "\fB\-P\fR \fIoptions\fR" 4
657 .IX Item "-P options"
658 .PD 0
659 .IP \fB\-\-private=\fR\fIoptions\fR 4
660 .IX Item "--private=options"
661 .PD
662 Print information that is specific to the object file format. The
663 argument \fIoptions\fR is a comma separated list that depends on the
664 format (the lists of options is displayed with the help).
665 .Sp
666 For XCOFF, the available options are:
667 .RS 4
668 .ie n .IP """header""" 4
669 .el .IP \f(CWheader\fR 4
670 .IX Item "header"
671 .PD 0
672 .ie n .IP """aout""" 4
673 .el .IP \f(CWaout\fR 4
674 .IX Item "aout"
675 .ie n .IP """sections""" 4
676 .el .IP \f(CWsections\fR 4
677 .IX Item "sections"
678 .ie n .IP """syms""" 4
679 .el .IP \f(CWsyms\fR 4
680 .IX Item "syms"
681 .ie n .IP """relocs""" 4
682 .el .IP \f(CWrelocs\fR 4
683 .IX Item "relocs"
684 .ie n .IP """lineno,""" 4
685 .el .IP \f(CWlineno,\fR 4
686 .IX Item "lineno,"
687 .ie n .IP """loader""" 4
688 .el .IP \f(CWloader\fR 4
689 .IX Item "loader"
690 .ie n .IP """except""" 4
691 .el .IP \f(CWexcept\fR 4
692 .IX Item "except"
693 .ie n .IP """typchk""" 4
694 .el .IP \f(CWtypchk\fR 4
695 .IX Item "typchk"
696 .ie n .IP """traceback""" 4
697 .el .IP \f(CWtraceback\fR 4
698 .IX Item "traceback"
699 .ie n .IP """toc""" 4
700 .el .IP \f(CWtoc\fR 4
701 .IX Item "toc"
702 .ie n .IP """ldinfo""" 4
703 .el .IP \f(CWldinfo\fR 4
704 .IX Item "ldinfo"
705 .RE
706 .RS 4
707 .PD
708 .Sp
709 For PE, the available options are:
710 .ie n .IP """header""" 4
711 .el .IP \f(CWheader\fR 4
712 .IX Item "header"
713 .PD 0
714 .ie n .IP """sections""" 4
715 .el .IP \f(CWsections\fR 4
716 .IX Item "sections"
717 .RE
718 .RS 4
719 .PD
720 .Sp
721 Not all object formats support this option. In particular the ELF
722 format does not use it.
723 .RE
724 .IP \fB\-r\fR 4
725 .IX Item "-r"
726 .PD 0
727 .IP \fB\-\-reloc\fR 4
728 .IX Item "--reloc"
729 .PD
730 Print the relocation entries of the file. If used with \fB\-d\fR or
731 \&\fB\-D\fR, the relocations are printed interspersed with the
732 disassembly.
733 .IP \fB\-R\fR 4
734 .IX Item "-R"
735 .PD 0
736 .IP \fB\-\-dynamic\-reloc\fR 4
737 .IX Item "--dynamic-reloc"
738 .PD
739 Print the dynamic relocation entries of the file. This is only
740 meaningful for dynamic objects, such as certain types of shared
741 libraries. As for \fB\-r\fR, if used with \fB\-d\fR or
742 \&\fB\-D\fR, the relocations are printed interspersed with the
743 disassembly.
744 .IP \fB\-s\fR 4
745 .IX Item "-s"
746 .PD 0
747 .IP \fB\-\-full\-contents\fR 4
748 .IX Item "--full-contents"
749 .PD
750 Display the full contents of sections, often used in combination with
751 \&\fB\-j\fR to request specific sections. By default all non-empty
752 non-bss sections are displayed. By default any compressed section
753 will be displayed in its compressed form. In order to see the
754 contents in a decompressed form add the \fB\-Z\fR option to the
755 command line.
756 .IP \fB\-S\fR 4
757 .IX Item "-S"
758 .PD 0
759 .IP \fB\-\-source\fR 4
760 .IX Item "--source"
761 .PD
762 Display source code intermixed with disassembly, if possible. Implies
763 \&\fB\-d\fR.
764 .IP \fB\-\-show\-all\-symbols\fR 4
765 .IX Item "--show-all-symbols"
766 When disassembling, show all the symbols that match a given address,
767 not just the first one.
768 .IP \fB\-\-source\-comment[=\fR\fItxt\fR\fB]\fR 4
769 .IX Item "--source-comment[=txt]"
770 Like the \fB\-S\fR option, but all source code lines are displayed
771 with a prefix of \fItxt\fR. Typically \fItxt\fR will be a comment
772 string which can be used to distinguish the assembler code from the
773 source code. If \fItxt\fR is not provided then a default string of
774 \&\fI"# "\fR (hash followed by a space), will be used.
775 .IP \fB\-\-prefix=\fR\fIprefix\fR 4
776 .IX Item "--prefix=prefix"
777 Specify \fIprefix\fR to add to the absolute paths when used with
778 \&\fB\-S\fR.
779 .IP \fB\-\-prefix\-strip=\fR\fIlevel\fR 4
780 .IX Item "--prefix-strip=level"
781 Indicate how many initial directory names to strip off the hardwired
782 absolute paths. It has no effect without \fB\-\-prefix=\fR\fIprefix\fR.
783 .IP \fB\-\-show\-raw\-insn\fR 4
784 .IX Item "--show-raw-insn"
785 When disassembling instructions, print the instruction in hex as well as
786 in symbolic form. This is the default except when
787 \&\fB\-\-prefix\-addresses\fR is used.
788 .IP \fB\-\-no\-show\-raw\-insn\fR 4
789 .IX Item "--no-show-raw-insn"
790 When disassembling instructions, do not print the instruction bytes.
791 This is the default when \fB\-\-prefix\-addresses\fR is used.
792 .IP \fB\-\-insn\-width=\fR\fIwidth\fR 4
793 .IX Item "--insn-width=width"
794 Display \fIwidth\fR bytes on a single line when disassembling
795 instructions.
796 .IP \fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR 4
797 .IX Item "--visualize-jumps[=color|=extended-color|=off]"
798 Visualize jumps that stay inside a function by drawing ASCII art between
799 the start and target addresses. The optional \fB=color\fR argument
800 adds color to the output using simple terminal colors. Alternatively
801 the \fB=extended\-color\fR argument will add color using 8bit
802 colors, but these might not work on all terminals.
803 .Sp
804 If it is necessary to disable the \fBvisualize-jumps\fR option
805 after it has previously been enabled then use
806 \&\fBvisualize\-jumps=off\fR.
807 .IP \fB\-\-disassembler\-color=off\fR 4
808 .IX Item "--disassembler-color=off"
809 .PD 0
810 .IP \fB\-\-disassembler\-color=terminal\fR 4
811 .IX Item "--disassembler-color=terminal"
812 .IP \fB\-\-disassembler\-color=on|color|colour\fR 4
813 .IX Item "--disassembler-color=on|color|colour"
814 .IP \fB\-\-disassembler\-color=extened|extended\-color|extened\-colour\fR 4
815 .IX Item "--disassembler-color=extened|extended-color|extened-colour"
816 .PD
817 Enables or disables the use of colored syntax highlighting in
818 disassembly output. The default behaviour is determined via a
819 configure time option. Note, not all architectures support colored
820 syntax highlighting, and depending upon the terminal used, colored
821 output may not actually be legible.
822 .Sp
823 The \fBon\fR argument adds colors using simple terminal colors.
824 .Sp
825 The \fBterminal\fR argument does the same, but only if the output
826 device is a terminal.
827 .Sp
828 The \fBextended-color\fR argument is similar to the \fBon\fR
829 argument, but it uses 8\-bit colors. These may not work on all
830 terminals.
831 .Sp
832 The \fBoff\fR argument disables colored disassembly.
833 .IP \fB\-W[lLiaprmfFsoORtUuTgAckK]\fR 4
834 .IX Item "-W[lLiaprmfFsoORtUuTgAckK]"
835 .PD 0
836 .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
837 .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]"
838 .PD
839 Displays the contents of the DWARF debug sections in the file, if any
840 are present. Compressed debug sections are automatically decompressed
841 (temporarily) before they are displayed. If one or more of the
842 optional letters or words follows the switch then only those type(s)
843 of data will be dumped. The letters and words refer to the following
844 information:
845 .RS 4
846 .ie n .IP """a""" 4
847 .el .IP \f(CWa\fR 4
848 .IX Item "a"
849 .PD 0
850 .ie n .IP """=abbrev""" 4
851 .el .IP \f(CW=abbrev\fR 4
852 .IX Item "=abbrev"
853 .PD
854 Displays the contents of the \fB.debug_abbrev\fR section.
855 .ie n .IP """A""" 4
856 .el .IP \f(CWA\fR 4
857 .IX Item "A"
858 .PD 0
859 .ie n .IP """=addr""" 4
860 .el .IP \f(CW=addr\fR 4
861 .IX Item "=addr"
862 .PD
863 Displays the contents of the \fB.debug_addr\fR section.
864 .ie n .IP """c""" 4
865 .el .IP \f(CWc\fR 4
866 .IX Item "c"
867 .PD 0
868 .ie n .IP """=cu_index""" 4
869 .el .IP \f(CW=cu_index\fR 4
870 .IX Item "=cu_index"
871 .PD
872 Displays the contents of the \fB.debug_cu_index\fR and/or
873 \&\fB.debug_tu_index\fR sections.
874 .ie n .IP """f""" 4
875 .el .IP \f(CWf\fR 4
876 .IX Item "f"
877 .PD 0
878 .ie n .IP """=frames""" 4
879 .el .IP \f(CW=frames\fR 4
880 .IX Item "=frames"
881 .PD
882 Display the raw contents of a \fB.debug_frame\fR section.
883 .ie n .IP """F""" 4
884 .el .IP \f(CWF\fR 4
885 .IX Item "F"
886 .PD 0
887 .ie n .IP """=frames\-interp""" 4
888 .el .IP \f(CW=frames\-interp\fR 4
889 .IX Item "=frames-interp"
890 .PD
891 Display the interpreted contents of a \fB.debug_frame\fR section.
892 .ie n .IP """g""" 4
893 .el .IP \f(CWg\fR 4
894 .IX Item "g"
895 .PD 0
896 .ie n .IP """=gdb_index""" 4
897 .el .IP \f(CW=gdb_index\fR 4
898 .IX Item "=gdb_index"
899 .PD
900 Displays the contents of the \fB.gdb_index\fR and/or
901 \&\fB.debug_names\fR sections.
902 .ie n .IP """i""" 4
903 .el .IP \f(CWi\fR 4
904 .IX Item "i"
905 .PD 0
906 .ie n .IP """=info""" 4
907 .el .IP \f(CW=info\fR 4
908 .IX Item "=info"
909 .PD
910 Displays the contents of the \fB.debug_info\fR section. Note: the
911 output from this option can also be restricted by the use of the
912 \&\fB\-\-dwarf\-depth\fR and \fB\-\-dwarf\-start\fR options.
913 .ie n .IP """k""" 4
914 .el .IP \f(CWk\fR 4
915 .IX Item "k"
916 .PD 0
917 .ie n .IP """=links""" 4
918 .el .IP \f(CW=links\fR 4
919 .IX Item "=links"
920 .PD
921 Displays the contents of the \fB.gnu_debuglink\fR,
922 \&\fB.gnu_debugaltlink\fR and \fB.debug_sup\fR sections, if any of
923 them are present. Also displays any links to separate dwarf object
924 files (dwo), if they are specified by the DW_AT_GNU_dwo_name or
925 DW_AT_dwo_name attributes in the \fB.debug_info\fR section.
926 .ie n .IP """K""" 4
927 .el .IP \f(CWK\fR 4
928 .IX Item "K"
929 .PD 0
930 .ie n .IP """=follow\-links""" 4
931 .el .IP \f(CW=follow\-links\fR 4
932 .IX Item "=follow-links"
933 .PD
934 Display the contents of any selected debug sections that are found in
935 linked, separate debug info file(s). This can result in multiple
936 versions of the same debug section being displayed if it exists in
937 more than one file.
938 .Sp
939 In addition, when displaying DWARF attributes, if a form is found that
940 references the separate debug info file, then the referenced contents
941 will also be displayed.
942 .Sp
943 Note \- in some distributions this option is enabled by default. It
944 can be disabled via the \fBN\fR debug option. The default can be
945 chosen when configuring the binutils via the
946 \&\fB\-\-enable\-follow\-debug\-links=yes\fR or
947 \&\fB\-\-enable\-follow\-debug\-links=no\fR options. If these are not
948 used then the default is to enable the following of debug links.
949 .Sp
950 Note \- if support for the debuginfod protocol was enabled when the
951 binutils were built then this option will also include an attempt to
952 contact any debuginfod servers mentioned in the \fIDEBUGINFOD_URLS\fR
953 environment variable. This could take some time to resolve. This
954 behaviour can be disabled via the \fB=do\-not\-use\-debuginfod\fR debug
955 option.
956 .ie n .IP """N""" 4
957 .el .IP \f(CWN\fR 4
958 .IX Item "N"
959 .PD 0
960 .ie n .IP """=no\-follow\-links""" 4
961 .el .IP \f(CW=no\-follow\-links\fR 4
962 .IX Item "=no-follow-links"
963 .PD
964 Disables the following of links to separate debug info files.
965 .ie n .IP """D""" 4
966 .el .IP \f(CWD\fR 4
967 .IX Item "D"
968 .PD 0
969 .ie n .IP """=use\-debuginfod""" 4
970 .el .IP \f(CW=use\-debuginfod\fR 4
971 .IX Item "=use-debuginfod"
972 .PD
973 Enables contacting debuginfod servers if there is a need to follow
974 debug links. This is the default behaviour.
975 .ie n .IP """E""" 4
976 .el .IP \f(CWE\fR 4
977 .IX Item "E"
978 .PD 0
979 .ie n .IP """=do\-not\-use\-debuginfod""" 4
980 .el .IP \f(CW=do\-not\-use\-debuginfod\fR 4
981 .IX Item "=do-not-use-debuginfod"
982 .PD
983 Disables contacting debuginfod servers when there is a need to follow
984 debug links.
985 .ie n .IP """l""" 4
986 .el .IP \f(CWl\fR 4
987 .IX Item "l"
988 .PD 0
989 .ie n .IP """=rawline""" 4
990 .el .IP \f(CW=rawline\fR 4
991 .IX Item "=rawline"
992 .PD
993 Displays the contents of the \fB.debug_line\fR section in a raw
994 format.
995 .ie n .IP """L""" 4
996 .el .IP \f(CWL\fR 4
997 .IX Item "L"
998 .PD 0
999 .ie n .IP """=decodedline""" 4
1000 .el .IP \f(CW=decodedline\fR 4
1001 .IX Item "=decodedline"
1002 .PD
1003 Displays the interpreted contents of the \fB.debug_line\fR section.
1004 .ie n .IP """m""" 4
1005 .el .IP \f(CWm\fR 4
1006 .IX Item "m"
1007 .PD 0
1008 .ie n .IP """=macro""" 4
1009 .el .IP \f(CW=macro\fR 4
1010 .IX Item "=macro"
1011 .PD
1012 Displays the contents of the \fB.debug_macro\fR and/or
1013 \&\fB.debug_macinfo\fR sections.
1014 .ie n .IP """o""" 4
1015 .el .IP \f(CWo\fR 4
1016 .IX Item "o"
1017 .PD 0
1018 .ie n .IP """=loc""" 4
1019 .el .IP \f(CW=loc\fR 4
1020 .IX Item "=loc"
1021 .PD
1022 Displays the contents of the \fB.debug_loc\fR and/or
1023 \&\fB.debug_loclists\fR sections.
1024 .ie n .IP """O""" 4
1025 .el .IP \f(CWO\fR 4
1026 .IX Item "O"
1027 .PD 0
1028 .ie n .IP """=str\-offsets""" 4
1029 .el .IP \f(CW=str\-offsets\fR 4
1030 .IX Item "=str-offsets"
1031 .PD
1032 Displays the contents of the \fB.debug_str_offsets\fR section.
1033 .ie n .IP """p""" 4
1034 .el .IP \f(CWp\fR 4
1035 .IX Item "p"
1036 .PD 0
1037 .ie n .IP """=pubnames""" 4
1038 .el .IP \f(CW=pubnames\fR 4
1039 .IX Item "=pubnames"
1040 .PD
1041 Displays the contents of the \fB.debug_pubnames\fR and/or
1042 \&\fB.debug_gnu_pubnames\fR sections.
1043 .ie n .IP """r""" 4
1044 .el .IP \f(CWr\fR 4
1045 .IX Item "r"
1046 .PD 0
1047 .ie n .IP """=aranges""" 4
1048 .el .IP \f(CW=aranges\fR 4
1049 .IX Item "=aranges"
1050 .PD
1051 Displays the contents of the \fB.debug_aranges\fR section.
1052 .ie n .IP """R""" 4
1053 .el .IP \f(CWR\fR 4
1054 .IX Item "R"
1055 .PD 0
1056 .ie n .IP """=Ranges""" 4
1057 .el .IP \f(CW=Ranges\fR 4
1058 .IX Item "=Ranges"
1059 .PD
1060 Displays the contents of the \fB.debug_ranges\fR and/or
1061 \&\fB.debug_rnglists\fR sections.
1062 .ie n .IP """s""" 4
1063 .el .IP \f(CWs\fR 4
1064 .IX Item "s"
1065 .PD 0
1066 .ie n .IP """=str""" 4
1067 .el .IP \f(CW=str\fR 4
1068 .IX Item "=str"
1069 .PD
1070 Displays the contents of the \fB.debug_str\fR, \fB.debug_line_str\fR
1071 and/or \fB.debug_str_offsets\fR sections.
1072 .ie n .IP """t""" 4
1073 .el .IP \f(CWt\fR 4
1074 .IX Item "t"
1075 .PD 0
1076 .ie n .IP """=pubtype""" 4
1077 .el .IP \f(CW=pubtype\fR 4
1078 .IX Item "=pubtype"
1079 .PD
1080 Displays the contents of the \fB.debug_pubtypes\fR and/or
1081 \&\fB.debug_gnu_pubtypes\fR sections.
1082 .ie n .IP """T""" 4
1083 .el .IP \f(CWT\fR 4
1084 .IX Item "T"
1085 .PD 0
1086 .ie n .IP """=trace_aranges""" 4
1087 .el .IP \f(CW=trace_aranges\fR 4
1088 .IX Item "=trace_aranges"
1089 .PD
1090 Displays the contents of the \fB.trace_aranges\fR section.
1091 .ie n .IP """u""" 4
1092 .el .IP \f(CWu\fR 4
1093 .IX Item "u"
1094 .PD 0
1095 .ie n .IP """=trace_abbrev""" 4
1096 .el .IP \f(CW=trace_abbrev\fR 4
1097 .IX Item "=trace_abbrev"
1098 .PD
1099 Displays the contents of the \fB.trace_abbrev\fR section.
1100 .ie n .IP """U""" 4
1101 .el .IP \f(CWU\fR 4
1102 .IX Item "U"
1103 .PD 0
1104 .ie n .IP """=trace_info""" 4
1105 .el .IP \f(CW=trace_info\fR 4
1106 .IX Item "=trace_info"
1107 .PD
1108 Displays the contents of the \fB.trace_info\fR section.
1109 .RE
1110 .RS 4
1111 .Sp
1112 Note: displaying the contents of \fB.debug_static_funcs\fR,
1113 \&\fB.debug_static_vars\fR and \fBdebug_weaknames\fR sections is not
1114 currently supported.
1115 .RE
1116 .IP \fB\-\-dwarf\-depth=\fR\fIn\fR 4
1117 .IX Item "--dwarf-depth=n"
1118 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
1119 This is only useful with \fB\-\-debug\-dump=info\fR. The default is
1120 to print all DIEs; the special value 0 for \fIn\fR will also have this
1121 effect.
1122 .Sp
1123 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
1124 levels will not be printed. The range for \fIn\fR is zero-based.
1125 .IP \fB\-\-dwarf\-start=\fR\fIn\fR 4
1126 .IX Item "--dwarf-start=n"
1127 Print only DIEs beginning with the DIE numbered \fIn\fR. This is only
1128 useful with \fB\-\-debug\-dump=info\fR.
1129 .Sp
1130 If specified, this option will suppress printing of any header
1131 information and all DIEs before the DIE numbered \fIn\fR. Only
1132 siblings and children of the specified DIE will be printed.
1133 .Sp
1134 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
1135 .IP \fB\-\-dwarf\-check\fR 4
1136 .IX Item "--dwarf-check"
1137 Enable additional checks for consistency of Dwarf information.
1138 .IP \fB\-\-ctf[=\fR\fIsection\fR\fB]\fR 4
1139 .IX Item "--ctf[=section]"
1140 Display the contents of the specified CTF section. CTF sections themselves
1141 contain many subsections, all of which are displayed in order.
1142 .Sp
1143 By default, display the name of the section named \fI.ctf\fR, which is the
1144 name emitted by \fBld\fR.
1145 .IP \fB\-\-ctf\-parent=\fR\fImember\fR 4
1146 .IX Item "--ctf-parent=member"
1147 If the CTF section contains ambiguously-defined types, it will consist
1148 of an archive of many CTF dictionaries, all inheriting from one
1149 dictionary containing unambiguous types. This member is by default
1150 named \fI.ctf\fR, like the section containing it, but it is possible to
1151 change this name using the \f(CW\*(C`ctf_link_set_memb_name_changer\*(C'\fR
1152 function at link time. When looking at CTF archives that have been
1153 created by a linker that uses the name changer to rename the parent
1154 archive member, \fB\-\-ctf\-parent\fR can be used to specify the name
1155 used for the parent.
1156 .IP \fB\-\-ctf\-parent\-section=\fR\fIsection\fR 4
1157 .IX Item "--ctf-parent-section=section"
1158 This option lets you pick a completely different section for the CTF
1159 parent dictionary containing unambiguous types than for the child
1160 dictionaries that contain the ambiguous remainder. The linker does
1161 not emit ELF objects structured like this, but some third-party linkers
1162 may. It's also convenient to inspect CTF written out as multiple raw
1163 files to compose them with objcopy, which can put them in different
1164 ELF sections but not in different members of a single CTF dict.
1165 .IP \fB\-\-sframe[=\fR\fIsection\fR\fB]\fR 4
1166 .IX Item "--sframe[=section]"
1167 Display the contents of the specified SFrame section.
1168 .Sp
1169 By default, display the name of the section named \fI.sframe\fR, which is the
1170 name emitted by \fBld\fR.
1171 .IP \fB\-G\fR 4
1172 .IX Item "-G"
1173 .PD 0
1174 .IP \fB\-\-stabs\fR 4
1175 .IX Item "--stabs"
1176 .PD
1177 Display the full contents of any sections requested. Display the
1178 contents of the .stab and .stab.index and .stab.excl sections from an
1179 ELF file. This is only useful on systems (such as Solaris 2.0) in which
1180 \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an ELF
1181 section. In most other file formats, debugging symbol-table entries are
1182 interleaved with linkage symbols, and are visible in the \fB\-\-syms\fR
1183 output.
1184 .IP \fB\-\-start\-address=\fR\fIaddress\fR 4
1185 .IX Item "--start-address=address"
1186 Start displaying data at the specified address. This affects the output
1187 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1188 .IP \fB\-\-stop\-address=\fR\fIaddress\fR 4
1189 .IX Item "--stop-address=address"
1190 Stop displaying data at the specified address. This affects the output
1191 of the \fB\-d\fR, \fB\-r\fR and \fB\-s\fR options.
1192 .IP \fB\-t\fR 4
1193 .IX Item "-t"
1194 .PD 0
1195 .IP \fB\-\-syms\fR 4
1196 .IX Item "--syms"
1197 .PD
1198 Print the symbol table entries of the file.
1199 This is similar to the information provided by the \fBnm\fR program,
1200 although the display format is different. The format of the output
1201 depends upon the format of the file being dumped, but there are two main
1202 types. One looks like this:
1203 .Sp
1204 .Vb 2
1205 \& [ 4](sec 3)(fl 0x00)(ty 0)(scl 3) (nx 1) 0x00000000 .bss
1206 \& [ 6](sec 1)(fl 0x00)(ty 0)(scl 2) (nx 0) 0x00000000 fred
1207 .Ve
1208 .Sp
1209 where the number inside the square brackets is the number of the entry
1210 in the symbol table, the \fIsec\fR number is the section number, the
1211 \&\fIfl\fR value are the symbol's flag bits, the \fIty\fR number is the
1212 symbol's type, the \fIscl\fR number is the symbol's storage class and
1213 the \fInx\fR value is the number of auxiliary entries associated with
1214 the symbol. The last two fields are the symbol's value and its name.
1215 .Sp
1216 The other common output format, usually seen with ELF based files,
1217 looks like this:
1218 .Sp
1219 .Vb 2
1220 \& 00000000 l d .bss 00000000 .bss
1221 \& 00000000 g .text 00000000 fred
1222 .Ve
1223 .Sp
1224 Here the first number is the symbol's value (sometimes referred to as
1225 its address). The next field is actually a set of characters and
1226 spaces indicating the flag bits that are set on the symbol. These
1227 characters are described below. Next is the section with which the
1228 symbol is associated or \fI*ABS*\fR if the section is absolute (ie
1229 not connected with any section), or \fI*UND*\fR if the section is
1230 referenced in the file being dumped, but not defined there.
1231 .Sp
1232 After the section name comes another field, a number, which for common
1233 symbols is the alignment and for other symbol is the size. Finally
1234 the symbol's name is displayed.
1235 .Sp
1236 The flag characters are divided into 7 groups as follows:
1237 .RS 4
1238 .ie n .IP """l""" 4
1239 .el .IP \f(CWl\fR 4
1240 .IX Item "l"
1241 .PD 0
1242 .ie n .IP """g""" 4
1243 .el .IP \f(CWg\fR 4
1244 .IX Item "g"
1245 .ie n .IP """u""" 4
1246 .el .IP \f(CWu\fR 4
1247 .IX Item "u"
1248 .ie n .IP """!""" 4
1249 .el .IP \f(CW!\fR 4
1250 .IX Item "!"
1251 .PD
1252 The symbol is a local (l), global (g), unique global (u), neither
1253 global nor local (a space) or both global and local (!). A
1254 symbol can be neither local or global for a variety of reasons, e.g.,
1255 because it is used for debugging, but it is probably an indication of
1256 a bug if it is ever both local and global. Unique global symbols are
1257 a GNU extension to the standard set of ELF symbol bindings. For such
1258 a symbol the dynamic linker will make sure that in the entire process
1259 there is just one symbol with this name and type in use.
1260 .ie n .IP """w""" 4
1261 .el .IP \f(CWw\fR 4
1262 .IX Item "w"
1263 The symbol is weak (w) or strong (a space).
1264 .ie n .IP """C""" 4
1265 .el .IP \f(CWC\fR 4
1266 .IX Item "C"
1267 The symbol denotes a constructor (C) or an ordinary symbol (a space).
1268 .ie n .IP """W""" 4
1269 .el .IP \f(CWW\fR 4
1270 .IX Item "W"
1271 The symbol is a warning (W) or a normal symbol (a space). A warning
1272 symbol's name is a message to be displayed if the symbol following the
1273 warning symbol is ever referenced.
1274 .ie n .IP """I""" 4
1275 .el .IP \f(CWI\fR 4
1276 .IX Item "I"
1277 .PD 0
1278 .ie n .IP """i""" 4
1279 .el .IP \f(CWi\fR 4
1280 .IX Item "i"
1281 .PD
1282 The symbol is an indirect reference to another symbol (I), a function
1283 to be evaluated during reloc processing (i) or a normal symbol (a
1284 space).
1285 .ie n .IP """d""" 4
1286 .el .IP \f(CWd\fR 4
1287 .IX Item "d"
1288 .PD 0
1289 .ie n .IP """D""" 4
1290 .el .IP \f(CWD\fR 4
1291 .IX Item "D"
1292 .PD
1293 The symbol is a debugging symbol (d) or a dynamic symbol (D) or a
1294 normal symbol (a space).
1295 .ie n .IP """F""" 4
1296 .el .IP \f(CWF\fR 4
1297 .IX Item "F"
1298 .PD 0
1299 .ie n .IP """f""" 4
1300 .el .IP \f(CWf\fR 4
1301 .IX Item "f"
1302 .ie n .IP """O""" 4
1303 .el .IP \f(CWO\fR 4
1304 .IX Item "O"
1305 .PD
1306 The symbol is the name of a function (F) or a file (f) or an object
1307 (O) or just a normal symbol (a space).
1308 .RE
1309 .RS 4
1310 .RE
1311 .IP \fB\-T\fR 4
1312 .IX Item "-T"
1313 .PD 0
1314 .IP \fB\-\-dynamic\-syms\fR 4
1315 .IX Item "--dynamic-syms"
1316 .PD
1317 Print the dynamic symbol table entries of the file. This is only
1318 meaningful for dynamic objects, such as certain types of shared
1319 libraries. This is similar to the information provided by the \fBnm\fR
1320 program when given the \fB\-D\fR (\fB\-\-dynamic\fR) option.
1321 .Sp
1322 The output format is similar to that produced by the \fB\-\-syms\fR
1323 option, except that an extra field is inserted before the symbol's
1324 name, giving the version information associated with the symbol.
1325 If the version is the default version to be used when resolving
1326 unversioned references to the symbol then it's displayed as is,
1327 otherwise it's put into parentheses.
1328 .IP \fB\-\-special\-syms\fR 4
1329 .IX Item "--special-syms"
1330 When displaying symbols include those which the target considers to be
1331 special in some way and which would not normally be of interest to the
1332 user.
1333 .IP "\fB\-U\fR \fI[d|i|l|e|x|h]\fR" 4
1334 .IX Item "-U [d|i|l|e|x|h]"
1335 .PD 0
1336 .IP \fB\-\-unicode=\fR\fI[default|invalid|locale|escape|hex|highlight]\fR 4
1337 .IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
1338 .PD
1339 Controls the display of UTF\-8 encoded multibyte characters in strings.
1340 The default (\fB\-\-unicode=default\fR) is to give them no special
1341 treatment. The \fB\-\-unicode=locale\fR option displays the sequence
1342 in the current locale, which may or may not support them. The options
1343 \&\fB\-\-unicode=hex\fR and \fB\-\-unicode=invalid\fR display them as
1344 hex byte sequences enclosed by either angle brackets or curly braces.
1345 .Sp
1346 The \fB\-\-unicode=escape\fR option displays them as escape sequences
1347 (\fI\euxxxx\fR) and the \fB\-\-unicode=highlight\fR option displays
1348 them as escape sequences highlighted in red (if supported by the
1349 output device). The colouring is intended to draw attention to the
1350 presence of unicode sequences where they might not be expected.
1351 .IP \fB\-V\fR 4
1352 .IX Item "-V"
1353 .PD 0
1354 .IP \fB\-\-version\fR 4
1355 .IX Item "--version"
1356 .PD
1357 Print the version number of \fBobjdump\fR and exit.
1358 .IP \fB\-x\fR 4
1359 .IX Item "-x"
1360 .PD 0
1361 .IP \fB\-\-all\-headers\fR 4
1362 .IX Item "--all-headers"
1363 .PD
1364 Display all available header information, including the symbol table and
1365 relocation entries. Using \fB\-x\fR is equivalent to specifying all of
1366 \&\fB\-a \-f \-h \-p \-r \-t\fR.
1367 .IP \fB\-w\fR 4
1368 .IX Item "-w"
1369 .PD 0
1370 .IP \fB\-\-wide\fR 4
1371 .IX Item "--wide"
1372 .PD
1373 Format some lines for output devices that have more than 80 columns.
1374 Also do not truncate symbol names when they are displayed.
1375 .IP \fB\-z\fR 4
1376 .IX Item "-z"
1377 .PD 0
1378 .IP \fB\-\-disassemble\-zeroes\fR 4
1379 .IX Item "--disassemble-zeroes"
1380 .PD
1381 Normally the disassembly output will skip blocks of zeroes. This
1382 option directs the disassembler to disassemble those blocks, just like
1383 any other data.
1384 .IP \fB\-Z\fR 4
1385 .IX Item "-Z"
1386 .PD 0
1387 .IP \fB\-\-decompress\fR 4
1388 .IX Item "--decompress"
1389 .PD
1390 The \fB\-Z\fR option is meant to be used in conunction with the
1391 \&\fB\-s\fR option. It instructs \fBobjdump\fR to decompress any
1392 compressed sections before displaying their contents.
1393 .IP \fB@\fR\fIfile\fR 4
1394 .IX Item "@file"
1395 Read command-line options from \fIfile\fR. The options read are
1396 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
1397 does not exist, or cannot be read, then the option will be treated
1398 literally, and not removed.
1399 .Sp
1400 Options in \fIfile\fR are separated by whitespace. A whitespace
1401 character may be included in an option by surrounding the entire
1402 option in either single or double quotes. Any character (including a
1403 backslash) may be included by prefixing the character to be included
1404 with a backslash. The \fIfile\fR may itself contain additional
1405 @\fIfile\fR options; any such options will be processed recursively.
1406 .SH "SEE ALSO"
1407 .IX Header "SEE ALSO"
1408 \&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
1409 .SH COPYRIGHT
1410 .IX Header "COPYRIGHT"
1411 Copyright (c) 1991\-2025 Free Software Foundation, Inc.
1412 .PP
1413 Permission is granted to copy, distribute and/or modify this document
1414 under the terms of the GNU Free Documentation License, Version 1.3
1415 or any later version published by the Free Software Foundation;
1416 with no Invariant Sections, with no Front-Cover Texts, and with no
1417 Back-Cover Texts. A copy of the license is included in the
1418 section entitled "GNU Free Documentation License".