--- name: "objdump" section: "1" platform: "freebsd" package: "base" version: "16.0-CURRENT-20261027-61c70dc16a79" release: "FreeBSD 16.0-CURRENT (2026-10-27)" platforms: ["linux", "freebsd"] url: "https://new.carta.tech/llvm-objdump" --- # objdump(1) LLVM's object file dumper Part of [llvm-objdump(1)](/llvm-objdump/1.md). ## NAME llvm-objdump - LLVM's object file dumper ## SYNOPSIS **llvm-objdump** \[*commands*\] \[*options*\] \[*filenames...*\] ## DESCRIPTION The **llvm-objdump** utility prints the contents of object files and final linked images named on the command line. If no file name is specified, **llvm-objdump** will attempt to read from *a.out*. If *-* is used as a file name, **llvm-objdump** will process a file on its standard input stream. ## COMMANDS At least one of the following commands are required, and some commands can be combined with other commands: - **-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, PPC64, 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 **\**. - **-D, --disassemble-all** Disassemble all sections found in the input files. - **--disassemble-symbols=\** Disassemble only the specified symbols. Takes demangled symbol names when *--demangle* is specified, otherwise takes mangled symbol names. Implies *--disassemble*. - **--dwarf=\** 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*. ## OPTIONS **llvm-objdump** supports the following options: - **--adjust-vma=\** Increase the displayed address in disassembly or section header printing by the specified offset. - **--arch-name=\** Specify the target architecture when disassembling. Use *--version* for a list of available targets. - **--build-id=\** 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. - **--debug-file-directory \** 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. - **--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**. - **--debug-vars=\** 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=\** Distance to indent the source-level variable display, relative to the start of the disassembly. Defaults to 52 characters. - **-j, --section=\** 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=\** 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. - **--mcpu=\** Target a specific CPU type for disassembly. Specify **--mcpu=help** to display available CPUs. - **--mattr=\** Enable/disable target-specific attributes. Specify **--mattr=help** to display the available attributes. - **--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 section. - **--prefix=\** When disassembling with the *--source* option, prepend **prefix** to absolute paths. - **--prefix-strip=\** 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=\** 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=\** 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-sections=labels**), labels are retrieved from that section instead. Only works with PowerPC objects or X86 linked images. - **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 ``` : cmp eax, dword ptr jge ``` - **--triple=\** Target triple to disassemble for, see **--version** for available targets. - **-w, --wide** Ignored for compatibility with GNU objdump. - **--x86-asm-syntax=\** 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. - **@\** Read command-line options and commands from response file *\*. ## MACH-O ONLY OPTIONS AND COMMANDS - **--arch=\** 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 - **--data-in-code** Display the data in code table. - **--dis-symname=\** Disassemble just the specified symbol's instructions. - **--chained-fixups** Print chained fixup information. - **--dyld-info** Print bind and rebase information used by dyld to resolve external references in a final linked binary. - **--dylibs-used** Display the shared libraries used for linked files. - **--dsym=\** Use .dSYM file for debug info. - **--dylib-id** Display the shared library's ID for dylib files. - **--exports-trie** Display exported symbols. - **--function-starts \[=\\]** Print the function starts table for Mach-O objects. Either **addrs** (default) to print only the addresses of functions, **names** to print only the names of the functions (when available), or **both** to print the names beside the addresses. - **-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. - **--rpaths** Display runtime search paths for the binary. - **--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://github.com/llvm/llvm-project/labels/tools:llvm-objdump/*\>. ## SEE ALSO **[llvm-nm(1)](/llvm-nm/1.md)**, **[llvm-otool(1)](/llvm-otool/1.md)**, **[llvm-readelf(1)](/llvm-readelf/1.md)**, **[llvm-readobj(1)](/llvm-readobj/1.md)** ## AUTHOR Maintained by the LLVM Team (https://llvm.org/). ## COPYRIGHT 2003-2023, LLVM Project