LLVM-OBJDUMP(1)

📦
version 22.1.8 · 6 versions
, in fedora 44

💖 LLVM-OBJDUMP(1) — LLVM's object file dumper ✨

okay bestie, welcome to the LLVM manual, section 1, and today's main character is llvm-objdump 🎀 she's the girl who opens up your object files and final linked images and tells you everything that's inside. no secrets. no cap. 💅

🌸 NAME 🌸

llvm-objdump — LLVM's object file dumper 🦋

✨ SYNOPSIS ✨

llvm-objdump [commands] [options] [filenames...]

💜 DESCRIPTION 💜

So basically, llvm-objdump prints the contents of the object files and final linked images you name on the command line. literally just hands you the tea ☕

No file name given? She'll try to read from a.out — like, default behaviour, we love a fallback. 🙈

And if you use - as a file name, she'll process a file on her standard input stream. icon behaviour, honestly. 💅

👑 COMMANDS 👑

At least one of these commands is required, and some commands can be stacked with other commands. mix and match, it's giving build-your-own-adventure 🌈

  • -a, --archive-headers — Display the information contained within an archive's headers. 📦
  • -d, --disassemble — Disassemble all executable sections found in the input files. On some architectures (AArch64, PowerPC, x86), all known instructions are disassembled by default. On the others, --mcpu or --mattr is needed to enable some instruction sets. Disabled instructions are displayed as <unknown>. 😭
  • -D, --disassemble-all — Disassemble all sections found in the input files. all of them. every single one. 💀
  • --disassemble-symbols=<symbol1[,symbol2,...]> — Disassemble only the specified symbols. Takes demangled symbol names when --demangle is specified, otherwise takes mangled symbol names. Implies --disassemble. 🎯
  • --dwarf=<value> — Dump the specified DWARF debug sections. The supported values are:
    • frames — .debug_frame
  • -f, --file-headers — Display the contents of the overall file header. 🗂️
  • --fault-map-section — Display the content of the fault map section. ⚠️
  • -h, --headers, --section-headers — Display summaries of the headers for each section. 📋
  • --help — Display usage information and exit. Does not stack with other commands. 🚪
  • -p, --private-headers — Display format-specific file headers. 🤫
  • -r, --reloc — Display the relocation entries in the file. 🚚
  • -R, --dynamic-reloc — Display the dynamic relocation entries in the file. 🌀
  • --raw-clang-ast — Dump the raw binary contents of the clang AST section. 🌳
  • -s, --full-contents — Display the contents of each section. 📖
  • -t, --syms — Display the symbol table. 🔤
  • -T, --dynamic-syms — Display the contents of the dynamic symbol table. 🔡
  • -u, --unwind-info — Display the unwind info of the input(s).
    • This operation is only currently supported for COFF and Mach-O object files. 🫶
  • -v, --version — Display the version of the llvm-objdump executable. Does not stack with other commands. 🏷️
  • -x, --all-headers — Display all available header information. Equivalent to specifying --archive-headers, --file-headers, --private-headers, --reloc, --section-headers, and --syms. the whole buffet, no notes 🍓

🎀 OPTIONS 🎀

