1EU-READELF(1)               General Commands Manual              EU-READELF(1)
2
3
4

NAME

6       eu-readelf - Displays information about ELF files.
7

SYNOPSIS

9       eu-readelf [-a|--all]
10               [-h|--file-header]
11               [-l|--program-headers|--segments]
12               [-S|--section-headers|--sections]
13               [-g|--section-groups]
14               [-e|--exception]
15               [--syms|-s|--symbols [section name] ]
16               [--dyn-syms]
17               [-n|--notes [section name] ]
18               [-r|--relocs]
19               [-d|--dynamic]
20               [-V|--version-info]
21               [-A|--arch-specific]
22               [-x <number or name>|--hex-dump=<number or name>]
23               [-p <number or name>|--string-dump=<number or name>]
24               [-z|--decompress]
25               [-c|--archive-index]
26               [--dwarf-skeleton <file> ]
27               [--elf-section [section] ]
28               [-w|
29                --debug-dump[=line,=decodedline,=info,=info+,=abbrev,=pubnames,=aranges,=macro,=frames,=str,=loc,=ranges,=gdb_index,=addr]]
30               [-I|--histogram]
31               [-v|--version]
32               [-W|--wide]
33               [-H|--help]
34               elffile...
35

DESCRIPTION

37       eu-readelf displays information about one or more ELF format object
38       files.  The options control what particular information to display.
39
40       elffile... are the object files to be examined.  32-bit and 64-bit ELF
41       files are supported, as are archives containing ELF files.
42
43       This program performs a similar function to objdump but it goes into
44       more detail and it exists independently of the BFD library, so if there
45       is a bug in BFD then readelf will not be affected.
46

OPTIONS

