LLVM-OBJDUMP(1)

📦
version 12.0.1 · 4 versions
, in fedora 43, fedora 44

💖 LLVM-OBJDUMP(1) 💖

okay bestie, welcome to the llvm-objdump manual page — it lives in section 1 of the LLVM manual, and it's literally the object-file dumper. let's get into it ✨

🌸 NAME 🌸

llvm-objdump — LLVM's object file dumper. that's it, that's the whole name, she's simple and she's iconic 💅

🦋 SYNOPSIS 🦋

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

✨ DESCRIPTION ✨

so the llvm-objdump utility prints the contents of object files and final linked images named on the command line. she's nosy in the best way 🫶

  • if no file name is specified, llvm-objdump will attempt to read from a.out. (yes, she'll just go looking, don't be weird about it)
  • if - is used as a file name, llvm-objdump will process a file on its standard input stream. very demure, very stdin 💖

👑 COMMANDS 👑

at least one of the following commands are required, and some commands can be combined with other commands. so like, you can't just show up with nothing, she needs a lil direction okay 😭

  • -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. she's doing the MOST and honestly? slay 💅

🎀 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 --mattr=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.
  • --prefix=<prefix> — when disassembling with the --source option, prepend prefix to absolute paths.
  • --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.
  • --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.
    • only works with an X86 linked image. (yes, only X86, don't try it elsewhere bestie)

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>
  • --triple=<string> — target triple to disassemble for, see --version for available targets.
  • -w, --wide — ignored for compatibility with GNU objdump. (she's just there for the vibes, she does nothing)
  • --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/>. (not me being the bug reporter 💅)

🫶 SEE ALSO 🫶

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

⭐ AUTHOR ⭐

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

2003-2024, LLVM Project

okay that's the whole page bestie, ily, go dump some objects 💖✨ and real quick, the cute lil sign-off at the bottom of the original said this was LLVM, release 12, dated 2024-07-18 — so that's your version and your date, mwah 🎀🦋

📦 where this page comes from