llvm-objdump supports the following options:

  • --adjust-vma=<offset> — Increase the displayed address in disassembly or section header printing by the specified offset. 📏
  • --arch-name=<string> — Specify the target architecture when disassembling. Use --version for a list of available targets. 🏗️
  • --build-id=<string> — Look up the object using the given build ID, specified as a hexadecimal string. The found object is handled as if it were an input filename. 🔍
  • -C, --demangle — Demangle symbol names in the output. un-mangle-ify that girl ✨
  • --debug-file-directory <path> — Provide a path to a directory with a .build-id subdirectory to search for debug information for stripped binaries. Multiple instances of this argument are searched in the order given. 🗺️
  • --debug-indent=<width> — Distance to indent the source-level variable or inlined function display, relative to the start of the disassembly. Defaults to 52 characters. 📐
  • --debug-inlined-funcs[=<format>] — Print the locations of inlined functions alongside disassembly. format may be ascii, limits-only, or unicode, defaulting to unicode if omitted. 💫
  • --debug-vars[=<format>] — Print the locations (in registers or memory) of source-level variables alongside disassembly. format may be ascii or unicode, defaulting to unicode if omitted. 🔎
  • --debuginfod, --no-debuginfod — Whether or not to try debuginfod lookups for debug binaries. Unless specified, debuginfod is only enabled if libcurl was compiled in (LLVM_ENABLE_CURL) and at least one server URL was provided by the environment variable DEBUGINFOD_URLS. 🌐
  • -j, --section=<section1[,section2,...]> — Perform commands on the specified sections only. For Mach-O use segment,section to specify the section name. ✂️
  • -l, --line-numbers — When disassembling, display source line numbers. Implies --disassemble. 🔢
  • -M, --disassembler-options=<opt1[,opt2,...]> — Pass target-specific disassembler options. Available options:
    • reg-names-std: ARM only (default). Print in ARM 's instruction set documentation, with r13/r14/r15 replaced by sp/lr/pc.
    • reg-names-raw: ARM only. Use r followed by the register number.
    • no-aliases: AArch64 and RISC-V only. Print raw instruction mnemonic instead of pseudo instruction mnemonic.
    • numeric: RISC-V only. Print raw register names instead of ABI mnemonic. (e.g. print x1 instead of ra)
    • att: x86 only (default). Print in the AT&T syntax.
    • intel: x86 only. Print in the intel syntax.
  • --disassembler-color=<mode> — Enable or disable disassembler color output. 🌈
    • off: Disable disassembler color output.
    • on: Enable disassembler color output.
    • terminal: Enable disassembler color output if the terminal supports it (default).
  • --mcpu=<cpu-name> — Target a specific CPU type for disassembly. Specify --mcpu=help to display available CPUs. 🧠
  • --mattr=<a1,+a2,-a3,...> — Enable/disable target-specific attributes. Specify --mattr=help to display the available attributes. 🎛️
  • -mllvm <arg> — Specify an argument to forward to LLVM's CommandLine library. 📨
  • --no-leading-addr, --no-addresses — When disassembling, do not print leading addresses for instructions or inline relocations. 🚫
  • --no-print-imm-hex — Do not use hex format for immediate values in disassembly output. 🙅
  • --no-show-raw-insn — When disassembling, do not print the raw bytes of each instruction. 🧼
  • --offloading — Display the content of the LLVM offloading sections and HIP offload bundles. 🚀
  • --prefix=<prefix> — When disassembling with the --source option, prepend prefix to absolute paths. 🧩
  • --prefix-strip=<level> — When disassembling with the --source option, strip out level initial directories from absolute paths. This option has no effect without --prefix. ✂️
  • --print-imm-hex — Use hex format when printing immediate values in disassembly output (default). 🔢
  • -S, --source — When disassembling, display source interleaved with the disassembly. Implies --disassemble. 📜
  • --show-all-symbols — Show all symbols during disassembly, even if multiple symbols are defined at the same location. 👯
  • --show-lma — Display the LMA column when dumping ELF section headers. Defaults to off unless any section has different VMA and LMAs. 📊
  • --start-address=<address> — When disassembling, only disassemble from the specified address.
    • When printing relocations, only print the relocations patching offsets from at least address.
    • When printing symbols, only print symbols with a value of at least address. 🚦
  • --stop-address=<address> — When disassembling, only disassemble up to, but not including the specified address.
    • When printing relocations, only print the relocations patching offsets up to address.
    • When printing symbols, only print symbols with a value up to address. 🛑
  • --symbolize-operands — When disassembling, symbolize a branch target operand to print a label instead of a real address.
    • When printing a PC-relative global symbol reference, print it as an offset from the leading symbol.
    • When a bb-address-map section is present (i.e., the object file is built with -fbasic-block-address-map), labels are retrieved from that section instead. If a pgo-analysis-map is present alongside the bb-address-map, any available analyses are printed after the relevant block label. By default, any analysis with a special representation (i.e. BlockFrequency, BranchProbability, etc) are printed as raw hex values.
    • Only supported for AArch64, BPF, PowerPC, and X86. 🎯

Example:

A non-symbolized branch instruction with a local target and pc-relative memory access like

cmp eax, dword ptr [rip + 4112]
jge 0x20117e <_start+0x25>

might become

