LLVM-READELF(1)

📦
version 13.0.1 · 5 versions
, in ubuntu jammy

💅 llvm-readelf — GNU-style LLVM Object Reader ✨

okay bestie, so llvm-readelf is this iconic lil tool that shows you the lowkey deep-down format-specific tea about one or more object files. think of it like the ultimate vibe check for your binaries, no cap 🫶

🌸 SYNOPSIS 🌸

llvm-readelf [options] [input…]

💖 DESCRIPTION 💖

The llvm-readelf tool displays low-level format-specific information about one or more object files. literally giving you the whole backstory on what's inside those files 💅

If input is -, llvm-readelf reads from standard input. Otherwise, it will read from the specified filenames. so if you're piping stuff in, just throw a little dash and it knows what's up ✨

🎀 OPTIONS 🎀

  • --all — Equivalent to specifying all the main display options relevant to the file format. it's giving "I want EVERYTHING" energy 👑
  • --addrsig — Display the address-significance table. lowkey useful, highkey slay 🌟
  • --arch-specific, -A — Display architecture-specific information, e.g. the ARM attributes section on ARM. the way that ARM has its own special section... iconic fr fr 🦋
  • --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. so it's mapping out where all the basic blocks are, and honestly that's main character energy 💀
  • --demangle, -C — Display demangled symbol names in the output. because nobody wants to read mangled C++ names, periodt 💅
  • --dyn-relocations — Display the dynamic relocation entries. these are the relocations that actually matter at runtime, bestie 🔥
  • --dyn-symbols, --dyn-syms — Display the dynamic symbol table. the symbols that are actually exported, so you know what's visible to the outside world ✨
  • --dynamic-table, --dynamic, -d — Display the dynamic table. it's giving dynamic linking vibes 🎀
  • --cg-profile — Display the callgraph profile section. for when you want to see who's calling whom in your code, like the ultimate friendship network 👯‍♀️
  • --histogram, -I — Display a bucket list histogram for dynamic symbol hash tables. so it's showing you how the symbols are distributed across buckets, which is lowkey fascinating ngl 📊
  • --elf-linker-options — Display the linker options section. for when you need to see what the linker was told to do, no cap 🔗
  • --elf-output-style=<value> — Format ELF information in the specified style. Valid options are LLVM and GNU. LLVM output is an expanded and structured format, whilst GNU (the default) output mimics the equivalent GNU readelf output. so you can choose between the structured vibe or the classic GNU vibe — both are valid, both are iconic 💖
  • --section-groups, -g — Display section groups. grouping sections together because teamwork makes the dream work, periodt 🌈
  • --expand-relocs — When used with --relocations, display each relocation in an expanded multi-line format. so you get the full story instead of the TL;DR version 😌
  • --file-header, -h — Display file headers. the header is like the vibe check of the file, so this is essential bestie 🫶
  • --gnu-hash-table — Display the GNU hash table for dynamic symbols. the GNU hash table is iconic in its own right 💜
  • --hash-symbols — Display the expanded hash table with dynamic symbol data. so you get the hash table and the symbol data all in one, which is efficient and honestly slay ⭐
  • --hash-table — Display the hash table for dynamic symbols. just the hash table, no extras, keeping it simple fr fr 🌸
  • --headers, -e — Equivalent to setting: --file-header, --program-headers, and --sections. it's the combo deal, the all-in-one vibe, and we love that 🙈
  • --help — Display a summary of command line options. for when you forget what all these flags do (no judgement, there's a lot) 😭
  • --hex-dump=<section[,section,...]>, -x — Display the specified section(s) as hexadecimal bytes. section may be a section index or section name. so you can peek at the raw bytes of whatever section you're curious about, which is giving hacker energy 💀
  • --needed-libs — Display the needed libraries. so you know what libraries your binary depends on, like a friend group but for shared objects 👯‍♀️
  • --notes, -n — Display all notes. notes are those little extra bits of info, and they're lowkey important 🌟
  • --program-headers, --segments, -l — Display the program headers. these are the headers that tell the loader how to map the file into memory, so they're kinda a big deal 🔥
  • --raw-relr — Do not decode relocations in RELR relocation sections when displaying them. so you get the raw, undecoded version — use with caution, bestie 🚨
  • --relocations, --relocs, -r — Display the relocation entries in the file. relocations are how the linker fixes up addresses, so this is essential info ✨
  • --sections, --section-headers, -S — Display all sections. the sections are like the chapters of your binary's story, and this shows them all 📖
  • --section-data — When used with --sections, display section data for each section shown. This option has no effect for GNU style output. so it's LLVM style only, and it shows you the actual data in each section — highkey useful ngl 💖
  • --section-details, -t — Display all section details. Used as an alternative to --sections. so if you want the full tea on every section, this is your vibe 🎀
  • --section-mapping — Display the section to segment mapping. so you can see which sections belong to which segments, which is lowkey crucial for understanding memory layout 🗺️
  • --section-relocations — When used with --sections, display relocations for each section shown. This option has no effect for GNU style output. so again, LLVM style only, and it shows you the relocations section by section ✨
  • --section-symbols — When used with --sections, display symbols for each section shown. This option has no effect for GNU style output. so you get the symbols grouped by section, which is chef's kiss for debugging 👑
  • --stackmap — Display contents of the stackmap section. stackmaps are used by some compilers for garbage collection and other runtime stuff, so they're niche but important 💅
  • --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. so you get function names and their stack frame sizes, which is lowkey handy for optimization 🌸
  • --string-dump=<section[,section,...]>, -p — Display the specified section(s) as a list of strings. section may be a section index or section name. so if a section contains strings, this shows them all pretty-like 🎀
  • --symbols, --syms, -s — Display the symbol table. the symbol table is like the who's who of your binary, so this is essential 💖
  • --unwind, -u — Display unwind information. unwind info is how the program unwinds the stack during exceptions, so it's lowkey crucial for debugging 😌
  • --version — Display the version of the llvm-readelf executable. always good to know what version you're running, bestie ✨
  • --version-info, -V — Display version sections. version info is for symbol versioning, which is a whole vibe in itself 💜
  • @<FILE> — Read command-line options from response file <FILE>. so you can put all your options in a file and just reference it, which is efficient and honestly slay 🌟

💀 EXIT STATUS 💀

llvm-readelf returns 0 under normal operation. It returns a non-zero exit code if there were any errors. so if something went wrong, you'll know — no cap 🚨

🦋 SEE ALSO 🦋

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

👑 AUTHOR 👑

Maintained by the LLVM Team (https://llvm.org/). they're the ones keeping this whole thing running, and we stan 🫶

2003-2023, LLVM Project

okay bestie, that's the whole vibe of llvm-readelf — it's giving "I know everything about your object files" energy, and honestly? iconic. now go forth and read those ELFs, periodt 💅✨

version 13, dated 2023-07-14 — slay 💖

📦 where this page comes from