1EU-READELF(1) General Commands Manual EU-READELF(1)
2
3
4
6 eu-readelf - Displays information about ELF files.
7
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 [-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
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
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 --symbols [section name]
97 Displays the entries in symbol table section of the file, if it has
98 one. If a symbol has version information associated with it then
99 this is displayed as well. The version string is displayed as a
100 suffix to the symbol name, preceeded by an @ character. For
101 example foo@VER_1. If the version is the default version to be
102 used when resolving unversioned references to the symbol then it is
103 displayed as a suffix preceeded by two @ characters. For example
104 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
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)