1READELF(1)                   GNU Development Tools                  READELF(1)
2
3
4

NAME

6       readelf - Displays information about ELF files.
7

SYNOPSIS

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

DESCRIPTION

40       readelf displays information about one or more ELF format object files.
41       The options control what particular information to display.
42
43       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
46       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

OPTIONS

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
54       -a
55       --all
56           Equivalent to specifying --file-header, --program-headers,
57           --sections, --symbols, --relocs, --dynamic, --notes and
58           --version-info.
59
60       -h
61       --file-header
62           Displays the information contained in the ELF header at the start
63           of the file.
64
65       -l
66       --program-headers
67       --segments
68           Displays the information contained in the file's segment headers,
69           if it has any.
70
71       -S
72       --sections
73       --section-headers
74           Displays the information contained in the file's section headers,
75           if it has any.
76
77       -g
78       --section-groups
79           Displays the information contained in the file's section groups, if
80           it has any.
81
82       -t
83       --section-details
84           Displays the detailed section information. Implies -S.
85
86       -s
87       --symbols
88       --syms
89           Displays the entries in symbol table section of the file, if it has
90           one.
91
92       --dyn-syms
93           Displays the entries in dynamic symbol table section of the file,
94           if it has one.
95
96       -e
97       --headers
98           Display all the headers in the file.  Equivalent to -h -l -S.
99
100       -n
101       --notes
102           Displays the contents of the NOTE segments and/or sections, if any.
103
104       -r
105       --relocs
106           Displays the contents of the file's relocation section, if it has
107           one.
108
109       -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
115       -d
116       --dynamic
117           Displays the contents of the file's dynamic section, if it has one.
118
119       -V
120       --version-info
121           Displays the contents of the version sections in the file, it they
122           exist.
123
124       -A
125       --arch-specific
126           Displays architecture-specific information in the file, if there is
127           any.
128
129       -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
135       -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
142       -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
150       -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
157       -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
163       -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
170           Note that there is no single letter option to display the content
171           of trace sections or .gdb_index.
172
173           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
177           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
181           Note: the output from the =info option can also be affected by the
182           options --dwarf-depth and --dwarf-start.
183
184       --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
189           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
192       --dwarf-start=n
193           Print only DIEs beginning with the DIE numbered n.  This is only
194           useful with --debug-dump=info.
195
196           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
200           This can be used in conjunction with --dwarf-depth.
201
202       -I
203       --histogram
204           Display a histogram of bucket list lengths when displaying the
205           contents of the symbol tables.
206
207       -v
208       --version
209           Display the version number of readelf.
210
211       -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
219       -H
220       --help
221           Display the command line options understood by readelf.
222
223       @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
229           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

SEE ALSO

237       objdump(1), and the Info entries for binutils.
238
240       Copyright (c) 1991-2013 Free Software Foundation, Inc.
241
242       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".
248
249
250
251binutils-2.24                     2019-02-02                        READELF(1)
Impressum