LLVM-MC(1) User Commands LLVM-MC(1)
NAME
llvm-mc - manual page for llvm-mc 6.0
DESCRIPTION
OVERVIEW: llvm machine code playground
USAGE: llvm-mc [options] <input file>
OPTIONS:
General options:
-I=<directory> - Directory of in-
clude files
-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-hsa-metadata - Dump AMDGPU HSA
Metadata
-amdgpu-enable-merge-m0 - Merge and hoist M0
initializations
-amdgpu-sdwa-peephole - Enable SDWA peep-
holer
-amdgpu-spill-sgpr-to-smem - Use scalar stores
to spill SGPRs if supported by subtarget
-amdgpu-verify-hsa-metadata - Verify AMDGPU HSA
Metadata
-amdgpu-vgpr-index-mode - Use GPR indexing
mode instead of movrel for vector indexing
-arch=<string> - Target arch to as-
semble for, see -version for available targets
-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
-asm-instrumentation - Instrumentation of
inline assembly and assembly source files
=none - no instrumentation at all
=address
- instrument instructions with memory arguments
-asm-show-inst - Emit internal in-
struction representation to assembly file
-atomic-counter-update-promoted - Do counter update
using atomic fetch add
for promoted counters only
-bounds-checking-single-trap - Use one trap block
per function
-color - use colored syntax
highlighting (default=autodetect)
-compress-debug-sections - Choose DWARF debug
sections compression:
=none - No compression
=zlib - Use zlib compression
=zlib-gnu
- Use zlib-gnu compression (deprecated)
-cost-kind - Target cost kind
=throughput
- Reciprocal throughput
=latency
- Instruction latency
=code-size
- Code size
-cvp-dont-process-adds -
-debug-counter - Comma separated
list of debug counter skip and count
=predicateinfo-rename
- Controls which variables are renamed with predicateinfo
=instcombine-visit
- Controls which instructions are visited
=newgvn-vn
- Controls which instructions are value numbered
=newgvn-phi
- Controls which instructions we create phi of ops for
=falkor-hwpf
- Controls which tag collisions are avoided
-defsym=<string> - Defines a symbol to
be an integer constant
Action to perform:
-as-lex - Lex tokens from a .s
file
-assemble - Assemble a .s file
(default)
-disassemble - Disassemble strings
of hex bytes
-mdis - Marked up disassembly
of strings of hex bytes
-do-counter-promotion - Do counter register
promotion
-dwarf-version=<int> - Dwarf version
-emscripten-cxx-exceptions-whitelist=<string> - The list of func-
tion names in which Emscripten-style exception handling is en-
abled (see emscripten EMSCRIPTEN_CATCHING_WHITELIST options)
-enable-emscripten-cxx-exceptions - WebAssembly Em-
scripten-style exception handling
-enable-emscripten-sjlj - WebAssembly Em-
scripten-style setjmp/longjmp handling
-enable-load-pre -
-enable-name-compression - Enable name string
compression
-enable-packed-inlinable-literals - Enable packed in-
linable literals (v2f16, v2i16)
-enable-si-insert-waitcnts - Use new waitcnt in-
sertion pass
-expensive-combines - Enable expensive
instruction combines
-fatal-warnings - Treat warnings as
errors
-fdebug-compilation-dir=<string> - Specifies the debug
info's compilation dir
-filetype - Choose an output
file type:
=asm - Emit an assembly ('.s') file
=null - Don't emit anything (for timing purposes)
=obj - Emit a native object ('.o') file
-g - Generate dwarf de-
bugging info for assembly source files
-gpsize=<uint> - Global Pointer Ad-
dressing Size.
The default size is 8.
-hash-based-counter-split - Rename counter
variable of a comdat function based on cfg hash
-import-all-index - Import all external
functions in index.
-incremental-linker-compatible - When used with
filetype=obj, emit an object file which can be used with an in-
cremental linker
-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 pro-
motion across the whole loop nest.
-large-code-model - Create cfi direc-
tives that assume the code might be more than 2gb away
-lto-pass-remarks-output=<filename> - Output filename for
pass remarks
-main-file-name=<string> - Specifies the name
we should consider the input file
-mattr=<a1,+a2,-a3,...> - Target specific at-
tributes (-mattr=help for details)
-max-counter-promotions=<int> - Max number of al-
lowed counter promotions
-max-counter-promotions-per-loop=<uint> - Max number counter
promotions per loop to avoid increasing register pressure too
much
-mc-relax-all - When used with
filetype=obj, relax all fixups in the emitted object file
-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 dis-
ables 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
-mhvx - Enable Hexagon Vec-
tor eXtensions
=v60 - Build for HVX v60
=v62 - Build for HVX v62
=v65 - Build for HVX v65
= -
-mips-compact-branches - MIPS Specific: Com-
pact 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 con-
stant 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 pre-
cision 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 mismatch-
ing a signed and unsigned value
-n - Don't assume assem-
bly file starts in the text section
-no-deprecated-warn - Suppress all depre-
cated warnings
-no-discriminators - Disable generation
of discriminator information.
-no-exec-stack - File doesn't need
an exec stack
-no-warn - Suppress all warn-
ings
-nvptx-sched4reg - NVPTX Specific:
schedule for register pressue
-o=<filename> - Output filename
-output-asm-variant=<uint> - Syntax variant to
use for output printing
-pie-copy-relocations - PIE Copy Reloca-
tions
-position-independent - Position indepen-
dent
-preserve-comments - Preserve Comments
in outputted assembly
-print-imm-hex - Prefer hex format
for immediate values
-print-module-scope - When printing IR
for print-[before|after]{-all} always print a module IR
-r600-ir-structurize - Use StructurizeCFG
IR pass
-rdf-dump -
-rdf-limit=<uint> -
-relax-relocations - Emit R_X86_64_GOT-
PCRELX instead of R_X86_64_GOTPCREL
-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.
-save-temp-labels - Don't discard tem-
porary labels
-show-encoding - Show instruction
encodings
-show-inst - Show internal in-
struction representation
-show-inst-operands - Show instructions
operands as parsed
-speculative-counter-promotion-max-exiting=<uint> - The max number of
exiting blocks of a loop to allow
speculative counter promotion
-speculative-counter-promotion-to-loop - When the option is
false, if the target block is in a loop, the promotion will be disal-
lowed unless the promoted counter
update can be further/iteratively promoted into an acyclic re-
gion.
-summary-file=<string> - The summary file to
use for function importing.
-threads=<int> -
-triple=<string> - Target triple to
assemble 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
-verify-region-info - Verify region info
(time consuming)
-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
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
llvm-mc 6.0 May 2020 LLVM-MC(1)