LLVM-READELF(1)

💖 NAME 💖

llvm-readelf — bestie, it's the GNU-style LLVM Object Reader 🎀

Like, it reads object files and tells you everything about them. Obsessed.

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

okay so. llvm-readelf is the tool that spills ALL the tea about one or more object files — it shows you low-level, format-specific info. low-level as in deep in the bytes, bestie, not "kinda basic" 💅

And if input is -, it just reads straight from standard input like a little icon. Otherwise? It reads from the filenames you gave it. Simple as that. ✨

---

🌸 OPTIONS 🌸

• --all — literally the "give me everything" button. Equivalent to specifying all the main display options. ate. 👑
• --addrsig — shows the address-significance table.
• --arch-specific, -A — shows architecture-specific info, like the ARM attributes section on ARM. iykyk 🧚
• --color — colors in the output for warnings and errors. pretty and useful, no cap.
• --demangle, -C — shows demangled symbol names in the output, so your eyes don't suffer 😭
• --dyn-relocations — shows the dynamic relocation entries.
• --dyn-symbols, --dyn-syms — shows the dynamic symbol table.
• --dynamic-table, --dynamic, -d — shows the dynamic table.
• --cg-profile — shows the callgraph profile section.
• --elf-hash-histogram, --histogram, -I — shows a bucket list histogram for dynamic symbol hash tables.
• --elf-linker-options — shows the linker options section.
• --elf-output-style=<value> — formats ELF info in the style you pick. Valid options are LLVM and GNU. LLVM output is an expanded and structured format, whilst GNU (the default, bestie — that's the one you get if you say nothing) mimics the equivalent GNU readelf output.
• --elf-section-groups, --section-groups, -g — shows section groups.
• --expand-relocs — when you use it with --relocations, it shows each relocation in an expanded multi-line format. roomy. 🌈
• --file-headers, -h — shows file headers.
• --gnu-hash-table — shows the GNU hash table for dynamic symbols.
• --hash-symbols — shows the expanded hash table with dynamic symbol data.
• --hash-table — shows the hash table for dynamic symbols.
• --headers, -e — Equivalent to setting: --file-headers, --program-headers, and --sections. three-for-one deal, slay 💅
• --help — shows a summary of command line options.
• --help-list — shows an uncategorized summary of command line options.
• --hex-dump=<section[,section,...]>, -x — shows the specified section(s) as hexadecimal bytes. section may be a section index or section name. yes you can comma-separate them, go off 🍓
• --needed-libs — shows the needed libraries.
• --notes, -n — shows all notes.
• --program-headers, --segments, -l — shows the program headers.
• --raw-relr — do NOT decode relocations in RELR relocation sections when displaying them. it's giving raw, unprocessed, feral 💀
• --relocations, --relocs, -r — shows the relocation entries in the file.
• --sections, --section-headers, -S — shows all sections.
• --section-data — when you use it with --sections, it shows section data for each section shown. ⚠️ heads up bestie: this option has no effect for GNU style output.
• --section-details, -t — shows all section details. used as an alternative to --sections.
• --section-mapping — shows the section to segment mapping.
• --section-relocations — when you use it with --sections, it shows relocations for each section shown. ⚠️ again: this option has no effect for GNU style output.
• --section-symbols — when you use it with --sections, it shows symbols for each section shown. ⚠️ and once more: this option has no effect for GNU style output.
• --stackmap — shows contents of the stackmap section.
• --stack-sizes — shows 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 — shows the specified section(s) as a list of strings. section may be a section index or section name.
• --symbols, --syms, -s — shows the symbol table.
• --unwind, -u — shows unwind information.
• --version — shows the version of the llvm-readelf executable.
• --version-info, -V — shows version sections.
• @<FILE> — reads command-line options from response file <FILE>. cute little shortcut, we love her 🫶

---

🔥 EXIT STATUS 🔥

llvm-readelf returns 0 under normal operation. It returns a non-zero exit code if there were any errors. so if it's not 0, something went sideways, bestie 😭

---

🌈 SEE ALSO 🌈

llvm-nm(1), llvm-objdump(1), llvm-readobj(1)

the whole friend group fr fr 💜

---

👑 AUTHOR 👑

Maintained by the LLVM Team (https://llvm.org/). iconic behavior, no notes.

---

🎀 COPYRIGHT 🎀

2003-2024, LLVM Project

---

okay that's the whole page, bestie!! this was LLVM, dated 2024-07-18, page 12 energy only 💖 mwah, go read some object files ✨🦋🌸