Scroll to navigation

LLVM-OBJDUMP(1) User Commands LLVM-OBJDUMP(1)

NAME

llvm-objdump - manual page for llvm-objdump 5.0

DESCRIPTION

OVERVIEW: llvm object file dumper

USAGE: llvm-objdump [options] <input object files>

OPTIONS:

General options:

-aarch64-neon-syntax - Choose style of NEON code to emit from AArch64 backend:

=generic
- Emit generic NEON assembly
=apple
- Emit Apple-style NEON assembly

-amdgpu-dump-comd - Dump AMDGPU Code Object Metadata

-amdgpu-enable-merge-m0 - Merge and hoist M0 initializations

-amdgpu-sdwa-peephole - Enable SDWA peepholer

-amdgpu-spill-sgpr-to-smem - Use scalar stores to spill SGPRs if supported by subtarget

-amdgpu-verify-comd - Verify AMDGPU Code Object Metadata

-amdgpu-vgpr-index-mode - Use GPR indexing mode instead of movrel for vector indexing

-arch=<string> - architecture(s) from a Mach-O file to dump

-arch-name=<string> - Target arch to disassemble for, see -version for available targets

-archive-headers - Print archive headers for Mach-O archives (requires -macho)

-archive-member-offsets - Print the offset to each archive member for Mach-O archives (requires -macho and -archive-headers)

-arm-add-build-attributes -

-arm-implicit-it - Allow conditional instructions outdside of an IT block

=always
- Accept in both ISAs, emit implicit ITs in Thumb
=never
- Warn in ARM, reject in Thumb
=arm
- Accept in ARM, reject in Thumb
=thumb
- Warn in ARM, emit implicit ITs in Thumb
for promoted counters only

-bind - Display mach-o binding info

-bounds-checking-single-trap - Use one trap block per function

-color - use colored syntax highlighting (default=autodetect)

-cvp-dont-process-adds -

-data-in-code - Print the data in code table for Mach-O objects (requires -macho)

-debug-counter - Comma separated list of debug counter skip and count

=predicateinfo-rename
- Controls which variables are renamed with predicateinfo
=newgvn-vn
- Controls which instructions are value numbered
=newgvn-phi
- Controls which instructions we create phi of ops for

-dis-symname=<string> - disassemble just this symbol's instructions (requires -macho)

-disable-spill-fusing - Disable fusing of spill code into instructions

-disassemble - Display assembler mnemonics for the machine instructions

-disassemble-all - Display assembler mnemonics for the machine instructions

-do-counter-promotion - Do counter register promotion

-dsym=<string> - Use .dSYM file for debug info

-dwarf - Dump of dwarf debug sections:

=frames
- .debug_frame

-dylib-id - Print the shared library's id for the dylib Mach-O file (requires -macho)

-dylibs-used - Print the shared libraries used for linked Mach-O files (requires -macho)

-enable-implicit-null-checks - Fold null checks into faulting memory operations

-enable-load-pre -

-enable-name-compression - Enable name string compression

-enable-objc-arc-opts - enable/disable all ARC Optimizations

-enable-packed-inlinable-literals - Enable packed inlinable literals (v2f16, v2i16)

-enable-scoped-noalias -

-enable-si-insert-waitcnts - Use new waitcnt insertion pass

-enable-tbaa -

-exhaustive-register-search - Exhaustive Search for registers bypassing the depth and interference cutoffs of last chance recoloring

-expensive-combines - Enable expensive instruction combines

-exports-trie - Display mach-o exported symbols

-fault-map-section - Display contents of faultmap section

-filter-print-funcs=<function names> - Only print IR for functions whose name match this for all print-[before|after][-all] options

-full-leading-addr - Print full leading address

-g - Print line information from debug info if available

The default size is 8.

-hash-based-counter-split - Rename counter variable of a comdat function based on cfg hash

-imp-null-check-page-size=<int> - The page size of the target in bytes

-imp-null-max-insts-to-consider=<uint> - The max number of instructions to consider hoisting loads over (the algorithm is quadratic over this number)

-indirect-symbols - Print indirect symbol table for Mach-O objects (requires -macho)

-info-plist - Print the info plist section as strings for Mach-O objects (requires -macho)

-instcombine-maxarray-size=<uint> - Maximum array size considered when doing a combine

-internalize-public-api-file=<filename> - A file containing list of symbol names to preserve

-internalize-public-api-list=<list> - A list of symbol names to preserve

-iterative-counter-promotion - Allow counter promotion across the whole loop nest.

-join-liveintervals - Coalesce copies (default=true)

-lazy-bind - Display mach-o lazy binding info

-limit-float-precision=<uint> - Generate low-precision inline sequences for some float libcalls

-line-numbers - Display source line numbers with disassembly. Implies disassemble object

-link-opt-hints - Print the linker optimization hints for Mach-O objects (requires -macho)

-lto-pass-remarks-output=<filename> - Output filename for pass remarks

-macho - Use MachO specific object file parser

-mattr=<a1,+a2,-a3,...> - Target specific attributes

-max-counter-promotions=<int> - Max number of allowed counter promotions

-max-counter-promotions-per-loop=<uint> - Max number counter promotions per loop to avoid increasing register pressure too much

-mcpu=<cpu-name> - Target a specific cpu type (-mcpu=help for details)

-memop-size-large=<uint> - Set large value thresthold in memory intrinsic size profiling. Value of 0 disables the large value profiling.

-memop-size-range=<string> - Set the range of size in memory intrinsic calls to be profiled precisely, in a format of <start_val>:<end_val>