<L0>:
  cmp eax, dword ptr <g>
  jge      <L0>
  • --pretty-pgo-analysis-map — When using --symbolize-operands with bb-address-map and pgo-analysis-map, print analyses using the same format as their analysis passes would. An example of pretty format would be printing block frequencies relative to the entry block, the same as BFI. 💅
    • Only works when --symbolize-operands is enabled. 🫶
  • --triple=<string> — Target triple to disassemble for, see --version for available targets. 🎯
  • -w, --wide — Ignored for compatibility with GNU objdump. 🫥 (yes she's just standing there, minding her business)
  • --x86-asm-syntax=<style> — Deprecated. When used with --disassemble, choose style of code to emit from X86 backend. Supported values are:
    • att — AT&T-style assembly
    • intel — Intel-style assembly

The default disassembly style is att. 🎨

  • -z, --disassemble-zeroes — Do not skip blocks of zeroes when disassembling. 0️⃣
  • @<FILE> — Read command-line options and commands from response file <FILE>. 📥
bestie we are not done yet — this page keeps going, and so do we 💖

🍎 MACH-O ONLY OPTIONS AND COMMANDS 🍎

Okay bestie, this whole lil' section is Apple-coded 💅 — everything here is for Mach-O files, iykyk. Same rules tho: exact flags, exact behaviour, no made-up lore.

  • --arch=<architecture> — tells it which architecture to disassemble. Wanna know what architectures you've even got to pick from? Go peek at --version, it'll spill. ✨
  • --archive-member-offsets — prints the offset to each archive member for Mach-O archives. Heads up tho: this one requires --archive-headers to come along for the ride. 🎀
  • --bind — shows you the binding info.
  • --data-in-code — displays the data in code table.
  • --dis-symname=<name> — disassembles just the instructions of the symbol you name. Only that one. Main character behaviour, honestly. 👑
  • --chained-fixups — prints chained fixup information.
  • --dyld-info — prints the bind and rebase info that dyld uses to resolve external references in a final linked binary. 🦋
  • --dylibs-used — displays the shared libraries used for linked files.
  • --dsym=<string> — use a .dSYM file for debug info.
  • --dylib-id — displays the shared library's ID for dylib files.
  • --exports-trie — displays exported symbols.
  • --function-starts [=<addrs|names|both>] — prints the function starts table for Mach-O objects. You can pick: addrs (that's the default) to print just the addresses of the functions, names to print just the names of the functions (when available), or both to print the names right next to the addresses. Pick your fighter. 🌸
  • -g — prints line information from debug info, if it's available.
  • --full-leading-addr — prints the full leading address when disassembling. No truncation, no crumbs, full meal. 🍓
  • --indirect-symbols — displays the indirect symbol table.
  • --info-plist — displays the info plist section as strings.
  • --lazy-bind — displays lazy binding info.
  • --link-opt-hints — displays the linker optimization hints.
  • -m, --macho — use the Mach-O specific object file parser. Real talk: commands and other options may behave differently when you use them with --macho. So don't be shocked, it's giving different on purpose. 💀
  • --no-leading-headers — don't print any leading headers.
  • --no-symbolic-operands — don't print symbolic operands when disassembling.
  • --non-verbose — displays the info for Mach-O objects in non-verbose (aka numeric) form.
  • --objc-meta-data — displays the Objective-C runtime meta data.
  • --private-header — displays only the first format specific file header.
  • --rebase — displays rebasing information.
  • --rpaths — displays the runtime search paths for the binary.
  • --universal-headers — displays universal headers.
  • --weak-bind — displays weak binding information.

🌈 XCOFF ONLY OPTIONS AND COMMANDS 🌈

And now for the IBM-flavoured corner of the function, bestie — XCOFF only, no crossover episodes. 🧚

  • --symbol-description — adds symbol description to the disassembly output.
  • --traceback-table — decodes the traceback table in the disassembly output. And yes, it implies --disassemble, so it'll pull that in for you automatically. Convenient, iconic, no notes. ✨

🐛 BUGS 🐛

Found a bug? First of all, thank you for your service 🫶. Please go report it over at <<https://github.com/llvm/llvm-project/labels/tools:llvm-objdump/>>.

👀 SEE ALSO 👀

💖 Author 💖

Maintained by the LLVM Team (https://llvm.org/). They keep this whole thing fed and hydrated, fr fr.

2003-2026, LLVM Project. Respect the legacy, periodt. 👑

And that's a wrap on LLVM-OBJDUMP(1)! This page came straight out of the LLVM source, dated 2026-07-16, and it was page 22 of the manual — a whole twenty-two pages of objdump excellence, slay. Go read your binaries, bestie, you've got this 💅✨🦋

📦 where this page comes from