llvm-objdump - LLVM's object file dumper
========================================
.. program:: llvm-objdump
SYNOPSIS
--------
:program:`llvm-objdump` [*commands*] [*options*] [*filenames...*]
DESCRIPTION
-----------
The :program:`llvm-objdump` utility prints the contents of object files and
final linked images named on the command line. If no file name is specified,
:program:`llvm-objdump` will attempt to read from *a.out*. If *-* is used as a
file name, :program:`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:
.. option:: -a, --archive-headers
Display the information contained within an archive's headers.
.. option:: -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, :option:`--mcpu` or :option:`--mattr` is needed to
enable some instruction sets. Disabled instructions are displayed as
``<unknown>``.
.. option:: -D, --disassemble-all
Disassemble all sections found in the input files.
.. option:: --disassemble-symbols=<symbol1[,symbol2,...]>
Disassemble only the specified symbols. Takes demangled symbol names when
:option:`--demangle` is specified, otherwise takes mangled symbol names.
Implies :option:`--disassemble`.
.. option:: --dwarf=<value>
Dump the specified DWARF debug sections. The supported values are:
`frames` - .debug_frame
.. option:: -f, --file-headers
Display the contents of the overall file header.
.. option:: --fault-map-section
Display the content of the fault map section.
.. option:: -h, --headers, --section-headers
Display summaries of the headers for each section.
.. option:: --help
Display usage information and exit. Does not stack with other commands.
.. option:: -p, --private-headers
Display format-specific file headers.
.. option:: -r, --reloc
Display the relocation entries in the file.
.. option:: -R, --dynamic-reloc
Display the dynamic relocation entries in the file.
.. option:: --raw-clang-ast
Dump the raw binary contents of the clang AST section.
.. option:: -s, --full-contents
Display the contents of each section.
.. option:: -t, --syms
Display the symbol table.
.. option:: -T, --dynamic-syms
Display the contents of the dynamic symbol table.
.. option:: -u, --unwind-info
Display the unwind info of the input(s).
This operation is only currently supported for COFF and Mach-O object files.
.. option:: -v, --version
Display the version of the :program:`llvm-objdump` executable. Does not stack
with other commands.
.. option:: -x, --all-headers
Display all available header information. Equivalent to specifying
:option:`--archive-headers`, :option:`--file-headers`,
:option:`--private-headers`, :option:`--reloc`, :option:`--section-headers`,
and :option:`--syms`.
OPTIONS
-------
:program:`llvm-objdump` supports the following options:
.. option:: --adjust-vma=<offset>
Increase the displayed address in disassembly or section header printing by
the specified offset.
.. option:: --arch-name=<string>
Specify the target architecture when disassembling. Use :option:`--version`
for a list of available targets.
.. option:: -C, --demangle
Demangle symbol names in the output.
.. option:: --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.
.. option:: --debug-vars-indent=<width>
Distance to indent the source-level variable display, relative to the start
of the disassembly. Defaults to 52 characters.
.. option:: -j, --section=<section1[,section2,...]>
Perform commands on the specified sections only. For Mach-O use
`segment,section` to specify the section name.
.. option:: -l, --line-numbers
When disassembling, display source line numbers. Implies
:option:`--disassemble`.
.. option:: -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.
.. option:: --mcpu=<cpu-name>
Target a specific CPU type for disassembly. Specify ``--mcpu=help`` to display
available CPUs.
.. option:: --mattr=<a1,+a2,-a3,...>
Enable/disable target-specific attributes. Specify ``--mattr=help`` to display
the available attributes.
.. option:: --no-leading-addr
When disassembling, do not print leading addresses.
.. option:: --no-print-imm-hex
Do not use hex format for immediate values in disassembly output (default).
.. option:: --no-show-raw-insn
When disassembling, do not print the raw bytes of each instruction.
.. option:: --offloading
Display the content of the LLVM offloading section.
.. option:: --prefix=<prefix>
When disassembling with the :option:`--source` option, prepend ``prefix`` to
absolute paths.
.. option:: --prefix-strip=<level>
When disassembling with the :option:`--source` option, strip out ``level``
initial directories from absolute paths. This option has no effect without
:option:`--prefix`.
.. option:: --print-imm-hex
Use hex format when printing immediate values in disassembly output.
.. option:: -S, --source
When disassembling, display source interleaved with the disassembly. Implies
:option:`--disassemble`.
.. option:: --show-lma
Display the LMA column when dumping ELF section headers. Defaults to off
unless any section has different VMA and LMAs.
.. option:: --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``.
.. option:: --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``.
.. option:: --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
.. code-block:: none
cmp eax, dword ptr [rip + 4112]
jge 0x20117e <_start+0x25>
might become
.. code-block:: none
<L0>:
cmp eax, dword ptr <g>
jge <L0>
.. option:: --triple=<string>
Target triple to disassemble for, see ``--version`` for available targets.
.. option:: -w, --wide
Ignored for compatibility with GNU objdump.
.. option:: --x86-asm-syntax=<style>
Deprecated.
When used with :option:`--disassemble`, choose style of code to emit from
X86 backend. Supported values are:
.. option:: att
AT&T-style assembly
.. option:: intel
Intel-style assembly
The default disassembly style is **att**.
.. option:: -z, --disassemble-zeroes
Do not skip blocks of zeroes when disassembling.
.. option:: @<FILE>
Read command-line options and commands from response file `<FILE>`.
MACH-O ONLY OPTIONS AND COMMANDS
--------------------------------
.. option:: --arch=<architecture>
Specify the architecture to disassemble. see ``--version`` for available
architectures.
.. option:: --archive-member-offsets
Print the offset to each archive member for Mach-O archives (requires
:option:`--archive-headers`).
.. option:: --bind
Display binding info
.. option:: --data-in-code
Display the data in code table.
.. option:: --dis-symname=<name>
Disassemble just the specified symbol's instructions.
.. option:: --dyld_info
Print bind and rebase information used by dyld to resolve external
references in a final linked binary.
.. option:: --dylibs-used
Display the shared libraries used for linked files.
.. option:: --dsym=<string>
Use .dSYM file for debug info.
.. option:: --dylib-id
Display the shared library's ID for dylib files.
.. option:: --exports-trie
Display exported symbols.
.. option:: --function-starts
Print the function starts table for Mach-O objects.
.. option:: -g
Print line information from debug info if available.
.. option:: --full-leading-addr
Print the full leading address when disassembling.
.. option:: --indirect-symbols
Display the indirect symbol table.
.. option:: --info-plist
Display the info plist section as strings.
.. option:: --lazy-bind
Display lazy binding info.
.. option:: --link-opt-hints
Display the linker optimization hints.
.. option:: -m, --macho
Use Mach-O specific object file parser. Commands and other options may behave
differently when used with ``--macho``.
.. option:: --no-leading-headers
Do not print any leading headers.
.. option:: --no-symbolic-operands
Do not print symbolic operands when disassembling.
.. option:: --non-verbose
Display the information for Mach-O objects in non-verbose or numeric form.
.. option:: --objc-meta-data
Display the Objective-C runtime meta data.
.. option:: --private-header
Display only the first format specific file header.
.. option:: --rebase
Display rebasing information.
.. option:: --rpaths
Display runtime search paths for the binary.
.. option:: --universal-headers
Display universal headers.
.. option:: --weak-bind
Display weak binding information.
XCOFF ONLY OPTIONS AND COMMANDS
---------------------------------
.. option:: --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
--------
:manpage:`llvm-nm(1)`, :manpage:`llvm-otool(1)`, :manpage:`llvm-readelf(1)`,
:manpage:`llvm-readobj(1)`