LLVM-READELF(1)

🌸 NAME 🌸

Okay so meet llvm-readelf, aka the GNU-style LLVM Object Reader — manual page LLVM-READELF(1), bestie, and yes she is that girl 💅✨

---

✨ SYNOPSIS ✨

llvm-readelf [options] [input...]

---

💖 DESCRIPTION 💖

llvm-readelf shows you low-level, format-specific info about one or more object files. It's giving x-ray vision for binaries 🔥

If input is -, llvm-readelf reads from standard input. Otherwise, it reads from the specified filenames. No cap, that's the whole entrance situation 🫶

---

🎀 OPTIONS 🎀

• --all, -a — equivalent to specifying all the main display options relevant to the file format. The "give me the whole vibe check" option 👑
• --addrsig — display the address-significance table.
• --arch-specific, -A — display architecture-specific information, e.g. the ARM attributes section on ARM.
• --bb-addr-map — display the contents of the basic block address map section(s), which contain the address of each function, along with the relative offset of each basic block.
• --decompress, -z — dump decompressed section content when used with -x or -p. If the section(s) are not compressed, they are displayed as is.
• --demangle, -C — display demangled symbol names in the output.
• --dependent-libraries — display the dependent libraries section.
• --dyn-relocations — display the dynamic relocation entries.
• --dyn-symbols, --dyn-syms — display the dynamic symbol table.
• --dynamic-table, --dynamic, -d — display the dynamic table.
• --cg-profile — display the callgraph profile section.
• --histogram, -I — display a bucket list histogram for dynamic symbol hash tables.
• --elf-linker-options — display the linker options section.
• --elf-output-style=<value> — format ELF information in the specified style. Valid options are LLVM, GNU, and JSON. LLVM output is an expanded and structured format. GNU — the default — output mimics the equivalent GNU readelf output. JSON is JSON formatted output intended for machine consumption.
• --extra-sym-info — display extra information (section name) when showing symbols.
• --section-groups, -g — display section groups.
• --expand-relocs — when used with --relocations, display each relocation in an expanded multi-line format.
• --file-header, -h — display file headers.
• --gnu-hash-table — display the GNU hash table for dynamic symbols.
• --hash-symbols — display the expanded hash table with dynamic symbol data.
• --hash-table — display the hash table for dynamic symbols.
• --headers, -e — equivalent to setting: --file-header, --program-headers, and --sections.
• --help — display a summary of command line options.
• --hex-dump=<section[,section,...]>, -x — display the specified section(s) as hexadecimal bytes. section may be a section index or section name.
• --memtag — display information about memory tagging present in the binary. This includes various memtag-specific dynamic entries, decoded global descriptor sections, and decoded Android-specific ELF notes.
• --needed-libs — display the needed libraries.
• --no-demangle — do not display demangled symbol names in the output. On by default.
• --notes, -n — display all notes.
• --pretty-print — when used with --elf-output-style, JSON output will be formatted in a more readable format.
• --program-headers, --segments, -l — display the program headers.
• --relocations, --relocs, -r — display the relocation entries in the file.
• --sections, --section-headers, -S — display all sections.
• --section-data — when used with --sections, display section data for each section shown. This option has no effect for GNU style output.
• --section-details, -t — display all section details. Used as an alternative to --sections.
• --section-mapping — display the section to segment mapping.
• --section-relocations — when used with --sections, display relocations for each section shown. This option has no effect for GNU style output.
• --section-symbols — when used with --sections, display symbols for each section shown. This option has no effect for GNU style output.
• --stackmap — display contents of the stackmap section.
• --stack-sizes — display the contents of the stack sizes section(s), i.e. pairs of function names and the size of their stack frames. Currently only implemented for GNU style output.
• --string-dump=<section[,section,...]>, -p — display the specified section(s) as a list of strings. section may be a section index or section name.
• --symbols, --syms, -s — display the symbol table. Also display the dynamic symbol table when using GNU output style for ELF.
• --unwind, -u — display unwind information.
• --version — display the version of the llvm-readelf executable.
• --version-info, -V — display version sections.
• --wide, -W — ignored for GNU readelf compatibility. The output is already similar to when using -W with GNU readelf.
• @<FILE> — read command-line options from response file <FILE>.

---

🦋 EXIT STATUS 🦋

llvm-readelf returns 0 under normal operation. It returns a non-zero exit code if there were any errors. So 0 is the slay outcome, non-zero means something went off 😭

---

🌈 SEE ALSO 🌈

Your next little reading list is iconic: llvm-nm(1), llvm-objdump(1), and llvm-readobj(1) 🫶✨

---

👑 AUTHOR 👑

Maintained by the LLVM Team — https://llvm.org/ 👑

---

🍓 COPYRIGHT 🍓

2003-2025, LLVM Project — periodt 💖

---

✨ Cute sign-off: this is page 19 of LLVM-READELF(1), source/version LLVM, dated 2025-01-17 — bye bestie, ily! 💅🎀