All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer
in this position and unchanged.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
$Id: readelf.1 3753 2019-06-28 01:13:13Z emaste $
.Dd October 31, 2020 .Dt READELF 1 .Os .Sh NAME .Nm readelf .Nd display information about ELF objects .Sh SYNOPSIS .Nm .Op Fl a | Fl -all .Op Fl c | Fl -archive-index .Op Fl d | Fl -dynamic .Op Fl e | Fl -headers .Op Fl g | Fl -section-groups .Op Fl h | Fl -file-header .Op Fl l | Fl -program-headers .Op Fl n | Fl -notes .Op Fl p Ar section | Fl -string-dump Ns = Ns Ar section .Op Fl r | Fl -relocs .Op Fl t | Fl -section-details .Op Fl v | Fl -version .Oo .Fl w Ns Oo Ns Ar afilmoprsFLR Ns Oc | .Fl -debug-dump Ns Op Ns = Ns Ar long-option-name , Ns ... .Oc .Op Fl x Ar section | Fl -hex-dump Ns = Ns Ar section .Op Fl z | Fl -decompress .Op Fl A | Fl -arch-specific .Op Fl D | Fl -use-dynamic .Op Fl H | Fl -help .Op Fl I | Fl -histogram .Op Fl N | -full-section-name .Op Fl S | Fl -sections | Fl -section-headers .Op Fl V | Fl -version-info .Op Fl W | Fl -wide .Ar file... .Sh DESCRIPTION The .Nm utility displays information about ELF objects and .Xr ar 1 archives.
p The .Nm utility recognizes the following options: l -tag -width indent t Fl a | Fl -all Turn on the following flags: .Fl d , .Fl h , .Fl I , .Fl l , .Fl r , .Fl s , .Fl A , .Fl S and .Fl V . t Fl c | Fl -archive-index Print the archive symbol table for archives. t Fl d | Fl -dynamic Print the contents of the .Li SHT_DYNAMIC sections in the ELF object. t Fl e | Fl -headers Print all program, file and section headers in the ELF object. t Fl g | Fl -section-groups Print the contents of the section groups in the ELF object. t Fl h | Fl -file-header Print the file header of the ELF object. t Fl l | Fl -program-headers Print the content of the program header table for the object. t Fl n | Fl -notes Print the contents of .Li PT_NOTE segments or .Li SHT_NOTE sections present in the ELF object. t Fl p Ar section | Fl -string-dump Ns = Ns Ar section Print the contents of the specified section as printable strings. The argument .Ar section should be the name of a section or a numeric section index. t Fl r | Fl -relocs Print relocation information. t Fl s | Fl -syms | Fl -symbols Print symbol tables. t Fl t | Fl -section-details Print additional information about sections, such as the flags fields in section headers. Implies .Fl S . t Fl v | Fl -version Prints a version identifier for .Nm and exits. t Fl w Ns Oo afilmoprsFLR Oc | Xo .Fl -debug-dump Ns Op Ns = Ns Ar long-option-name , Ns ... .Xc Display DWARF information. The .Fl w option is used with the short options in the following table; the .Fl -debug-dump option is used with a comma-separated list of the corresponding long option names: l -column ".Em Short Option" "aranges|ranges" t Em Short Option Ta Em Long Option Ta Em Description t a Ta abbrev Ta Show abbreviation information. t f Ta frames Ta Show frame information, displaying frame instructions. t i Ta info Ta Show debugging information entries. t l Ta rawline Ta Show line information in raw form. t m Ta macro Ta Show macro information. t o Ta loc Ta Show location list information. t p Ta pubnames Ta Show global names. t r Ta aranges|ranges Ta Show address range information. t s Ta str Ta Show the debug string table. t F Ta frames-interp Ta Show frame information, displaying register rules. t L Ta decodedline Ta Show line information in decoded form. t R Ta Ranges Ta Show range lists. .El
p If no sub-options are specified, the default is to show information corresponding to the .Ar a , f , i, l , o , p , r , s and .Ar R short options. t Fl x Ar section | Fl -hex-dump Ns = Ns Ar section Display the contents of the specified section in hexadecimal. The argument .Ar section should be the name of a section or a numeric section index. t Fl z | Fl -decompress Decompress contents of sections specified by .Fl x or .Fl p before displaying. If the specified section is not compressed, it is displayed as is. t Fl A | Fl -arch-specific This option is accepted but is currently unimplemented. t Fl D | Fl -use-dynamic Print the symbol table specified by the .Li DT_SYMTAB entry in the .Dq Li .dynamic section. t Fl H | Fl -help Print a help message. t Fl I | Fl -histogram Print information on bucket list lengths for sections of type .Li SHT_HASH and .Li SHT_GNU_HASH . t Fl N | Fl -full-section-name This option is accepted but is currently unimplemented. t Fl S | Fl -sections | Fl -section-headers Print information in the section headers for each ELF object. t Fl V | Fl -version-info Print symbol versioning information. t Fl W | Fl -wide Print information about ELF structures using one long line per structure. If this option is not specified, .Nm will list information in the headers of 64 bit ELF objects on two separate lines. .El .Sh EXIT STATUS .Ex -std .Sh SEE ALSO .Xr nm 1 , .Xr addr2line 1 , .Xr elfcopy 1 , .Sh AUTHORS The .Nm utility was written by .An Kai Wang Aq Mt kaiwang27@users.sourceforge.net .