docs/CommandGuide/llvm-readelf.rst

   1 llvm-readelf - GNU-style LLVM Object Reader
   2 ===========================================
   3
   4 .. program:: llvm-readelf
   5
   6 SYNOPSIS
   7 --------
   8
   9 :program:`llvm-readelf` [*options*] [*input...*]
  10
  11 DESCRIPTION
  12 -----------
  13
  14 The :program:`llvm-readelf` tool displays low-level format-specific information
  15 about one or more object files.
  16
  17 If ``input`` is "``-``" or omitted, :program:`llvm-readelf` reads from standard
  18 input. Otherwise, it will read from the specified ``filenames``.
  19
  20 OPTIONS
  21 -------
  22
  23 .. option:: --all
  24
  25  Equivalent to specifying all the main display options.
  26
  27 .. option:: --addrsig
  28
  29  Display the address-significance table.
  30
  31 .. option:: --arm-attributes
  32
  33  Display the ARM attributes section. Only applicable for ARM architectures.
  34
  35 .. option:: --color
  36
  37  Use colors in the output for warnings and errors.
  38
  39 .. option:: --demangle, -C
  40
  41  Display demangled symbol names in the output.
  42
  43 .. option:: --dyn-relocations
  44
  45  Display the dynamic relocation entries.
  46
  47 .. option:: --dyn-symbols, --dyn-syms
  48
  49  Display the dynamic symbol table.
  50
  51 .. option:: --dynamic-table, --dynamic, -d
  52
  53  Display the dynamic table.
  54
  55 .. option:: --elf-cg-profile
  56
  57  Display the callgraph profile section.
  58
  59 .. option:: --elf-hash-histogram, --histogram, -I
  60
  61  Display a bucket list histogram for dynamic symbol hash tables.
  62
  63 .. option:: --elf-linker-options
  64
  65  Display the linker options section.
  66
  67 .. option:: --elf-output-style=<value>
  68
  69  Format ELF information in the specified style. Valid options are ``LLVM`` and
  70  ``GNU``. ``LLVM`` output is an expanded and structured format, whilst ``GNU``
  71  (the default) output mimics the equivalent GNU :program:`readelf` output.
  72
  73 .. option:: --elf-section-groups, --section-groups, -g
  74
  75  Display section groups.
  76
  77 .. option:: --expand-relocs
  78
  79  When used with :option:`--relocations`, display each relocation in an expanded
  80  multi-line format.
  81
  82 .. option:: --file-headers, -h
  83
  84  Display file headers.
  85
  86 .. option:: --gnu-hash-table
  87
  88  Display the GNU hash table for dynamic symbols.
  89
  90 .. option:: --hash-symbols
  91
  92  Display the expanded hash table with dynamic symbol data.
  93
  94 .. option:: --hash-table
  95
  96  Display the hash table for dynamic symbols.
  97
  98 .. option:: --headers, -e
  99
 100  Equivalent to setting: :option:`--file-headers`, :option:`--program-headers`,
 101  and :option:`--sections`.
 102
 103 .. option:: --help
 104
 105  Display a summary of command line options.
 106
 107 .. option:: --help-list
 108
 109  Display an uncategorized summary of command line options.
 110
 111 .. option:: --hex-dump=<section[,section,...]>, -x
 112
 113  Display the specified section(s) as hexadecimal bytes. ``section`` may be a
 114  section index or section name.
 115
 116 .. option:: --needed-libs
 117
 118  Display the needed libraries.
 119
 120 .. option:: --notes, -n
 121
 122  Display all notes.
 123
 124 .. option:: --program-headers, --segments, -l
 125
 126  Display the program headers.
 127
 128 .. option:: --raw-relr
 129
 130  Do not decode relocations in RELR relocation sections when displaying them.
 131
 132 .. option:: --relocations, --relocs, -r
 133
 134  Display the relocation entries in the file.
 135
 136 .. option:: --sections, --section-headers, -S
 137
 138  Display all sections.
 139
 140 .. option:: --section-data
 141
 142  When used with :option:`--sections`, display section data for each section
 143  shown. This option has no effect for GNU style output.
 144
 145 .. option:: --section-mapping
 146
 147  Display the section to segment mapping.
 148
 149 .. option:: --section-relocations
 150
 151  When used with :option:`--sections`, display relocations for each section
 152  shown. This option has no effect for GNU style output.
 153
 154 .. option:: --section-symbols
 155
 156  When used with :option:`--sections`, display symbols for each section shown.
 157  This option has no effect for GNU style output.
 158
 159 .. option:: --stackmap
 160
 161  Display contents of the stackmap section.
 162
 163 .. option:: --stack-sizes
 164
 165  Display the contents of the stack sizes section(s), i.e. pairs of function
 166  names and the size of their stack frames. Currently only implemented for GNU
 167  style output.
 168
 169 .. option:: --string-dump=<section[,section,...]>, -p
 170
 171  Display the specified section(s) as a list of strings. ``section`` may be a
 172  section index or section name.
 173
 174 .. option:: --symbols, --syms, -s
 175
 176  Display the symbol table.
 177
 178 .. option:: --unwind, -u
 179
 180  Display unwind information.
 181
 182 .. option:: --version
 183
 184  Display the version of the :program:`llvm-readelf` executable.
 185
 186 .. option:: --version-info, -V
 187
 188  Display version sections.
 189
 190 .. option:: @<FILE>
 191
 192  Read command-line options from response file `<FILE>`.
 193
 194 EXIT STATUS
 195 -----------
 196
 197 :program:`llvm-readelf` returns 0 under normal operation. It returns a non-zero
 198 exit code if there were any errors.
 199
 200 SEE ALSO
 201 --------
 202
 203 :manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`, :manpage:`llvm-readobj(1)`