Manual Pages  — LLVM-OBJDUMP

llvm-objdump - LLVM's object file dumper

SYNOPSIS DESCRIPTION COMMANDS OPTIONS MACH-O ONLY OPTIONS AND COMMANDS XCOFF ONLY OPTIONS AND COMMANDS BUGS SEE ALSO AUTHOR COPYRIGHT

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

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.outamp;. If - is used as a file name, llvm-objdump will process a file on its standard input stream.

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 archiveaqs 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 <unknown>amp;.

-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  --disassembleamp;.

--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  --symsamp;.

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.

--debug-file-directory <path>
	Provide a path to a directory with a amp;.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_URLSamp;.

--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 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  --disassembleamp;.

-M, --disassembler-options=<opt1[,opt2,...]>
	Pass target-specific disassembler options. Available options:

»	reg-names-std: ARM only (default). Print in ARM aqs 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=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, --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=<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  --prefixamp;.

--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  --disassembleamp;.

--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 addressamp;. When printing symbols, only print symbols with a value of at least addressamp;.

--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 addressamp;. When printing symbols, only print symbols with a value up to addressamp;.

--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

<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.

--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 attamp;.

-z, --disassemble-zeroes
	Do not skip blocks of zeroes when disassembling.

@<FILE>	Read command-line options and commands from response file <FILE>amp;.

--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

--data-in-code
	Display the data in code table.

--dis-symname=<name>
	Disassemble just the specified symbolaqs 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=<string>
	Use .dSYM file for debug info.

--dylib-id
	Display the shared libraryaqs ID for dylib files.

--exports-trie
	Display exported symbols.

--function-starts [=<addrs|names|both>]
	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 --machoamp;.

--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.

--symbol-description
	Add symbol description to disassembly output.

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

2003-2023, LLVM Project