Debian Codegraph @

upstream/debian-unstable/man1/readelf.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 "READELF 1"
58 .TH READELF 1 2026-03-05 binutils-2.46 "GNU Development Tools"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 readelf \- display information about ELF files
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 readelf [\fB\-a\fR|\fB\-\-all\fR]
68 [\fB\-h\fR|\fB\-\-file\-header\fR]
69 [\fB\-l\fR|\fB\-\-program\-headers\fR|\fB\-\-segments\fR]
70 [\fB\-S\fR|\fB\-\-section\-headers\fR|\fB\-\-sections\fR]
71 [\fB\-g\fR|\fB\-\-section\-groups\fR]
72 [\fB\-t\fR|\fB\-\-section\-details\fR]
73 [\fB\-e\fR|\fB\-\-headers\fR]
74 [\fB\-s\fR|\fB\-\-syms\fR|\fB\-\-symbols\fR]
75 [\fB\-\-dyn\-syms\fR|\fB\-\-lto\-syms\fR]
76 [\fB\-\-sym\-base=[0|8|10|16]\fR]
77 [\fB\-\-demangle\fR\fI=style\fR|\fB\-\-no\-demangle\fR]
78 [\fB\-\-quiet\fR]
79 [\fB\-\-recurse\-limit\fR|\fB\-\-no\-recurse\-limit\fR]
80 [\fB\-U\fR \fImethod\fR|\fB\-\-unicode=\fR\fImethod\fR]
81 [\fB\-X\fR|\fB\-\-extra\-sym\-info\fR|\fB\-\-no\-extra\-sym\-info\fR]
82 [\fB\-n\fR|\fB\-\-notes\fR]
83 [\fB\-r\fR|\fB\-\-relocs\fR]
84 [\fB\-u\fR|\fB\-\-unwind\fR]
85 [\fB\-d\fR|\fB\-\-dynamic\fR]
86 [\fB\-V\fR|\fB\-\-version\-info\fR]
87 [\fB\-A\fR|\fB\-\-arch\-specific\fR]
88 [\fB\-D\fR|\fB\-\-use\-dynamic\fR]
89 [\fB\-L\fR|\fB\-\-lint\fR|\fB\-\-enable\-checks\fR]
90 [\fB\-x\fR <number or name>|\fB\-\-hex\-dump=\fR<number or name>]
91 [\fB\-p\fR <number or name>|\fB\-\-string\-dump=\fR<number or name>]
92 [\fB\-R\fR <number or name>|\fB\-\-relocated\-dump=\fR<number or name>]
93 [\fB\-j\fR <number or name>|\fB\-\-display\-section=\fR<number or name>]
94 [\fB\-z\fR|\fB\-\-decompress\fR]
95 [\fB\-c\fR|\fB\-\-archive\-index\fR]
96 [\fB\-w[lLiaprmfFsoORtUuTgAck]\fR|
97 \fB\-\-debug\-dump\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\-\-debug\-dump=follow\-links\fR]
99 [\fB\-wN\fR|\fB\-\-debug\-dump=no\-follow\-links\fR]
100 [\fB\-wD\fR|\fB\-\-debug\-dump=use\-debuginfod\fR]
101 [\fB\-wE\fR|\fB\-\-debug\-dump=do\-not\-use\-debuginfod\fR]
102 [\fB\-P\fR|\fB\-\-process\-links\fR]
103 [\fB\-\-dwarf\-depth=\fR\fIn\fR]
104 [\fB\-\-dwarf\-start=\fR\fIn\fR]
105 [\fB\-\-ctf=\fR\fIsection\fR]
106 [\fB\-\-ctf\-parent=\fR\fIsection\fR]
107 [\fB\-\-ctf\-symbols=\fR\fIsection\fR]
108 [\fB\-\-ctf\-strings=\fR\fIsection\fR]
109 [\fB\-\-sframe=\fR\fIsection\fR]
110 [\fB\-I\fR|\fB\-\-histogram\fR]
111 [\fB\-\-got\-contents\fR]
112 [\fB\-v\fR|\fB\-\-version\fR]
113 [\fB\-W\fR|\fB\-\-wide\fR]
114 [\fB\-T\fR|\fB\-\-silent\-truncation\fR]
115 [\fB\-H\fR|\fB\-\-help\fR]
116 \fIelffile\fR...
117 .SH DESCRIPTION
118 .IX Header "DESCRIPTION"
119 \&\fBreadelf\fR displays information about one or more ELF format object
120 files. The options control what particular information to display.
121 .PP
122 \&\fIelffile\fR... are the object files to be examined. 32\-bit and
123 64\-bit ELF files are supported, as are archives containing ELF files.
124 .PP
125 This program performs a similar function to \fBobjdump\fR but it
126 goes into more detail and it exists independently of the BFD
127 library, so if there is a bug in BFD then readelf will not be
128 affected.
129 .SH OPTIONS
130 .IX Header "OPTIONS"
131 The long and short forms of options, shown here as alternatives, are
132 equivalent. At least one option besides \fB\-v\fR or \fB\-H\fR must be
133 given.
134 .IP \fB\-a\fR 4
135 .IX Item "-a"
136 .PD 0
137 .IP \fB\-\-all\fR 4
138 .IX Item "--all"
139 .PD
140 Equivalent to specifying \fB\-\-file\-header\fR,
141 \&\fB\-\-program\-headers\fR, \fB\-\-sections\fR, \fB\-\-symbols\fR,
142 \&\fB\-\-relocs\fR, \fB\-\-dynamic\fR, \fB\-\-notes\fR,
143 \&\fB\-\-got\-contents\fR, \fB\-\-version\-info\fR,
144 \&\fB\-\-arch\-specific\fR, \fB\-\-unwind\fR,
145 \&\fB\-\-section\-groups\fR and \fB\-\-histogram\fR.
146 .Sp
147 Note \- this option does not enable \fB\-\-use\-dynamic\fR itself, so
148 if that option is not present on the command line then dynamic symbols
149 and dynamic relocs will not be displayed.
150 .IP \fB\-h\fR 4
151 .IX Item "-h"
152 .PD 0
153 .IP \fB\-\-file\-header\fR 4
154 .IX Item "--file-header"
155 .PD
156 Displays the information contained in the ELF header at the start of the
157 file.
158 .IP \fB\-l\fR 4
159 .IX Item "-l"
160 .PD 0
161 .IP \fB\-\-program\-headers\fR 4
162 .IX Item "--program-headers"
163 .IP \fB\-\-segments\fR 4
164 .IX Item "--segments"
165 .PD
166 Displays the information contained in the file's segment headers, if it
167 has any.
168 .IP \fB\-\-quiet\fR 4
169 .IX Item "--quiet"
170 Suppress "no symbols" diagnostic.
171 .IP \fB\-S\fR 4
172 .IX Item "-S"
173 .PD 0
174 .IP \fB\-\-sections\fR 4
175 .IX Item "--sections"
176 .IP \fB\-\-section\-headers\fR 4
177 .IX Item "--section-headers"
178 .PD
179 Displays the information contained in the file's section headers, if it
180 has any.
181 .IP \fB\-g\fR 4
182 .IX Item "-g"
183 .PD 0
184 .IP \fB\-\-section\-groups\fR 4
185 .IX Item "--section-groups"
186 .PD
187 Displays the information contained in the file's section groups, if it
188 has any.
189 .IP \fB\-t\fR 4
190 .IX Item "-t"
191 .PD 0
192 .IP \fB\-\-section\-details\fR 4
193 .IX Item "--section-details"
194 .PD
195 Displays the detailed section information. Implies \fB\-S\fR.
196 .IP \fB\-s\fR 4
197 .IX Item "-s"
198 .PD 0
199 .IP \fB\-\-symbols\fR 4
200 .IX Item "--symbols"
201 .IP \fB\-\-syms\fR 4
202 .IX Item "--syms"
203 .PD
204 Displays the entries in symbol table section of the file, if it has one.
205 If a symbol has version information associated with it then this is
206 displayed as well. The version string is displayed as a suffix to the
207 symbol name, preceded by an @ character. For example
208 \&\fBfoo@VER_1\fR. If the version is the default version to be used
209 when resolving unversioned references to the symbol then it is
210 displayed as a suffix preceded by two @ characters. For example
211 \&\fBfoo@@VER_2\fR.
212 .IP \fB\-\-dyn\-syms\fR 4
213 .IX Item "--dyn-syms"
214 Displays the entries in dynamic symbol table section of the file, if it
215 has one. The output format is the same as the format used by the
216 \&\fB\-\-syms\fR option.
217 .IP \fB\-\-lto\-syms\fR 4
218 .IX Item "--lto-syms"
219 Displays the contents of any LTO symbol tables in the file.
220 .IP \fB\-\-sym\-base=[0|8|10|16]\fR 4
221 .IX Item "--sym-base=[0|8|10|16]"
222 Forces the size field of the symbol table to use the given base. Any
223 unrecognized options will be treated as \fB0\fR. \fB\-\-sym\-base=0\fR
224 represents the default and legacy behaviour. This will output sizes as decimal
225 for numbers less than 100000. For sizes 100000 and greater hexadecimal notation
226 will be used with a 0x prefix.
227 \&\fB\-\-sym\-base=8\fR will give the symbol sizes in octal.
228 \&\fB\-\-sym\-base=10\fR will always give the symbol sizes in decimal.
229 \&\fB\-\-sym\-base=16\fR will always give the symbol sizes in hexadecimal with a
230 0x prefix.
231 .IP \fB\-C\fR 4
232 .IX Item "-C"
233 .PD 0
234 .IP \fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR 4
235 .IX Item "--demangle[=style]"
236 .PD
237 Decode (\fIdemangle\fR) low-level symbol names into user-level names.
238 This makes C++ function names readable. Different compilers have
239 different mangling styles. The optional demangling style argument can
240 be used to choose an appropriate demangling style for your
241 compiler.
242 .IP \fB\-\-no\-demangle\fR 4
243 .IX Item "--no-demangle"
244 Do not demangle low-level symbol names. This is the default.
245 .IP \fB\-\-recurse\-limit\fR 4
246 .IX Item "--recurse-limit"
247 .PD 0
248 .IP \fB\-\-no\-recurse\-limit\fR 4
249 .IX Item "--no-recurse-limit"
250 .IP \fB\-\-recursion\-limit\fR 4
251 .IX Item "--recursion-limit"
252 .IP \fB\-\-no\-recursion\-limit\fR 4
253 .IX Item "--no-recursion-limit"
254 .PD
255 Enables or disables a limit on the amount of recursion performed
256 whilst demangling strings. Since the name mangling formats allow for
257 an infinite level of recursion it is possible to create strings whose
258 decoding will exhaust the amount of stack space available on the host
259 machine, triggering a memory fault. The limit tries to prevent this
260 from happening by restricting recursion to 2048 levels of nesting.
261 .Sp
262 The default is for this limit to be enabled, but disabling it may be
263 necessary in order to demangle truly complicated names. Note however
264 that if the recursion limit is disabled then stack exhaustion is
265 possible and any bug reports about such an event will be rejected.
266 .IP "\fB\-U\fR \fI[d|i|l|e|x|h]\fR" 4
267 .IX Item "-U [d|i|l|e|x|h]"
268 .PD 0
269 .IP \fB\-\-unicode=[default|invalid|locale|escape|hex|highlight]\fR 4
270 .IX Item "--unicode=[default|invalid|locale|escape|hex|highlight]"
271 .PD
272 Controls the display of non-ASCII characters in identifier names.
273 The default (\fB\-\-unicode=locale\fR or \fB\-\-unicode=default\fR) is
274 to treat them as multibyte characters and display them in the current
275 locale. All other versions of this option treat the bytes as UTF\-8
276 encoded values and attempt to interpret them. If they cannot be
277 interpreted or if the \fB\-\-unicode=invalid\fR option is used then
278 they are displayed as a sequence of hex bytes, encloses in curly
279 parethesis characters.
280 .Sp
281 Using the \fB\-\-unicode=escape\fR option will display the characters
282 as as unicode escape sequences (\fI\euxxxx\fR). Using the
283 \&\fB\-\-unicode=hex\fR will display the characters as hex byte
284 sequences enclosed between angle brackets.
285 .Sp
286 Using the \fB\-\-unicode=highlight\fR will display the characters as
287 unicode escape sequences but it will also highlighted them in red,
288 assuming that colouring is supported by the output device. The
289 colouring is intended to draw attention to the presence of unicode
290 sequences when they might not be expected.
291 .IP \fB\-X\fR 4
292 .IX Item "-X"
293 .PD 0
294 .IP \fB\-\-extra\-sym\-info\fR 4
295 .IX Item "--extra-sym-info"
296 .PD
297 When displaying details of symbols, include extra information not
298 normally presented. Currently this just adds the name of the section
299 referenced by the symbol's index field, if there is one. In the
300 future more information may be displayed when this option is enabled.
301 .Sp
302 Enabling this option effectively enables the \fB\-\-wide\fR option as
303 well, at least when displaying symbol information.
304 .IP \fB\-\-no\-extra\-sym\-info\fR 4
305 .IX Item "--no-extra-sym-info"
306 Disables the effect of the \fB\-\-extra\-sym\-info\fR option. This
307 is the default.
308 .IP \fB\-e\fR 4
309 .IX Item "-e"
310 .PD 0
311 .IP \fB\-\-headers\fR 4
312 .IX Item "--headers"
313 .PD
314 Display all the headers in the file. Equivalent to \fB\-h \-l \-S\fR.
315 .IP \fB\-n\fR 4
316 .IX Item "-n"
317 .PD 0
318 .IP \fB\-\-notes\fR 4
319 .IX Item "--notes"
320 .PD
321 Displays the contents of the NOTE segments and/or sections, if any.
322 .IP \fB\-r\fR 4
323 .IX Item "-r"
324 .PD 0
325 .IP \fB\-\-relocs\fR 4
326 .IX Item "--relocs"
327 .PD
328 Displays the contents of the file's relocation section, if it has one.
329 .IP \fB\-u\fR 4
330 .IX Item "-u"
331 .PD 0
332 .IP \fB\-\-unwind\fR 4
333 .IX Item "--unwind"
334 .PD
335 Displays the contents of the file's unwind section, if it has one. Only
336 the unwind sections for IA64 ELF files, as well as ARM unwind tables
337 (\f(CW\*(C`.ARM.exidx\*(C'\fR / \f(CW\*(C`.ARM.extab\*(C'\fR) are currently supported. If
338 support is not yet implemented for your architecture you could try
339 dumping the contents of the \fI.eh_frames\fR section using the
340 \&\fB\-\-debug\-dump=frames\fR or \fB\-\-debug\-dump=frames\-interp\fR
341 options.
342 .IP \fB\-d\fR 4
343 .IX Item "-d"
344 .PD 0
345 .IP \fB\-\-dynamic\fR 4
346 .IX Item "--dynamic"
347 .PD
348 Displays the contents of the file's dynamic section, if it has one.
349 .IP \fB\-V\fR 4
350 .IX Item "-V"
351 .PD 0
352 .IP \fB\-\-version\-info\fR 4
353 .IX Item "--version-info"
354 .PD
355 Displays the contents of the version sections in the file, if they
356 exist.
357 .IP \fB\-A\fR 4
358 .IX Item "-A"
359 .PD 0
360 .IP \fB\-\-arch\-specific\fR 4
361 .IX Item "--arch-specific"
362 .PD
363 Displays architecture-specific information in the file, if there
364 is any.
365 .IP \fB\-D\fR 4
366 .IX Item "-D"
367 .PD 0
368 .IP \fB\-\-use\-dynamic\fR 4
369 .IX Item "--use-dynamic"
370 .PD
371 When displaying symbols, this option makes \fBreadelf\fR use the
372 symbol hash tables in the file's dynamic section, rather than the
373 symbol table sections.
374 .Sp
375 When displaying relocations, this option makes \fBreadelf\fR
376 display the dynamic relocations rather than the static relocations.
377 .IP \fB\-L\fR 4
378 .IX Item "-L"
379 .PD 0
380 .IP \fB\-\-lint\fR 4
381 .IX Item "--lint"
382 .IP \fB\-\-enable\-checks\fR 4
383 .IX Item "--enable-checks"
384 .PD
385 Displays warning messages about possible problems with the file(s)
386 being examined. If used on its own then all of the contents of the
387 file(s) will be examined. If used with one of the dumping options
388 then the warning messages will only be produced for the things being
389 displayed.
390 .IP "\fB\-x <number or name>\fR" 4
391 .IX Item "-x <number or name>"
392 .PD 0
393 .IP "\fB\-\-hex\-dump=<number or name>\fR" 4
394 .IX Item "--hex-dump=<number or name>"
395 .PD
396 Displays the contents of the indicated section as a hexadecimal bytes.
397 A number identifies a particular section by index in the section table;
398 any other string identifies all sections with that name in the object file.
399 This option can be repeated multiple times on the command line in
400 order to request multiple hex dumps.
401 .IP "\fB\-R <number or name>\fR" 4
402 .IX Item "-R <number or name>"
403 .PD 0
404 .IP "\fB\-\-relocated\-dump=<number or name>\fR" 4
405 .IX Item "--relocated-dump=<number or name>"
406 .PD
407 Displays the contents of the indicated section as a hexadecimal
408 bytes. A number identifies a particular section by index in the
409 section table; any other string identifies all sections with that name
410 in the object file. The contents of the section will be relocated
411 before they are displayed.
412 This option can be repeated multiple times on the command line in
413 order to request multiple relocated dumps.
414 .IP "\fB\-p <number or name>\fR" 4
415 .IX Item "-p <number or name>"
416 .PD 0
417 .IP "\fB\-\-string\-dump=<number or name>\fR" 4
418 .IX Item "--string-dump=<number or name>"
419 .PD
420 Displays the contents of the indicated section as printable strings.
421 A number identifies a particular section by index in the section table;
422 any other string identifies all sections with that name in the object file.
423 This option can be repeated multiple times on the command line in
424 order to request multiple string dumps.
425 .IP "\fB\-j <number or name>\fR" 4
426 .IX Item "-j <number or name>"
427 .PD 0
428 .IP \fB\-\-display\-section\fR 4
429 .IX Item "--display-section"
430 .PD
431 Displays the contents of the indicated section according to its
432 section header type. Sections containing relocations will be
433 displayed as if the \fB\-\-relocations\fR option had been used,
434 sections contains symbols will be displayed as if the \fB\-\-syms\fR
435 option had been used and so on.
436 .Sp
437 A number identifies a particular section by index in the section
438 table; any other string identifies all sections with that name in the
439 input file(s).
440 .Sp
441 This option can be repeated multiple times on the command line in
442 order to request multiple section dumps.
443 .IP \fB\-z\fR 4
444 .IX Item "-z"
445 .PD 0
446 .IP \fB\-\-decompress\fR 4
447 .IX Item "--decompress"
448 .PD
449 Requests that the section(s) being dumped by \fBx\fR, \fBR\fR or
450 \&\fBp\fR options are decompressed before being displayed. If the
451 section(s) are not compressed then they are displayed as is.
452 .IP \fB\-c\fR 4
453 .IX Item "-c"
454 .PD 0
455 .IP \fB\-\-archive\-index\fR 4
456 .IX Item "--archive-index"
457 .PD
458 Displays the file symbol index information contained in the header part
459 of binary archives. Performs the same function as the \fBt\fR
460 command to \fBar\fR, but without using the BFD library.
461 .IP \fB\-w[lLiaprmfFsOoRtUuTgAckK]\fR 4
462 .IX Item "-w[lLiaprmfFsOoRtUuTgAckK]"
463 .PD 0
464 .IP \fB\-\-debug\-dump[=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
465 .IX Item "--debug-dump[=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]"
466 .PD
467 Displays the contents of the DWARF debug sections in the file, if any
468 are present. Compressed debug sections are automatically decompressed
469 (temporarily) before they are displayed. If one or more of the
470 optional letters or words follows the switch then only those type(s)
471 of data will be dumped. The letters and words refer to the following
472 information:
473 .RS 4
474 .ie n .IP """a""" 4
475 .el .IP \f(CWa\fR 4
476 .IX Item "a"
477 .PD 0
478 .ie n .IP """=abbrev""" 4
479 .el .IP \f(CW=abbrev\fR 4
480 .IX Item "=abbrev"
481 .PD
482 Displays the contents of the \fB.debug_abbrev\fR section.
483 .ie n .IP """A""" 4
484 .el .IP \f(CWA\fR 4
485 .IX Item "A"
486 .PD 0
487 .ie n .IP """=addr""" 4
488 .el .IP \f(CW=addr\fR 4
489 .IX Item "=addr"
490 .PD
491 Displays the contents of the \fB.debug_addr\fR section.
492 .ie n .IP """c""" 4
493 .el .IP \f(CWc\fR 4
494 .IX Item "c"
495 .PD 0
496 .ie n .IP """=cu_index""" 4
497 .el .IP \f(CW=cu_index\fR 4
498 .IX Item "=cu_index"
499 .PD
500 Displays the contents of the \fB.debug_cu_index\fR and/or
501 \&\fB.debug_tu_index\fR sections.
502 .ie n .IP """f""" 4
503 .el .IP \f(CWf\fR 4
504 .IX Item "f"
505 .PD 0
506 .ie n .IP """=frames""" 4
507 .el .IP \f(CW=frames\fR 4
508 .IX Item "=frames"
509 .PD
510 Display the raw contents of a \fB.debug_frame\fR section.
511 .ie n .IP """F""" 4
512 .el .IP \f(CWF\fR 4
513 .IX Item "F"
514 .PD 0
515 .ie n .IP """=frames\-interp""" 4
516 .el .IP \f(CW=frames\-interp\fR 4
517 .IX Item "=frames-interp"
518 .PD
519 Display the interpreted contents of a \fB.debug_frame\fR section.
520 .ie n .IP """g""" 4
521 .el .IP \f(CWg\fR 4
522 .IX Item "g"
523 .PD 0
524 .ie n .IP """=gdb_index""" 4
525 .el .IP \f(CW=gdb_index\fR 4
526 .IX Item "=gdb_index"
527 .PD
528 Displays the contents of the \fB.gdb_index\fR and/or
529 \&\fB.debug_names\fR sections.
530 .ie n .IP """i""" 4
531 .el .IP \f(CWi\fR 4
532 .IX Item "i"
533 .PD 0
534 .ie n .IP """=info""" 4
535 .el .IP \f(CW=info\fR 4
536 .IX Item "=info"
537 .PD
538 Displays the contents of the \fB.debug_info\fR section. Note: the
539 output from this option can also be restricted by the use of the
540 \&\fB\-\-dwarf\-depth\fR and \fB\-\-dwarf\-start\fR options.
541 .ie n .IP """k""" 4
542 .el .IP \f(CWk\fR 4
543 .IX Item "k"
544 .PD 0
545 .ie n .IP """=links""" 4
546 .el .IP \f(CW=links\fR 4
547 .IX Item "=links"
548 .PD
549 Displays the contents of the \fB.gnu_debuglink\fR,
550 \&\fB.gnu_debugaltlink\fR and \fB.debug_sup\fR sections, if any of
551 them are present. Also displays any links to separate dwarf object
552 files (dwo), if they are specified by the DW_AT_GNU_dwo_name or
553 DW_AT_dwo_name attributes in the \fB.debug_info\fR section.
554 .ie n .IP """K""" 4
555 .el .IP \f(CWK\fR 4
556 .IX Item "K"
557 .PD 0
558 .ie n .IP """=follow\-links""" 4
559 .el .IP \f(CW=follow\-links\fR 4
560 .IX Item "=follow-links"
561 .PD
562 Display the contents of any selected debug sections that are found in
563 linked, separate debug info file(s). This can result in multiple
564 versions of the same debug section being displayed if it exists in
565 more than one file.
566 .Sp
567 In addition, when displaying DWARF attributes, if a form is found that
568 references the separate debug info file, then the referenced contents
569 will also be displayed.
570 .Sp
571 Note \- in some distributions this option is enabled by default. It
572 can be disabled via the \fBN\fR debug option. The default can be
573 chosen when configuring the binutils via the
574 \&\fB\-\-enable\-follow\-debug\-links=yes\fR or
575 \&\fB\-\-enable\-follow\-debug\-links=no\fR options. If these are not
576 used then the default is to enable the following of debug links.
577 .Sp
578 Note \- if support for the debuginfod protocol was enabled when the
579 binutils were built then this option will also include an attempt to
580 contact any debuginfod servers mentioned in the \fIDEBUGINFOD_URLS\fR
581 environment variable. This could take some time to resolve. This
582 behaviour can be disabled via the \fB=do\-not\-use\-debuginfod\fR debug
583 option.
584 .ie n .IP """N""" 4
585 .el .IP \f(CWN\fR 4
586 .IX Item "N"
587 .PD 0
588 .ie n .IP """=no\-follow\-links""" 4
589 .el .IP \f(CW=no\-follow\-links\fR 4
590 .IX Item "=no-follow-links"
591 .PD
592 Disables the following of links to separate debug info files.
593 .ie n .IP """D""" 4
594 .el .IP \f(CWD\fR 4
595 .IX Item "D"
596 .PD 0
597 .ie n .IP """=use\-debuginfod""" 4
598 .el .IP \f(CW=use\-debuginfod\fR 4
599 .IX Item "=use-debuginfod"
600 .PD
601 Enables contacting debuginfod servers if there is a need to follow
602 debug links. This is the default behaviour.
603 .ie n .IP """E""" 4
604 .el .IP \f(CWE\fR 4
605 .IX Item "E"
606 .PD 0
607 .ie n .IP """=do\-not\-use\-debuginfod""" 4
608 .el .IP \f(CW=do\-not\-use\-debuginfod\fR 4
609 .IX Item "=do-not-use-debuginfod"
610 .PD
611 Disables contacting debuginfod servers when there is a need to follow
612 debug links.
613 .ie n .IP """l""" 4
614 .el .IP \f(CWl\fR 4
615 .IX Item "l"
616 .PD 0
617 .ie n .IP """=rawline""" 4
618 .el .IP \f(CW=rawline\fR 4
619 .IX Item "=rawline"
620 .PD
621 Displays the contents of the \fB.debug_line\fR section in a raw
622 format.
623 .ie n .IP """L""" 4
624 .el .IP \f(CWL\fR 4
625 .IX Item "L"
626 .PD 0
627 .ie n .IP """=decodedline""" 4
628 .el .IP \f(CW=decodedline\fR 4
629 .IX Item "=decodedline"
630 .PD
631 Displays the interpreted contents of the \fB.debug_line\fR section.
632 .ie n .IP """m""" 4
633 .el .IP \f(CWm\fR 4
634 .IX Item "m"
635 .PD 0
636 .ie n .IP """=macro""" 4
637 .el .IP \f(CW=macro\fR 4
638 .IX Item "=macro"
639 .PD
640 Displays the contents of the \fB.debug_macro\fR and/or
641 \&\fB.debug_macinfo\fR sections.
642 .ie n .IP """o""" 4
643 .el .IP \f(CWo\fR 4
644 .IX Item "o"
645 .PD 0
646 .ie n .IP """=loc""" 4
647 .el .IP \f(CW=loc\fR 4
648 .IX Item "=loc"
649 .PD
650 Displays the contents of the \fB.debug_loc\fR and/or
651 \&\fB.debug_loclists\fR sections.
652 .ie n .IP """O""" 4
653 .el .IP \f(CWO\fR 4
654 .IX Item "O"
655 .PD 0
656 .ie n .IP """=str\-offsets""" 4
657 .el .IP \f(CW=str\-offsets\fR 4
658 .IX Item "=str-offsets"
659 .PD
660 Displays the contents of the \fB.debug_str_offsets\fR section.
661 .ie n .IP """p""" 4
662 .el .IP \f(CWp\fR 4
663 .IX Item "p"
664 .PD 0
665 .ie n .IP """=pubnames""" 4
666 .el .IP \f(CW=pubnames\fR 4
667 .IX Item "=pubnames"
668 .PD
669 Displays the contents of the \fB.debug_pubnames\fR and/or
670 \&\fB.debug_gnu_pubnames\fR sections.
671 .ie n .IP """r""" 4
672 .el .IP \f(CWr\fR 4
673 .IX Item "r"
674 .PD 0
675 .ie n .IP """=aranges""" 4
676 .el .IP \f(CW=aranges\fR 4
677 .IX Item "=aranges"
678 .PD
679 Displays the contents of the \fB.debug_aranges\fR section.
680 .ie n .IP """R""" 4
681 .el .IP \f(CWR\fR 4
682 .IX Item "R"
683 .PD 0
684 .ie n .IP """=Ranges""" 4
685 .el .IP \f(CW=Ranges\fR 4
686 .IX Item "=Ranges"
687 .PD
688 Displays the contents of the \fB.debug_ranges\fR and/or
689 \&\fB.debug_rnglists\fR sections.
690 .ie n .IP """s""" 4
691 .el .IP \f(CWs\fR 4
692 .IX Item "s"
693 .PD 0
694 .ie n .IP """=str""" 4
695 .el .IP \f(CW=str\fR 4
696 .IX Item "=str"
697 .PD
698 Displays the contents of the \fB.debug_str\fR, \fB.debug_line_str\fR
699 and/or \fB.debug_str_offsets\fR sections.
700 .ie n .IP """t""" 4
701 .el .IP \f(CWt\fR 4
702 .IX Item "t"
703 .PD 0
704 .ie n .IP """=pubtype""" 4
705 .el .IP \f(CW=pubtype\fR 4
706 .IX Item "=pubtype"
707 .PD
708 Displays the contents of the \fB.debug_pubtypes\fR and/or
709 \&\fB.debug_gnu_pubtypes\fR sections.
710 .ie n .IP """T""" 4
711 .el .IP \f(CWT\fR 4
712 .IX Item "T"
713 .PD 0
714 .ie n .IP """=trace_aranges""" 4
715 .el .IP \f(CW=trace_aranges\fR 4
716 .IX Item "=trace_aranges"
717 .PD
718 Displays the contents of the \fB.trace_aranges\fR section.
719 .ie n .IP """u""" 4
720 .el .IP \f(CWu\fR 4
721 .IX Item "u"
722 .PD 0
723 .ie n .IP """=trace_abbrev""" 4
724 .el .IP \f(CW=trace_abbrev\fR 4
725 .IX Item "=trace_abbrev"
726 .PD
727 Displays the contents of the \fB.trace_abbrev\fR section.
728 .ie n .IP """U""" 4
729 .el .IP \f(CWU\fR 4
730 .IX Item "U"
731 .PD 0
732 .ie n .IP """=trace_info""" 4
733 .el .IP \f(CW=trace_info\fR 4
734 .IX Item "=trace_info"
735 .PD
736 Displays the contents of the \fB.trace_info\fR section.
737 .RE
738 .RS 4
739 .Sp
740 Note: displaying the contents of \fB.debug_static_funcs\fR,
741 \&\fB.debug_static_vars\fR and \fBdebug_weaknames\fR sections is not
742 currently supported.
743 .RE
744 .IP \fB\-\-dwarf\-depth=\fR\fIn\fR 4
745 .IX Item "--dwarf-depth=n"
746 Limit the dump of the \f(CW\*(C`.debug_info\*(C'\fR section to \fIn\fR children.
747 This is only useful with \fB\-\-debug\-dump=info\fR. The default is
748 to print all DIEs; the special value 0 for \fIn\fR will also have this
749 effect.
750 .Sp
751 With a non-zero value for \fIn\fR, DIEs at or deeper than \fIn\fR
752 levels will not be printed. The range for \fIn\fR is zero-based.
753 .IP \fB\-\-dwarf\-start=\fR\fIn\fR 4
754 .IX Item "--dwarf-start=n"
755 Print only DIEs beginning with the DIE numbered \fIn\fR. This is only
756 useful with \fB\-\-debug\-dump=info\fR.
757 .Sp
758 If specified, this option will suppress printing of any header
759 information and all DIEs before the DIE numbered \fIn\fR. Only
760 siblings and children of the specified DIE will be printed.
761 .Sp
762 This can be used in conjunction with \fB\-\-dwarf\-depth\fR.
763 .IP \fB\-P\fR 4
764 .IX Item "-P"
765 .PD 0
766 .IP \fB\-\-process\-links\fR 4
767 .IX Item "--process-links"
768 .PD
769 Display the contents of non-debug sections found in separate debuginfo
770 files that are linked to the main file. This option automatically
771 implies the \fB\-wK\fR option, and only sections requested by other
772 command line options will be displayed.
773 .IP \fB\-\-ctf[=\fR\fIsection\fR\fB]\fR 4
774 .IX Item "--ctf[=section]"
775 Display the contents of the specified CTF section. CTF sections themselves
776 contain many subsections, all of which are displayed in order.
777 .Sp
778 By default, display the name of the section named \fI.ctf\fR, which is the
779 name emitted by \fBld\fR.
780 .IP \fB\-\-ctf\-parent=\fR\fImember\fR 4
781 .IX Item "--ctf-parent=member"
782 If the CTF section contains ambiguously-defined types, it will consist
783 of an archive of many CTF dictionaries, all inheriting from one
784 dictionary containing unambiguous types. This member is by default
785 named \fI.ctf\fR, like the section containing it, but it is possible to
786 change this name using the \f(CW\*(C`ctf_link_set_memb_name_changer\*(C'\fR
787 function at link time. When looking at CTF archives that have been
788 created by a linker that uses the name changer to rename the parent
789 archive member, \fB\-\-ctf\-parent\fR can be used to specify the name
790 used for the parent.
791 .IP \fB\-\-ctf\-parent\-section=\fR\fIsection\fR 4
792 .IX Item "--ctf-parent-section=section"
793 This option lets you pick a completely different section for the CTF
794 parent dictionary containing unambiguous types than for the child
795 dictionaries that contain the ambiguous remainder. The linker does
796 not emit ELF objects structured like this, but some third-party linkers
797 may. It's also convenient to inspect CTF written out as multiple raw
798 files to compose them with objcopy, which can put them in different
799 ELF sections but not in different members of a single CTF dict.
800 .IP \fB\-\-ctf\-symbols=\fR\fIsection\fR 4
801 .IX Item "--ctf-symbols=section"
802 .PD 0
803 .IP \fB\-\-ctf\-strings=\fR\fIsection\fR 4
804 .IX Item "--ctf-strings=section"
805 .PD
806 Specify the name of another section from which the CTF file can inherit
807 strings and symbols. By default, the \f(CW\*(C`.symtab\*(C'\fR and its linked
808 string table are used.
809 .Sp
810 If either of \fB\-\-ctf\-symbols\fR or \fB\-\-ctf\-strings\fR is specified, the
811 other must be specified as well.
812 .IP \fB\-\-got\-contents\fR 4
813 .IX Item "--got-contents"
814 Displays the contents of the file's Global Offset Table (GOT) sections,
815 if it has any. For MIPS, this option is similar to
816 \&\fB\-\-arch\-specific\fR, but it only displays the GOT related contents
817 and it is ignored when \fB\-\-arch\-specific\fR is used.
818 .IP \fB\-I\fR 4
819 .IX Item "-I"
820 .PD 0
821 .IP \fB\-\-histogram\fR 4
822 .IX Item "--histogram"
823 .PD
824 Display a histogram of bucket list lengths when displaying the contents
825 of the symbol tables.
826 .IP \fB\-v\fR 4
827 .IX Item "-v"
828 .PD 0
829 .IP \fB\-\-version\fR 4
830 .IX Item "--version"
831 .PD
832 Display the version number of readelf.
833 .IP \fB\-W\fR 4
834 .IX Item "-W"
835 .PD 0
836 .IP \fB\-\-wide\fR 4
837 .IX Item "--wide"
838 .PD
839 Don't break output lines to fit into 80 columns. By default
840 \&\fBreadelf\fR breaks section header and segment listing lines for
841 64\-bit ELF files, so that they fit into 80 columns. This option causes
842 \&\fBreadelf\fR to print each section header resp. each segment one a
843 single line, which is far more readable on terminals wider than 80 columns.
844 .IP \fB\-T\fR 4
845 .IX Item "-T"
846 .PD 0
847 .IP \fB\-\-silent\-truncation\fR 4
848 .IX Item "--silent-truncation"
849 .PD
850 Normally when readelf is displaying a symbol name, and it has to
851 truncate the name to fit into an 80 column display, it will add a
852 suffix of \f(CW\*(C`[...]\*(C'\fR to the name. This command line option
853 disables this behaviour, allowing 5 more characters of the name to be
854 displayed and restoring the old behaviour of readelf (prior to release
855 2.35).
856 .IP \fB\-H\fR 4
857 .IX Item "-H"
858 .PD 0
859 .IP \fB\-\-help\fR 4
860 .IX Item "--help"
861 .PD
862 Display the command-line options understood by \fBreadelf\fR.
863 .IP \fB@\fR\fIfile\fR 4
864 .IX Item "@file"
865 Read command-line options from \fIfile\fR. The options read are
866 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
867 does not exist, or cannot be read, then the option will be treated
868 literally, and not removed.
869 .Sp
870 Options in \fIfile\fR are separated by whitespace. A whitespace
871 character may be included in an option by surrounding the entire
872 option in either single or double quotes. Any character (including a
873 backslash) may be included by prefixing the character to be included
874 with a backslash. The \fIfile\fR may itself contain additional
875 @\fIfile\fR options; any such options will be processed recursively.
876 .SH "SEE ALSO"
877 .IX Header "SEE ALSO"
878 \&\fBobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
879 .SH COPYRIGHT
880 .IX Header "COPYRIGHT"
881 Copyright (c) 1991\-2026 Free Software Foundation, Inc.
882 .PP
883 Permission is granted to copy, distribute and/or modify this document
884 under the terms of the GNU Free Documentation License, Version 1.3
885 or any later version published by the Free Software Foundation;
886 with no Invariant Sections, with no Front-Cover Texts, and with no
887 Back-Cover Texts. A copy of the license is included in the
888 section entitled "GNU Free Documentation License".