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               [-n--notes]
18               [-r--relocs]
19               [-u--unwind]
20               [-d--dynamic]
21               [-V--version-info]
22               [-A--arch-specific]
23               [-D--use-dynamic]
24               [-x <number or name>⎪--hex-dump=<number or name>]
25               [-w[liaprmfFsoR]
26                --debug-dump[=line,=info,=abbrev,=pub‐
27       names,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges]]
28               [-I-histogram]
29               [-v--version]
30               [-W--wide]
31               [-H--help]
32               elffile...
33

DESCRIPTION

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

OPTIONS

46       The long and short forms of options, shown here  as  alternatives,  are
47       equivalent.  At least one option besides -v or -H must be given.
48
49       -a
50       --all
51           Equivalent  to  specifying --file-header, --program-headers, --sec‐
52           tions, --symbols, --relocs, --dynamic, --notes and --version-info.
53
54       -h
55       --file-header
56           Displays the information contained in the ELF header at  the  start
57           of the file.
58
59       -l
60       --program-headers
61       --segments
62           Displays  the  information contained in the file's segment headers,
63           if it has any.
64
65       -S
66       --sections
67       --section-headers
68           Displays the information contained in the file's  section  headers,
69           if it has any.
70
71       -g
72       --section-groups
73           Displays the information contained in the file's section groups, if
74           it has any.
75
76       -t
77       --section-details
78           Displays the detailed section information. Implies -S.
79
80       -s
81       --symbols
82       --syms
83           Displays the entries in symbol table section of the file, if it has
84           one.
85
86       -e
87       --headers
88           Display all the headers in the file.  Equivalent to -h -l -S.
89
90       -n
91       --notes
92           Displays the contents of the NOTE segments and/or sections, if any.
93
94       -r
95       --relocs
96           Displays  the  contents of the file's relocation section, if it has
97           one.
98
99       -u
100       --unwind
101           Displays the contents of the file's unwind section, if it has  one.
102           Only  the  unwind  sections  for  IA64 ELF files are currently sup‐
103           ported.
104
105       -d
106       --dynamic
107           Displays the contents of the file's dynamic section, if it has one.
108
109       -V
110       --version-info
111           Displays the contents of the version sections in the file, it  they
112           exist.
113
114       -A
115       --arch-specific
116           Displays architecture-specific information in the file, if there is
117           any.
118
119       -D
120       --use-dynamic
121           When displaying symbols, this option makes readelf use  the  symbol
122           table  in  the  file's  dynamic section, rather than the one in the
123           symbols section.
124
125       -x <number or name>
126       --hex-dump=<number or name>
127           Displays the contents of the indicated  section  as  a  hexadecimal
128           dump.   A  number  identifies  a particular section by index in the
129           section table; any other string identifies all sections  with  that
130           name in the object file.
131
132       -w[liaprmfFsoR]
133       --debug-dump[=line,=info,=abbrev,=pub‐
134       names,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges]
135           Displays the contents of the debug sections in the file, if any are
136           present.   If  one  of  the  optional  letters or words follows the
137           switch then only data found in  those  specific  sections  will  be
138           dumped.
139
140       -I
141       --histogram
142           Display a histogram of bucket list lengths when displaying the con‐
143           tents of the symbol tables.
144
145       -v
146       --version
147           Display the version number of readelf.
148
149       -W
150       --wide
151           Don't break output lines to fit into 80 columns. By default readelf
152           breaks  section  header  and  segment  listing lines for 64-bit ELF
153           files, so that they fit into 80 columns. This option causes readelf
154           to  print each section header resp. each segment one a single line,
155           which is far more readable on terminals wider than 80 columns.
156
157       -H
158       --help
159           Display the command line options understood by readelf.
160
161       @file
162           Read command-line options from file.  The options read are inserted
163           in  place of the original @file option.  If file does not exist, or
164           cannot be read, then the option will be treated literally, and  not
165           removed.
166
167           Options  in file are separated by whitespace.  A whitespace charac‐
168           ter may be included in an option by surrounding the  entire  option
169           in  either  single  or  double  quotes.  Any character (including a
170           backslash) may  be  included  by  prefixing  the  character  to  be
171           included  with a backslash.  The file may itself contain additional
172           @file options; any such options will be processed recursively.
173

SEE ALSO

175       objdump(1), and the Info entries for binutils.
176
178       Copyright (c) 1991, 1992, 1993, 1994, 1995,  1996,  1997,  1998,  1999,
179       2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
180
181       Permission  is  granted to copy, distribute and/or modify this document
182       under the terms of the GNU Free Documentation License, Version  1.1  or
183       any  later  version  published by the Free Software Foundation; with no
184       Invariant Sections, with no Front-Cover Texts, and with  no  Back-Cover
185       Texts.   A copy of the license is included in the section entitled "GNU
186       Free Documentation License".
187
188
189
190binutils-2.17.50.0.12-4           2007-04-14                        READELF(1)
Impressum