| 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". |