readelf
READELF(F)            GNU Development Tools            READELF(F)



NAME
       readelf - Displays information about ELF files.

SYNOPSIS
       readelf [-a|--all]
               [-h|--file-header]
               [-l|--program-headers|--segments]
               [-S|--section-headers|--sections]
               [-e|--headers]
               [-s|--syms|--symbols]
               [-n|--notes]
               [-r|--relocs]
               [-u|--unwind]
               [-d|--dynamic]
               [-V|--version-info]
               [-D|--use-dynamic]
               [-x <number>|--hex-dump=<number>]
               [-w[liaprmfs]|--debug-dump[=line,=info,=abbrev,=pub-
       names,=ranges,=macro,=frames,=str]]
               [-histogram]
               [-v|--version]
               [-W|--wide]
               [-H|--help]
               elffile...

DESCRIPTION
       readelf displays information about one or more ELF  format
       object  files.  The options control what particular infor-
       mation to display.

       elffile... are the object files to be  examined.   At  the
       moment,  readelf  does not support examining archives, nor
       does it support examing 64 bit ELF files.

OPTIONS
       The long and short forms of options, shown here as  alter-
       natives,  are  equivalent.  At least one option besides -v
       or -H must be given.

       -a
       --all
           Equivalent  to   specifiying   --file-header,   --pro-
           gram-headers,    --sections,    --symbols,   --relocs,
           --dynamic, --notes and --version-info.

       -h
       --file-header
           Displays the information contained in the  ELF  header
           at the start of the file.

       -l
       --program-headers
       --segments
           Displays  the information contained in the file's seg-
           ment headers, if it has any.

       -S
       --sections
       --section-headers
           Displays the information contained in the file's  sec-
           tion headers, if it has any.

       -s
       --symbols
       --syms
           Displays  the  entries  in symbol table section of the
           file, if it has one.

       -e
       --headers
           Display all the headers in the file.  Equivalent to -h
           -l -S.

       -n
       --notes
           Displays  the  contents  of  the  NOTE  segment, if it
           exists.

       -r
       --relocs
           Displays the contents of the  file's  relocation  sec-
           tion, if it has one.

       -u
       --unwind
           Displays the contents of the file's unwind section, if
           it has one.  Only the unwind  sections  for  IA64  ELF
           files are currently supported.

       -d
       --dynamic
           Displays  the  contents of the file's dynamic section,
           if it has one.

       -V
       --version-info
           Displays the contents of the version sections  in  the
           file, it they exist.

       -D
       --use-dynamic
           When displaying symbols, this option makes readelf use
           the symbol table in the file's dynamic section, rather
           than the one in the symbols section.

       -x <number>
       --hex-dump=<number>
           Displays  the  contents  of the indicated section as a
           hexadecimal dump.

       -w[liaprmfs]
       --debug-dump[=line,=info,=abbrev,=pub-
       names,=ranges,=macro,=frames,=str]
           Displays the contents of the  debug  sections  in  the
           file, if any are present.  If one of the optional let-
           ters or words follows the switch then only data  found
           in those specific sections will be dumped.

       --histogram
           Display  a  histogram of bucket list lengths when dis-
           playing the contents of the symbol tables.

       -v
       --version
           Display the version number of readelf.

       -W
       --wide
           Don't break output lines to fit into  80  columns.  By
           default  readelf  breaks  section  header  and segment
           listing lines for 64-bit ELF files, so that  they  fit
           into  80  columns. This option causes readelf to print
           each section header resp. each segment  one  a  single
           line,  which  is  far more readable on terminals wider
           than 80 columns.

       -H
       --help
           Display the command line options understood  by  read-
           elf.

SEE ALSO
       objdump(p), and the Info entries for binutils.

COPYRIGHT
       Copyright  (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
       2001, 2002 Free Software Foundation, Inc.

       Permission is granted to copy,  distribute  and/or  modify
       this  document  under the terms of the GNU Free Documenta-
       tion License, Version 1.1 or any later  version  published
       by  the  Free  Software Foundation; with no Invariant Sec-
       tions, with no Front-Cover Texts, and with  no  Back-Cover
       Texts.   A  copy of the license is included in the section
       entitled "GNU Free Documentation License".



binutils-2.12.90.0.15       2002-08-14                 READELF(F)