1 .\" Copyright (c) 2009,2011 Joseph Koshy <jkoshy@users.sourceforge.net>
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer
9 .\" in this position and unchanged.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 .\" $Id: readelf.1 3486 2016-08-22 14:10:05Z emaste $
27 .Dd September 13, 2012
32 .Nd display information about ELF objects
36 .Op Fl c | Fl -archive-index
37 .Op Fl d | Fl -dynamic
38 .Op Fl e | Fl -headers
39 .Op Fl g | Fl -section-groups
40 .Op Fl h | Fl -file-header
41 .Op Fl l | Fl -program-headers
43 .Op Fl p Ar section | Fl -string-dump Ns = Ns Ar section
45 .Op Fl t | Fl -section-details
46 .Op Fl v | Fl -version
48 .Fl w Ns Oo Ns Ar afilmoprsFLR Ns Oc |
49 .Fl -debug-dump Ns Op Ns = Ns Ar long-option-name , Ns ...
51 .Op Fl x Ar section | Fl -hex-dump Ns = Ns Ar section
52 .Op Fl A | Fl -arch-specific
53 .Op Fl D | Fl -use-dynamic
55 .Op Fl I | Fl -histogram
56 .Op Fl N | -full-section-name
57 .Op Fl S | Fl -sections | Fl -section-headers
58 .Op Fl V | Fl -version-info
64 utility displays information about ELF objects and
70 utility recognizes the following options:
71 .Bl -tag -width indent
73 Turn on the following flags:
84 .It Fl c | Fl -archive-index
85 Print the archive symbol table for archives.
86 .It Fl d | Fl -dynamic
87 Print the contents of the
89 sections in the ELF object.
90 .It Fl e | Fl -headers
91 Print all program, file and section headers in the ELF object.
92 .It Fl g | Fl -section-groups
93 Print the contents of the section groups in the ELF object.
94 .It Fl h | Fl -file-header
95 Print the file header of the ELF object.
96 .It Fl l | Fl -program-headers
97 Print the content of the program header table for the object.
103 sections present in the ELF object.
104 .It Fl p Ar section | Fl -string-dump Ns = Ns Ar section
105 Print the contents of the specified section as printable strings.
108 should be the name of a section or a numeric section index.
109 .It Fl r | Fl -relocs
110 Print relocation information.
111 .It Fl s | Fl -syms | Fl -symbols
113 .It Fl t | Fl -section-details
114 Print additional information about sections, such as the flags
115 fields in section headers.
116 .It Fl v | Fl -version
117 Prints a version identifier for
120 .It Fl w Ns Oo afilmoprsFLR Oc | Xo
121 .Fl -debug-dump Ns Op Ns = Ns Ar long-option-name , Ns ...
123 Display DWARF information.
126 option is used with the short options in the following
129 option is used with a comma-separated list of the corresponding long
131 .Bl -column ".Em Short Option" "aranges|ranges"
132 .It Em Short Option Ta Em Long Option Ta Em Description
133 .It a Ta abbrev Ta Show abbreviation information.
134 .It f Ta frames Ta Show frame information, displaying frame instructions.
135 .It i Ta info Ta Show debugging information entries.
136 .It l Ta rawline Ta Show line information in raw form.
137 .It m Ta macro Ta Show macro information.
138 .It o Ta loc Ta Show location list information.
139 .It p Ta pubnames Ta Show global names.
140 .It r Ta aranges|ranges Ta Show address range information.
141 .It s Ta str Ta Show the debug string table.
142 .It F Ta frames-interp Ta Show frame information, displaying register rules.
143 .It L Ta decodedline Ta Show line information in decoded form.
144 .It R Ta Ranges Ta Show range lists.
147 If no sub-options are specified, the default is to show information
149 .Ar a , f , i, l , o , p , r , s
153 .It Fl x Ar section | Fl -hex-dump Ns = Ns Ar section
154 Display the contents of the specified section in hexadecimal.
157 should be the name of a section or a numeric section index.
158 .It Fl A | Fl -arch-specific
159 This option is accepted but is currently unimplemented.
160 .It Fl D | Fl -use-dynamic
161 Print the symbol table specified by the
167 Print a help message.
168 .It Fl I | Fl -histogram
169 Print information on bucket list lengths for sections of type
173 .It Fl N | Fl -full-section-name
174 This option is accepted but is currently unimplemented.
175 .It Fl S | Fl -sections | Fl -section-headers
176 Print information in the section headers for each ELF object.
177 .It Fl V | Fl -version-info
178 Print symbol versioning information.
180 Print information about ELF structures using one long line per
182 If this option is not specified,
184 will list information in the headers of 64 bit ELF objects on two
196 utility was written by
197 .An Kai Wang Aq Mt kaiwang27@users.sourceforge.net .