LLVM-READELF(1)

✨ LLVM-READELF(1) ✨

okay bestie, so this is llvm-readelf — it lives in the LLVM manual, section 1, and it's the GNU-style LLVM Object Reader. yes that's a whole mouthful but stay with me 💖

---

🎀 SYNOPSIS 🎀

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

---

🦋 DESCRIPTION 🦋

so like. the llvm-readelf tool spills all the low-level, format-specific tea about one or more object files. it literally just shows you what's inside them, no filter, no cap 👑

if input is - or you just… don't give it anything? it reads from standard input. otherwise it reads from the filenames you handed it. simple as that, fr fr ✨

---

💅 OPTIONS 💅

• --all — the "give me everything" button. equivalent to specifying all the main display options at once. iconic behaviour honestly.
• --addrsig — displays the address-significance table.
• --arch-specific, -A — displays architecture-specific info, like the ARM attributes section on ARM. lowkey niche but slay.
• --color — uses colors in the output for warnings and errors. pretty AND functional 🌈
• --demangle, -C — displays demangled symbol names in the output. so you can actually read them bestie.
• --dyn-relocations — displays the dynamic relocation entries.
• --dyn-symbols, --dyn-syms — displays the dynamic symbol table.
• --dynamic-table, --dynamic, -d — displays the dynamic table.
• --cg-profile — displays the callgraph profile section.
• --elf-hash-histogram, --histogram, -I — displays a bucket list histogram for dynamic symbol hash tables.
• --elf-linker-options — displays 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, remember that) mimics the equivalent GNU readelf output.
• --elf-section-groups, --section-groups, -g — displays section groups.
• --expand-relocs — when you use it with --relocations, it displays each relocation in an expanded multi-line format. roomy ✨
• --file-headers, -h — displays file headers.
• --gnu-hash-table — displays the GNU hash table for dynamic symbols.
• --hash-symbols — displays the expanded hash table with dynamic symbol data.
• --hash-table — displays the hash table for dynamic symbols.
• --headers, -e — equivalent to setting: --file-headers, --program-headers, and --sections. a lil combo meal 🍓
• --help — displays a summary of command line options.
• --help-list — displays an uncategorized summary of command line options. chaotic but valid.
• --hex-dump=<section[,section,...]>, -x — displays the specified section(s) as hexadecimal bytes. section may be a section index or section name.
• --needed-libs — displays the needed libraries.
• --notes, -n — displays all notes.
• --program-headers, --segments, -l — displays the program headers.
• --raw-relr — do not decode relocations in RELR relocation sections when displaying them. raw. unfiltered. 💀
• --relocations, --relocs, -r — displays the relocation entries in the file.
• --sections, --section-headers, -S — displays all sections.
• --section-data — when you use it with --sections, it displays section data for each section shown. heads up: this option has no effect for GNU style output 🙈
• --section-mapping — displays the section to segment mapping.
• --section-relocations — when used with --sections, it displays relocations for each section shown. again, no effect for GNU style output.
• --section-symbols — when used with --sections, it displays symbols for each section shown. and yes, no effect for GNU style output either.
• --stackmap — displays contents of the stackmap section.
• --stack-sizes — displays 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. we love a limited release 💜
• --string-dump=<section[,section,...]>, -p — displays the specified section(s) as a list of strings. section may be a section index or section name.
• --symbols, --syms, -s — displays the symbol table.
• --unwind, -u — displays unwind information.
• --version — displays the version of the llvm-readelf executable.
• --version-info, -V — displays version sections.
• @<FILE> — reads 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 like, if the number isn't zero, something went wrong bestie, pay attention 😭

---

🌸 SEE ALSO 🌸

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

---

🫶 AUTHOR 🫶

maintained by the LLVM Team (https://llvm.org/). they're the main characters, honestly.

---

💖 COPYRIGHT 💖

2003-2024, LLVM Project

---

okay that's the whole page, you ate it up 💅 this was the LLVM manual, version 11, dated 2024-07-18, and it's giving iconic reference material. go read some object files, bestie — periodt ✨🦋🎀