1READELF(1) GNU Development Tools READELF(1)
2
6 readelf - Displays information about ELF files.
7
9 readelf [-a|--all]
10 [-h|--file-header]
11 [-l|--program-headers|--segments]
12 [-S|--section-headers|--sections]
13 [-g|--section-groups]
14 [-t|--section-details]
15 [-e|--headers]
16 [-s|--syms|--symbols]
17 [--dyn-syms]
18 [-n|--notes]
19 [-r|--relocs]
20 [-u|--unwind]
21 [-d|--dynamic]
22 [-V|--version-info]
23 [-A|--arch-specific]
24 [-D|--use-dynamic]
25 [-x <number or name>|--hex-dump=<number or name>]
26 [-p <number or name>|--string-dump=<number or name>]
27 [-R <number or name>|--relocated-dump=<number or name>]
28 [-c|--archive-index]
29 [-w[lLiaprmfFsoRt]|
30 --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]]
31 [--dwarf-depth=n]
32 [--dwarf-start=n]
33 [-I|--histogram]
34 [-v|--version]
35 [-W|--wide]
36 [-H|--help]
37 elffile...
38
40 readelf displays information about one or more ELF format object files.
41 The options control what particular information to display.
42 elffile... are the object files to be examined. 32-bit and 64-bit ELF
44 files are supported, as are archives containing ELF files.
45 This program performs a similar function to objdump but it goes into
47 more detail and it exists independently of the BFD library, so if there
48 is a bug in BFD then readelf will not be affected.
49
51 The long and short forms of options, shown here as alternatives, are
52 equivalent. At least one option besides -v or -H must be given.
53 -a
55 --all
56 Equivalent to specifying --file-header, --program-headers,
57 --sections, --symbols, --relocs, --dynamic, --notes and
58 --version-info.
59 -h
61 --file-header
62 Displays the information contained in the ELF header at the start
63 of the file.
64 -l
66 --program-headers
67 --segments
68 Displays the information contained in the file's segment headers,
69 if it has any.
70 -S
72 --sections
73 --section-headers
74 Displays the information contained in the file's section headers,
75 if it has any.
76 -g
78 --section-groups
79 Displays the information contained in the file's section groups, if
80 it has any.
81 -t
83 --section-details
84 Displays the detailed section information. Implies -S.
85 -s
87 --symbols
88 --syms
89 Displays the entries in symbol table section of the file, if it has
90 one.
91 --dyn-syms
93 Displays the entries in dynamic symbol table section of the file,
94 if it has one.
95 -e
97 --headers
98 Display all the headers in the file. Equivalent to -h -l -S.
99 -n
101 --notes
102 Displays the contents of the NOTE segments and/or sections, if any.
103 -r
105 --relocs
106 Displays the contents of the file's relocation section, if it has
107 one.
108 -u
110 --unwind
111 Displays the contents of the file's unwind section, if it has one.
112 Only the unwind sections for IA64 ELF files, as well as ARM unwind
113 tables (".ARM.exidx" / ".ARM.extab") are currently supported.
114 -d
116 --dynamic
117 Displays the contents of the file's dynamic section, if it has one.
118 -V
120 --version-info
121 Displays the contents of the version sections in the file, it they
122 exist.
123 -A
125 --arch-specific
126 Displays architecture-specific information in the file, if there is
127 any.
128 -D
130 --use-dynamic
131 When displaying symbols, this option makes readelf use the symbol
132 hash tables in the file's dynamic section, rather than the symbol
133 table sections.
134 -x <number or name>
136 --hex-dump=<number or name>
137 Displays the contents of the indicated section as a hexadecimal
138 bytes. A number identifies a particular section by index in the
139 section table; any other string identifies all sections with that
140 name in the object file.
141 -R <number or name>
143 --relocated-dump=<number or name>
144 Displays the contents of the indicated section as a hexadecimal
145 bytes. A number identifies a particular section by index in the
146 section table; any other string identifies all sections with that
147 name in the object file. The contents of the section will be
148 relocated before they are displayed.
149 -p <number or name>
151 --string-dump=<number or name>
152 Displays the contents of the indicated section as printable
153 strings. A number identifies a particular section by index in the
154 section table; any other string identifies all sections with that
155 name in the object file.
156 -c
158 --archive-index
159 Displays the file symbol index information contained in the header
160 part of binary archives. Performs the same function as the t
161 command to ar, but without using the BFD library.
162 -w[lLiaprmfFsoRt]
164 --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]
165 Displays the contents of the debug sections in the file, if any are
166 present. If one of the optional letters or words follows the
167 switch then only data found in those specific sections will be
168 dumped.
169 Note that there is no single letter option to display the content
171 of trace sections or .gdb_index.
172 Note: the =decodedline option will display the interpreted contents
174 of a .debug_line section whereas the =rawline option dumps the
175 contents in a raw format.
176 Note: the =frames-interp option will display the interpreted
178 contents of a .debug_frame section whereas the =frames option dumps
179 the contents in a raw format.
180 Note: the output from the =info option can also be affected by the
182 options --dwarf-depth and --dwarf-start.
183 --dwarf-depth=n
185 Limit the dump of the ".debug_info" section to n children. This is
186 only useful with --debug-dump=info. The default is to print all
187 DIEs; the special value 0 for n will also have this effect.
188 With a non-zero value for n, DIEs at or deeper than n levels will
190 not be printed. The range for n is zero-based.
191 --dwarf-start=n
193 Print only DIEs beginning with the DIE numbered n. This is only
194 useful with --debug-dump=info.
195 If specified, this option will suppress printing of any header
197 information and all DIEs before the DIE numbered n. Only siblings
198 and children of the specified DIE will be printed.
199 This can be used in conjunction with --dwarf-depth.
201 -I
203 --histogram
204 Display a histogram of bucket list lengths when displaying the
205 contents of the symbol tables.
206 -v
208 --version
209 Display the version number of readelf.
210 -W
212 --wide
213 Don't break output lines to fit into 80 columns. By default readelf
214 breaks section header and segment listing lines for 64-bit ELF
215 files, so that they fit into 80 columns. This option causes readelf
216 to print each section header resp. each segment one a single line,
217 which is far more readable on terminals wider than 80 columns.
218 -H
220 --help
221 Display the command line options understood by readelf.
222 @file
224 Read command-line options from file. The options read are inserted
225 in place of the original @file option. If file does not exist, or
226 cannot be read, then the option will be treated literally, and not
227 removed.
228 Options in file are separated by whitespace. A whitespace
230 character may be included in an option by surrounding the entire
231 option in either single or double quotes. Any character (including
232 a backslash) may be included by prefixing the character to be
233 included with a backslash. The file may itself contain additional
234 @file options; any such options will be processed recursively.
235
237 objdump(1), and the Info entries for binutils.
238
240 Copyright (c) 1991-2013 Free Software Foundation, Inc.
241 Permission is granted to copy, distribute and/or modify this document
243 under the terms of the GNU Free Documentation License, Version 1.3 or
244 any later version published by the Free Software Foundation; with no
245 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
246 Texts. A copy of the license is included in the section entitled "GNU
247 Free Documentation License".
248binutils-2.24 2020-01-29 READELF(1)