239 lines · plain
1llvm-readelf - GNU-style LLVM Object Reader2===========================================3 4.. program:: llvm-readelf5 6SYNOPSIS7--------8 9:program:`llvm-readelf` [*options*] [*input...*]10 11DESCRIPTION12-----------13 14The :program:`llvm-readelf` tool displays low-level format-specific information15about one or more object files.16 17If ``input`` is "``-``", :program:`llvm-readelf` reads from standard18input. Otherwise, it will read from the specified ``filenames``.19 20OPTIONS21-------22 23.. option:: --all, -a24 25 Equivalent to specifying all the main display options relevant to the file26 format.27 28.. option:: --addrsig29 30 Display the address-significance table.31 32.. option:: --arch-specific, -A33 34 Display architecture-specific information, e.g. the ARM attributes section on ARM.35 36.. option:: --bb-addr-map37 38 Display the contents of the basic block address map section(s), which contain the39 address of each function, along with the relative offset of each basic block.40 41.. option:: --decompress, -z42 43 Dump decompressed section content when used with ``-x`` or ``-p``.44 If the section(s) are not compressed, they are displayed as is.45 46.. option:: --demangle, -C47 48 Display demangled symbol names in the output.49 50.. option:: --dependent-libraries51 52 Display the dependent libraries section.53 54.. option:: --dyn-relocations55 56 Display the dynamic relocation entries.57 58.. option:: --dyn-symbols, --dyn-syms59 60 Display the dynamic symbol table.61 62.. option:: --dynamic-table, --dynamic, -d63 64 Display the dynamic table.65 66.. option:: --cg-profile67 68 Display the callgraph profile section.69 70.. option:: --histogram, -I71 72 Display a bucket list histogram for dynamic symbol hash tables.73 74.. option:: --elf-linker-options75 76 Display the linker options section.77 78.. option:: --elf-output-style=<value>79 80 Format ELF information in the specified style. Valid options are ``LLVM``,81 ``GNU``, and ``JSON``. ``LLVM`` output is an expanded and structured format.82 ``GNU`` (the default) output mimics the equivalent GNU :program:`readelf`83 output. ``JSON`` is JSON formatted output intended for machine consumption.84 85.. option:: --extra-sym-info86 87 Display extra information (section name) when showing symbols.88 89.. option:: --section-groups, -g90 91 Display section groups.92 93.. option:: --expand-relocs94 95 When used with :option:`--relocations`, display each relocation in an expanded96 multi-line format.97 98.. option:: --file-header, -h99 100 Display file headers.101 102.. option:: --gnu-hash-table103 104 Display the GNU hash table for dynamic symbols.105 106.. option:: --hash-symbols107 108 Display the expanded hash table with dynamic symbol data.109 110.. option:: --hash-table111 112 Display the hash table for dynamic symbols.113 114.. option:: --headers, -e115 116 Equivalent to setting: :option:`--file-header`, :option:`--program-headers`,117 and :option:`--sections`.118 119.. option:: --help120 121 Display a summary of command line options.122 123.. option:: --hex-dump=<section[,section,...]>, -x124 125 Display the specified section(s) as hexadecimal bytes. ``section`` may be a126 section index or section name.127 128.. option:: --memtag129 130 Display information about memory tagging present in the binary. This includes131 various memtag-specific dynamic entries, decoded global descriptor sections,132 and decoded Android-specific ELF notes.133 134.. option:: --needed-libs135 136 Display the needed libraries.137 138.. option:: --no-demangle139 140 Do not display demangled symbol names in the output. On by default.141 142.. option:: --notes, -n143 144 Display all notes.145 146.. option:: --offloading147 148 Display list of HIP offload bundles.149 150.. option:: --pretty-print151 152 When used with :option:`--elf-output-style`, JSON output will be formatted in153 a more readable format.154 155.. option:: --program-headers, --segments, -l156 157 Display the program headers.158 159.. option:: --relocations, --relocs, -r160 161 Display the relocation entries in the file.162 163.. option:: --sections, --section-headers, -S164 165 Display all sections.166 167.. option:: --section-data168 169 When used with :option:`--sections`, display section data for each section170 shown. This option has no effect for GNU style output.171 172.. option:: --section-details, -t173 174 Display all section details. Used as an alternative to :option:`--sections`.175 176.. option:: --section-mapping177 178 Display the section to segment mapping.179 180.. option:: --section-relocations181 182 When used with :option:`--sections`, display relocations for each section183 shown. This option has no effect for GNU style output.184 185.. option:: --section-symbols186 187 When used with :option:`--sections`, display symbols for each section shown.188 This option has no effect for GNU style output.189 190.. option:: --stackmap191 192 Display contents of the stackmap section.193 194.. option:: --stack-sizes195 196 Display the contents of the stack sizes section(s), i.e. pairs of function197 names and the size of their stack frames. Currently only implemented for GNU198 style output.199 200.. option:: --string-dump=<section[,section,...]>, -p201 202 Display the specified section(s) as a list of strings. ``section`` may be a203 section index or section name.204 205.. option:: --symbols, --syms, -s206 207 Display the symbol table. Also display the dynamic symbol table when using GNU output style for ELF.208 209.. option:: --unwind, -u210 211 Display unwind information.212 213.. option:: --version214 215 Display the version of the :program:`llvm-readelf` executable.216 217.. option:: --version-info, -V218 219 Display version sections.220 221.. option:: --wide, -W222 223 Ignored for GNU readelf compatibility. The output is already similar to when using -W with GNU readelf.224 225.. option:: @<FILE>226 227 Read command-line options from response file `<FILE>`.228 229EXIT STATUS230-----------231 232:program:`llvm-readelf` returns 0 under normal operation. It returns a non-zero233exit code if there were any errors.234 235SEE ALSO236--------237 238:manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`, :manpage:`llvm-readobj(1)`239