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

DESCRIPTION

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

OPTIONS

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

SEE ALSO

155       objdump(1), and the Info entries for binutils.
156

COPYRIGHT

158       Copyright (c) 1991, 1992, 1993, 1994, 1995,  1996,  1997,  1998,  1999,
159       2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
160
161       Permission  is  granted to copy, distribute and/or modify this document
162       under the terms of the GNU Free Documentation License, Version  1.1  or
163       any  later  version  published by the Free Software Foundation; with no
164       Invariant Sections, with no Front-Cover Texts, and with  no  Back-Cover
165       Texts.  A copy of the license is included in the section entitled ``GNU
166       Free Documentation License''.
167
168
169
170binutils-2.15.97                  2005-04-20                        READELF(1)