48       The long and short forms of options, shown here as alternatives, are
49       equivalent.  At least one option in addition to -v or -H must be given.
50
51   ELF Input Selection
52       --dwarf-skeleton <file>
53           Used with -w to find the skeleton Compile Units in FILE associated
54           with the Split Compile units in a .dwo input file.
55
56       --elf-section [section]
57           Use the named SECTION (default .gnu_debugdata) as (compressed) ELF
58           input data
59
60   ELF Output Selection
61       -a
62       --all
63           Equivalent to specifying --file-header, --program-headers,
64           --sections, --symbols, --relocs, --dynamic, --notes,
65           --version-info, --arch-specific, --section-groups and --histogram.
66
67
68       -h
69       --file-header
70           Displays the information contained in the ELF header at the start
71           of the file.
72
73       -l
74       --program-headers
75       --segments
76           Displays the information contained in the file's segment headers,
77           if it has any.
78
79       -S
80       --sections
81       --section-headers
82           Displays the information contained in the file's section headers,
83           if it has any.
84
85       -g
86       --section-groups
87           Displays the information contained in the file's section groups, if
88           it has any.
89
90       -I
91       --histogram
92           Display a histogram of bucket list lengths when displaying the
93           contents of the symbol tables.
94
95       -s
96       --syms
97       --symbols [section name]
98           Displays the entries in symbol table section of the file, if it has
99           one.  If a symbol has version information associated with it then
100           this is displayed as well.  The version string is displayed as a
101           suffix to the symbol name, preceded by an @ character.  For example
102           foo@VER_1.  If the version is the default version to be used when
103           resolving unversioned references to the symbol then it is displayed
104           as a suffix preceded by two @ characters.  For example foo@@VER_2.
105
106       --dyn-syms
107           Display (only) the dynamic symbol table.
108
109       -e
110       --exception
111           Display sections for exception handling.
112
113       -n
114       --notes [section name]
115           Displays the contents of the NOTE segments and/or sections, if any.
116
117       -r
118       --relocs
119           Displays the contents of the file's relocation section, if it has
120           one.
121
122       -d
123       --dynamic
124           Displays the contents of the file's dynamic section, if it has one.
125
126       -V
127       --version-info
128           Displays the contents of the version sections in the file, it they
129           exist.
130
131       -A
132       --arch-specific
133           Displays architecture-specific information in the file, if there is
134           any.
135
136   Additional output selection
137       -x <name>
138       --hex-dump=<name>
139           Displays the contents of the indicated section name as a
140           hexadecimal bytes.
141
142       -w
143       --debug-dump[=decodedline,=info,=info+,=abbrev,=pubnames,=aranges,=macro,=frames,=str,=loc,=ranges,=gdb_index,=addr]
144           Displays the contents of the DWARF debug sections in the file, if
145           any are present.  Compressed debug sections are automatically
146           decompressed (temporarily) before they are displayed.  If one or
147           more of the optional letters or words follows the switch then only
148           those type(s) of data will be dumped.  The letters and words refer
149           to the following information:
150           "=abbrev"
151               Displays the contents of the .debug_abbrev section.
152           "=addr"
153               Displays the contents of the .debug_addr section.
154           "=frames"
155               Display the raw contents of a .debug_frame section.
156           "=gdb_index"
157               Displays the contents of the .gdb_index and/or .debug_names
158               sections.
159           "=info"
160               Displays the contents of the .debug_info section.
161           "=info+"
162               Displays the contents of the .debug_info section, plus any
163               skeleton unit will be immediately followed by the corresponding
164               split compile unit (from the .dwo file).  To show the
165               difference between "regular" CUs and split CUs print offsets
166               and references between { and } instead of [ and ].
167           "=decodedline"
168               Displays the interpreted contents of the .debug_line section.
169           "=macro"
170               Displays the contents of the .debug_macro and/or .debug_macinfo
171               sections.
172           "=loc"
173               Displays the contents of the .debug_loc and/or .debug_loclists
174               sections.
175           "=pubnames"
176               Displays the contents of the .debug_pubnames and/or
177               .debug_gnu_pubnames sections.
178           "=aranges"
179               Displays the contents of the .debug_aranges section.
180           "=ranges"
181               Displays the contents of the .debug_ranges and/or
182               .debug_rnglists sections.
183           "=str"
184               Displays the contents of the .debug_str, .debug_line_str and/or
185               .debug_str_offsets sections.
186
187               Note: displaying the contents of .debug_static_funcs,
188               .debug_static_vars and debug_weaknames sections is not
189               currently supported.
190           -p <number or name>
191           --string-dump=<number or name>
192               Displays the contents of the indicated section as printable
193               strings.  A number identifies a particular section by index in
194               the section table; any other string identifies all sections
195               with that name in the object file.
196
197           -c
198           --archive-index
199               Displays the file symbol index information contained in the
200               header part of binary archives.  Performs the same function as
201               the t command to ar, but without using the BFD library.
202
203   Output control
204       -z
205       --decompress
206           Requests that the section(s) being dumped by x, R or p options are
207           decompressed before being displayed.  If the section(s) are not
208           compressed then they are displayed as is.
209
210       -v
211       --version
212           Display the version number of eu-readelf.
213
214       -W
215       --wide
216           Ignored for compatibility (lines always wide).
217
218       -H
219       --help
220           Display the command line options understood by eu-readelf.
221
222       @file
223           Read command-line options from file.  The options read are inserted
224           in place of the original @file option.  If file does not exist, or
225           cannot be read, then the option will be treated literally, and not
226           removed.
227
228           Options in file are separated by whitespace.  A whitespace
229           character may be included in an option by surrounding the entire
230           option in either single or double quotes.  Any character (including
231           a backslash) may be included by prefixing the character to be
232           included with a backslash.  The file may itself contain additional
233           @file options; any such options will be processed recursively.
234

SEE ALSO

236       objdump(1), readelf(1) and the Info entries for binutils.
237
239       Copyright (c) 1991-2018 Free Software Foundation, Inc.
240
241       Copyright (c) 2019 Red Hat Inc.
242
243       Permission is granted to copy, distribute and/or modify this document
244       under the terms of the GNU Free Documentation License, Version 1.3 or
245       any later version published by the Free Software Foundation; with no
246       Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
247       Texts.  A copy of the license is included in the section entitled "GNU
248       Free Documentation License".
249
250
251
252elfutils                          2019-Aug-20                    EU-READELF(1)
Impressum