LLVM-OBJDUMP(1)

📦
version 11.1.0 · 3 versions
, in fedora 43, fedora 44

👑 llvm-objdump — bestie's guide to peeking inside object files 💖

okay so. you know how your compiled binaries are like little mystery boxes and you're just sitting there like "what is IN there"? yeah. llvm-objdump is the LLVM utility that prints the contents of object files and final linked images named on the command line. it's giving x-ray vision, fr fr. 🔥

no cap, if you don't name any file, llvm-objdump will attempt to read from a.out. and if you use - as a file name, it will process a file on its standard input stream. iconic behaviour honestly. ✨

🌸 SYNOPSIS 🌸

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

✨ COMMANDS ✨

okay bestie listen. you need at least one of the following commands, and some of them can be combined with other commands. mix and match, slay. 💅

  • -a, --archive-headers — display the information contained within an archive's headers.
  • -d, --disassemble — disassemble all text sections found in the input files.
  • -D, --disassemble-all — disassemble all sections found in the input files.
  • --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).
  • --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, periodt. 🍓

🎀 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.
  • -C, --demangle — demangle symbol names in the output.
  • --debug-vars=<format> — print the locations (in registers or memory) of source-level variables alongside disassembly. format may be unicode or ascii, defaulting to unicode if omitted.
  • --debug-vars-indent=<width> — distance to indent the source-level variable display, relative to the start of the disassembly. defaults to 40 characters.
  • -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. currently supported for ARM targets only. available options are reg-names-std and reg-names-raw.
  • --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 --mcpu=help to display the available attributes.
  • --no-leading-addr — when disassembling, do not print leading addresses.
  • --no-show-raw-insn — when disassembling, do not print the raw bytes of each instruction.
  • --print-imm-hex — use hex format when printing immediate values in disassembly output.
  • -S, --source — when disassembling, display source interleaved with the disassembly. implies --disassemble.
  • --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.
  • --triple=<string> — target triple to disassemble for, see --version for available targets.
  • -w, --wide — ignored for compatibility with GNU objdump. it's just there being decorative bestie, no cap. 🙈
  • --x86-asm-syntax=<style> — 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.
  • @<FILE> — read command-line options and commands from response file <FILE>.

🦋 MACH-O ONLY OPTIONS AND COMMANDS 🦋

  • --arch=<architecture> — specify the architecture to disassemble. see --version for available architectures.
  • --archive-member-offsets — print the offset to each archive member for Mach-O archives (requires --archive-headers).
  • --bind — display binding info
  • --cfg — create a CFG for every symbol in the object file and write it to a graphviz file.
  • --data-in-code — display the data in code table.
  • --dis-symname=<name> — disassemble just the specified symbol's instructions.
  • --dylibs-used — display the shared libraries used for linked files.
  • --dsym=<string> — use .dSYM file for debug info.
  • --dylib-id — display the shared library's ID for dylib files.
  • --exports-trie — display exported symbols.
  • -g — print line information from debug info if available.
  • --full-leading-addr — print the full leading address when disassembling.
  • --indirect-symbols — display the indirect symbol table.
  • --info-plist — display the info plist section as strings.
  • --lazy-bind — display lazy binding info.
  • --link-opt-hints — display the linker optimization hints.
  • -m, --macho — use Mach-O specific object file parser. commands and other options may behave differently when used with --macho.
  • --no-leading-headers — do not print any leading headers.
  • --no-symbolic-operands — do not print symbolic operands when disassembling.
  • --non-verbose — display the information for Mach-O objects in non-verbose or numeric form.
  • --objc-meta-data — display the Objective-C runtime meta data.
  • --private-header — display only the first format specific file header.
  • --rebase — display rebasing information.
  • --universal-headers — display universal headers.
  • --weak-bind — display weak binding information.

🌈 XCOFF ONLY OPTIONS AND COMMANDS 🌈

  • --symbol-description — add symbol description to disassembly output.

💀 BUGS 💀

to report bugs, please visit <https://bugs.llvm.org/>. (yes it's a link, go click it, they want your bug reports bestie.)

👑 SEE ALSO 👑

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

the whole friend group honestly. 🫶

🧚 AUTHOR 🧚

maintained by the LLVM Team (https://llvm.org/).

2003-2024, LLVM Project

and that's the whole page bestie, no cap. this is LLVM's own llvm-objdump(1) manual, dated 2024-07-18 and tagged LLVM at version 11 in the footer — go dump some objects and be the main character of your own disassembly. periodt. 💅✨🎀

📦 where this page comes from