-merror-missing-parenthesis - Error for missing parenthesis around predicate registers

-merror-noncontigious-register - Error for register names that aren't contigious

-mfuture-regs - Enable future registers

-mips-compact-branches - MIPS Specific: Compact branch policy.

=never
- Do not use compact branches if possible.
=optimal
- Use compact branches where appropiate (default).
=always
- Always use compact branches if possible.

-mips16-constant-islands - Enable mips16 constant islands.

-mips16-hard-float - Enable mips16 hard float.

-mno-compound - Disable looking for compound instructions for Hexagon

-mno-fixup - Disable fixing up resolved relocations for Hexagon

-mno-ldc1-sdc1 - Expand double precision loads and stores to their single precision counterparts

-mno-pairing - Disable looking for duplex instructions for Hexagon

-mwarn-missing-parenthesis - Warn for missing parenthesis around predicate registers

-mwarn-noncontigious-register - Warn for register names that arent contigious

-mwarn-sign-mismatch - Warn for mismatching a signed and unsigned value

-no-discriminators - Disable generation of discriminator information.

-no-leading-addr - Print no leading address

-no-leading-headers - Print no leading headers

-no-show-raw-insn - When disassembling instructions, do not print the instruction bytes.

-no-symbolic-operands - do not symbolic operands when disassembling (requires -macho)

-non-verbose - Print the info for Mach-O objects in non-verbose or numeric form (requires -macho)

-nvptx-sched4reg - NVPTX Specific: schedule for register pressue

-objc-meta-data - Print the Objective-C runtime meta data for Mach-O files (requires -macho)

-print-after-all - Print IR after each pass

-print-before-all - Print IR before each pass

-print-imm-hex - Use hex format for immediate values

-print-machineinstrs=<pass-name> - Print machine instrs

-private-header - Display only the first format specific file header

-private-headers - Display format specific file headers

-r - Display the relocation entries in the file

-r600-ir-structurize - Use StructurizeCFG IR pass

-raw-clang-ast - Dump the raw binary contents of the clang AST section

-rdf-dump -

-rdf-limit=<uint> -

-rebase - Display mach-o rebasing info

-regalloc - Register allocator to use

=pbqp
- PBQP register allocator
=greedy
- greedy register allocator
=fast
- fast register allocator
=basic
- basic register allocator
=default
- pick register allocator based on -O option

-rewrite-map-file=<filename> - Symbol Rewrite Map

-rng-seed=<seed> - Seed for the random number generator

-s - Display the content of each section

-safepoint-ir-verifier-print-only -

-sample-profile-check-record-coverage=<N> - Emit a warning if less than N% of records in the input profile are matched to the IR.

-sample-profile-check-sample-coverage=<N> - Emit a warning if less than N% of samples in the input profile are matched to the IR.

-sample-profile-inline-hot-threshold=<N> - Inlined functions that account for more than N% of all samples collected in the parent function, will be inlined again.

-sample-profile-max-propagate-iterations=<uint> - Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.

-section=<string> - Operate on the specified sections only. With -macho dump segment,section

-section-headers - Display summaries of the headers for each section.

-simplify-mir - Leave out unnecessary information when printing MIR

-source - Display source inlined with disassembly. Implies disassmble object

speculative counter promotion
update can be further/iteratively promoted into an acyclic region.

-stackmap-version=<int> - Specify the stackmap encoding version (default = 3)

-start-address=<address> - Disassemble beginning at address

-static-func-full-module-prefix - Use full module build paths in the profile counter names for static functions.

-static-func-strip-dirname-prefix=<uint> - Strip specified level of directory name from source path in the profile counter name for static functions.

-stats - Enable statistics output from program (available with Asserts)

-stats-json - Display statistics as json data

-stop-address=<address> - Stop disassembly at address

-summary-file=<string> - The summary file to use for function importing.

-t - Display the symbol table

-threads=<int> -

-time-passes - Time each pass, printing elapsed time for each on exit

-triple=<string> - Target triple to disassemble for, see -version for available targets

-unfold-element-atomic-memcpy-max-elements=<uint> - Maximum number of elements in atomic memcpy the optimizer is allowed to unfold

-universal-headers - Print Mach-O universal headers (requires -macho)

-unwind-info - Display unwind information

-verify-debug-info -

-verify-dom-info - Verify dominator info (time consuming)

-verify-loop-info - Verify loop info (time consuming)

-verify-loop-lcssa - Verify loop lcssa form (time consuming)

-verify-machine-dom-info - Verify machine dominator info (time consuming)

-verify-regalloc - Verify during register allocation

-verify-region-info - Verify region info (time consuming)

-verify-scev - Verify ScalarEvolution's backedge taken counts (slow)

-verify-scev-maps - Verify no dangling value in ScalarEvolution's ExprValueMap (slow)

-vp-counters-per-site=<number> - The average number of profile counters allocated per value profiling site.

-vp-static-alloc - Do static counter allocation for value profiler

-weak-bind - Display mach-o weak binding info

-x86-asm-syntax - Choose style of code to emit from X86 backend:

=att
- Emit AT&T-style assembly
=intel
- Emit Intel-style assembly

Generic Options:

-help - Display available options (-help-hidden for more)

-help-list - Display list of available options (-help-list-hidden for more)

-version - Display the version of this program

SEE ALSO

The full documentation for llvm-objdump is maintained as a Texinfo manual. If the info and llvm-objdump programs are properly installed at your site, the command

info llvm-objdump

should give you access to the complete manual.

March 2018 llvm-objdump 5.0