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 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
--demangleis 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).
-
-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=<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
--versionfor 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.
formatmay beunicodeorascii, defaulting tounicodeif omitted.
-
--debug-vars-indent=<width>¶ Distance to indent the source-level variable display, relative to the start of the disassembly. Defaults to 52 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. 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=<cpu-name>¶ Target a specific CPU type for disassembly. Specify
--mcpu=helpto display available CPUs.
-
--mattr=<a1,+a2,-a3,...>¶ Enable/disable target-specific attributes. Specify
--mattr=helpto display the available attributes.
-
--no-leading-addr¶ When disassembling, do not print leading addresses.
-
--no-print-imm-hex¶ Do not use hex format for immediate values in disassembly output (default).
-
--no-show-raw-insn¶ When disassembling, do not print the raw bytes of each instruction.
-
--prefix-strip=<level>¶ When disassembling with the
--sourceoption, strip outlevelinitial directories from absolute paths. This option has no effect without--prefix.
-
--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.
- 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
--versionfor available targets.
-
-w,--wide¶ Ignored for compatibility with GNU objdump.
-
--x86-asm-syntax=<style>¶ Deprecated. When used with
--disassemble, choose style of code to emit from X86 backend. Supported values are: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
--versionfor 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=<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.
-
--function-starts¶ Print the function starts table for Mach-O objects.
-
-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://bugs.llvm.org/>.
