.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4.
.TH LLVM-OBJDUMP "1" "March 2018" "llvm-objdump 6.0" "User Commands"
.SH NAME
llvm-objdump \- manual page for llvm-objdump 6.0
.SH DESCRIPTION
OVERVIEW: llvm object file dumper
.PP
USAGE: llvm\-objdump [options]
.PP
OPTIONS:
.PP
General options:
.HP
\fB\-aarch64\-neon\-syntax\fR \- Choose style of NEON code to emit from AArch64 backend:
.TP
=generic
\- Emit generic NEON assembly
.TP
=apple
\- Emit Apple\-style NEON assembly
.HP
\fB\-amdgpu\-dump\-hsa\-metadata\fR \- Dump AMDGPU HSA Metadata
.HP
\fB\-amdgpu\-enable\-merge\-m0\fR \- Merge and hoist M0 initializations
.HP
\fB\-amdgpu\-sdwa\-peephole\fR \- Enable SDWA peepholer
.HP
\fB\-amdgpu\-spill\-sgpr\-to\-smem\fR \- Use scalar stores to spill SGPRs if supported by subtarget
.HP
\fB\-amdgpu\-verify\-hsa\-metadata\fR \- Verify AMDGPU HSA Metadata
.HP
\fB\-amdgpu\-vgpr\-index\-mode\fR \- Use GPR indexing mode instead of movrel for vector indexing
.HP
\fB\-arch=\fR \- architecture(s) from a Mach\-O file to dump
.HP
\fB\-arch\-name=\fR \- Target arch to disassemble for, see \fB\-version\fR for available targets
.HP
\fB\-archive\-headers\fR \- Print archive headers for Mach\-O archives (requires \fB\-macho\fR)
.HP
\fB\-archive\-member\-offsets\fR \- Print the offset to each archive member for Mach\-O archives (requires \fB\-macho\fR and \fB\-archive\-headers\fR)
.HP
\fB\-arm\-add\-build\-attributes\fR \-
.HP
\fB\-arm\-implicit\-it\fR \- Allow conditional instructions outdside of an IT block
.TP
=always
\- Accept in both ISAs, emit implicit ITs in Thumb
.TP
=never
\- Warn in ARM, reject in Thumb
.TP
=arm
\- Accept in ARM, reject in Thumb
.TP
=thumb
\- Warn in ARM, emit implicit ITs in Thumb
.TP
\fB\-atomic\-counter\-update\-promoted\fR \- Do counter update using atomic fetch add
for promoted counters only
.HP
\fB\-bind\fR \- Display mach\-o binding info
.HP
\fB\-bounds\-checking\-single\-trap\fR \- Use one trap block per function
.HP
\fB\-color\fR \- use colored syntax highlighting (default=autodetect)
.HP
\fB\-cost\-kind\fR \- Target cost kind
.TP
=throughput
\- Reciprocal throughput
.TP
=latency
\- Instruction latency
.TP
=code\-size
\- Code size
.HP
\fB\-cvp\-dont\-process\-adds\fR \-
.HP
\fB\-data\-in\-code\fR \- Print the data in code table for Mach\-O objects (requires \fB\-macho\fR)
.HP
\fB\-debug\-counter\fR \- Comma separated list of debug counter skip and count
.TP
=predicateinfo\-rename
\- Controls which variables are renamed with predicateinfo
.TP
=instcombine\-visit
\- Controls which instructions are visited
.TP
=newgvn\-vn
\- Controls which instructions are value numbered
.TP
=newgvn\-phi
\- Controls which instructions we create phi of ops for
.HP
\fB\-dis\-symname=\fR \- disassemble just this symbol's instructions (requires \fB\-macho\fR)
.HP
\fB\-disassemble\fR \- Display assembler mnemonics for the machine instructions
.HP
\fB\-disassemble\-all\fR \- Display assembler mnemonics for the machine instructions
.HP
\fB\-do\-counter\-promotion\fR \- Do counter register promotion
.HP
\fB\-dsym=\fR \- Use .dSYM file for debug info
.HP
\fB\-dwarf\fR \- Dump of dwarf debug sections:
.TP
=frames
\- .debug_frame
.HP
\fB\-dylib\-id\fR \- Print the shared library's id for the dylib Mach\-O file (requires \fB\-macho\fR)
.HP
\fB\-dylibs\-used\fR \- Print the shared libraries used for linked Mach\-O files (requires \fB\-macho\fR)
.HP
\fB\-enable\-load\-pre\fR \-
.HP
\fB\-enable\-name\-compression\fR \- Enable name string compression
.HP
\fB\-enable\-packed\-inlinable\-literals\fR \- Enable packed inlinable literals (v2f16, v2i16)
.HP
\fB\-enable\-si\-insert\-waitcnts\fR \- Use new waitcnt insertion pass
.HP
\fB\-expensive\-combines\fR \- Enable expensive instruction combines
.HP
\fB\-exports\-trie\fR \- Display mach\-o exported symbols
.HP
\fB\-fault\-map\-section\fR \- Display contents of faultmap section
.HP
\fB\-full\-leading\-addr\fR \- Print full leading address
.HP
\fB\-g\fR \- Print line information from debug info if available
.TP
\fB\-gpsize=\fR \- Global Pointer Addressing Size.
The default size is 8.
.HP
\fB\-hash\-based\-counter\-split\fR \- Rename counter variable of a comdat function based on cfg hash
.HP
\fB\-import\-all\-index\fR \- Import all external functions in index.
.HP
\fB\-indirect\-symbols\fR \- Print indirect symbol table for Mach\-O objects (requires \fB\-macho\fR)
.HP
\fB\-info\-plist\fR \- Print the info plist section as strings for Mach\-O objects (requires \fB\-macho\fR)
.HP
\fB\-instcombine\-maxarray\-size=\fR \- Maximum array size considered when doing a combine
.HP
\fB\-internalize\-public\-api\-file=\fR \- A file containing list of symbol names to preserve
.HP
\fB\-internalize\-public\-api\-list=\fR \- A list of symbol names to preserve
.HP
\fB\-iterative\-counter\-promotion\fR \- Allow counter promotion across the whole loop nest.
.HP
\fB\-lazy\-bind\fR \- Display mach\-o lazy binding info
.HP
\fB\-line\-numbers\fR \- Display source line numbers with disassembly. Implies disassemble object
.HP
\fB\-link\-opt\-hints\fR \- Print the linker optimization hints for Mach\-O objects (requires \fB\-macho\fR)
.HP
\fB\-lto\-pass\-remarks\-output=\fR \- Output filename for pass remarks
.HP
\fB\-macho\fR \- Use MachO specific object file parser
.HP
\fB\-mattr=\fR \- Target specific attributes
.HP
\fB\-max\-counter\-promotions=\fR \- Max number of allowed counter promotions
.HP
\fB\-max\-counter\-promotions\-per\-loop=\fR \- Max number counter promotions per loop to avoid increasing register pressure too much
.HP
\fB\-mcpu=\fR \- Target a specific cpu type (\fB\-mcpu\fR=\fI\,help\/\fR for details)
.HP
\fB\-memop\-size\-large=\fR \- Set large value thresthold in memory intrinsic size profiling. Value of 0 disables the large value profiling.
.HP
\fB\-memop\-size\-range=\fR \- Set the range of size in memory intrinsic calls to be profiled precisely, in a format of :
.HP
\fB\-merror\-missing\-parenthesis\fR \- Error for missing parenthesis around predicate registers
.HP
\fB\-merror\-noncontigious\-register\fR \- Error for register names that aren't contigious
.HP
\fB\-mhvx\fR \- Enable Hexagon Vector eXtensions
.TP
=v60
\- Build for HVX v60
.TP
=v62
\- Build for HVX v62
.TP
=v65
\- Build for HVX v65
.TP
=
\-
.HP
\fB\-mips\-compact\-branches\fR \- MIPS Specific: Compact branch policy.
.TP
=never
\- Do not use compact branches if possible.
.TP
=optimal
\- Use compact branches where appropiate (default).
.TP
=always
\- Always use compact branches if possible.
.HP
\fB\-mips16\-constant\-islands\fR \- Enable mips16 constant islands.
.HP
\fB\-mips16\-hard\-float\fR \- Enable mips16 hard float.
.HP
\fB\-mno\-compound\fR \- Disable looking for compound instructions for Hexagon
.HP
\fB\-mno\-fixup\fR \- Disable fixing up resolved relocations for Hexagon
.HP
\fB\-mno\-ldc1\-sdc1\fR \- Expand double precision loads and stores to their single precision counterparts
.HP
\fB\-mno\-pairing\fR \- Disable looking for duplex instructions for Hexagon
.HP
\fB\-mwarn\-missing\-parenthesis\fR \- Warn for missing parenthesis around predicate registers
.HP
\fB\-mwarn\-noncontigious\-register\fR \- Warn for register names that arent contigious
.HP
\fB\-mwarn\-sign\-mismatch\fR \- Warn for mismatching a signed and unsigned value
.HP
\fB\-no\-discriminators\fR \- Disable generation of discriminator information.
.HP
\fB\-no\-leading\-addr\fR \- Print no leading address
.HP
\fB\-no\-leading\-headers\fR \- Print no leading headers
.HP
\fB\-no\-show\-raw\-insn\fR \- When disassembling instructions, do not print the instruction bytes.
.HP
\fB\-no\-symbolic\-operands\fR \- do not symbolic operands when disassembling (requires \fB\-macho\fR)
.HP
\fB\-non\-verbose\fR \- Print the info for Mach\-O objects in non\-verbose or numeric form (requires \fB\-macho\fR)
.HP
\fB\-nvptx\-sched4reg\fR \- NVPTX Specific: schedule for register pressue
.HP
\fB\-objc\-meta\-data\fR \- Print the Objective\-C runtime meta data for Mach\-O files (requires \fB\-macho\fR)
.HP
\fB\-print\-imm\-hex\fR \- Use hex format for immediate values
.HP
\fB\-print\-module\-scope\fR \- When printing IR for print\-[before|after]{\-all} always print a module IR
.HP
\fB\-private\-header\fR \- Display only the first format specific file header
.HP
\fB\-private\-headers\fR \- Display format specific file headers
.HP
\fB\-r\fR \- Display the relocation entries in the file
.HP
\fB\-r600\-ir\-structurize\fR \- Use StructurizeCFG IR pass
.HP
\fB\-raw\-clang\-ast\fR \- Dump the raw binary contents of the clang AST section
.HP
\fB\-rdf\-dump\fR \-
.HP
\fB\-rdf\-limit=\fR \-
.HP
\fB\-rebase\fR \- Display mach\-o rebasing info
.HP
\fB\-s\fR \- Display the content of each section
.HP
\fB\-safepoint\-ir\-verifier\-print\-only\fR \-
.HP
\fB\-sample\-profile\-check\-record\-coverage=\fR \- Emit a warning if less than N% of records in the input profile are matched to the IR.
.HP
\fB\-sample\-profile\-check\-sample\-coverage=\fR \- Emit a warning if less than N% of samples in the input profile are matched to the IR.
.HP
\fB\-sample\-profile\-inline\-hot\-threshold=\fR \- Inlined functions that account for more than N% of all samples collected in the parent function, will be inlined again.
.HP
\fB\-sample\-profile\-max\-propagate\-iterations=\fR \- Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.
.HP
\fB\-section=\fR \- Operate on the specified sections only. With \fB\-macho\fR dump segment,section
.HP
\fB\-section\-headers\fR \- Display summaries of the headers for each section.
.HP
\fB\-source\fR \- Display source inlined with disassembly. Implies disassmble object
.TP
\fB\-speculative\-counter\-promotion\-max\-exiting=\fR \- The max number of exiting blocks of a loop to allow
speculative counter promotion
.TP
\fB\-speculative\-counter\-promotion\-to\-loop\fR \- When the option is false, if the target block is in a loop, the promotion will be disallowed unless the promoted counter
update can be further/iteratively promoted into an acyclic region.
.HP
\fB\-start\-address=\fR \- Disassemble beginning at address
.HP
\fB\-stop\-address=\fR \- Stop disassembly at address
.HP
\fB\-summary\-file=\fR \- The summary file to use for function importing.
.HP
\fB\-t\fR \- Display the symbol table
.HP
\fB\-threads=\fR \-
.HP
\fB\-triple=\fR \- Target triple to disassemble for, see \fB\-version\fR for available targets
.HP
\fB\-unfold\-element\-atomic\-memcpy\-max\-elements=\fR \- Maximum number of elements in atomic memcpy the optimizer is allowed to unfold
.HP
\fB\-universal\-headers\fR \- Print Mach\-O universal headers (requires \fB\-macho\fR)
.HP
\fB\-unwind\-info\fR \- Display unwind information
.HP
\fB\-verify\-region\-info\fR \- Verify region info (time consuming)
.HP
\fB\-vp\-counters\-per\-site=\fR \- The average number of profile counters allocated per value profiling site.
.HP
\fB\-vp\-static\-alloc\fR \- Do static counter allocation for value profiler
.HP
\fB\-weak\-bind\fR \- Display mach\-o weak binding info
.PP
Generic Options:
.HP
\fB\-help\fR \- Display available options (\fB\-help\-hidden\fR for more)
.HP
\fB\-help\-list\fR \- Display list of available options (\fB\-help\-list\-hidden\fR for more)
.HP
\fB\-version\fR \- Display the version of this program
.SH "SEE ALSO"
The full documentation for
.B llvm-objdump
is maintained as a Texinfo manual. If the
.B info
and
.B llvm-objdump
programs are properly installed at your site, the command
.IP
.B info llvm-objdump
.PP
should give you access to the complete manual.