---
name: "llvm-mc-4.0"
section: "1"
platform: "linux"
package: "llvm-4.0"
version: "1:4.0.1-10~deb9u2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/llvm-mc-4.0"
---
# llvm-mc-4.0(1)
manual page for llvm-mc 4.0
## NAME
llvm-mc - manual page for llvm-mc 4.0
## DESCRIPTION
OVERVIEW: llvm machine code playground
USAGE: llvm-mc \[options\] \
OPTIONS:
General options:
**-I=**\ - Directory of include 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-rtmd** - Dump AMDGPU runtime metadata
**-amdgpu-spill-sgpr-to-smem** - Use scalar stores to spill SGPRs if supported by subtarget
**-amdgpu-vgpr-index-mode** - Use GPR indexing mode instead of movrel for vector indexing
**-arch=**\ - Target arch to assemble for, see **-version** for available targets
**-arm-execute-only** -
**-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 instruction representation to assembly file
**-bounds-checking-single-trap** - Use one trap block per function
**-code-model** - Choose code model
- \=default
\- Target default code model
- \=small
\- Small code model
- \=kernel
\- Kernel code model
- \=medium
\- Medium code model
- \=large
\- Large code model
**-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)
**-cvp-dont-process-adds** -
**-defsym=**\ - Defines a symbol to be an integer constant
**-disable-spill-fusing** - Disable fusing of spill code into instructions
-
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
**-dwarf-version=**\ - Dwarf version
**-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-scoped-noalias** -
**-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
**-fatal-warnings** - Treat warnings as errors
**-fdebug-compilation-dir=**\ - 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
**-filter-print-funcs=**\ - Only print IR for functions whose name match this for all print-\[before\|after\]\[-all\] options
**-g** - Generate dwarf debugging info for assembly source files
- **-gpsize=**\ - Global Pointer Addressing Size.
The default size is 8.
**-hash-based-counter-split** - Rename counter variable of a comdat function based on cfg hash
**-ignore-empty-index-file** - Ignore an empty index file and perform non-ThinLTO compilation
**-imp-null-check-page-size=**\ - The page size of the target in bytes
**-imp-null-max-insts-to-consider=**\ - The max number of instructions to consider hoisting loads over (the algorithm is quadratic over this number)
**-incremental-linker-compatible** - When used with filetype=obj, emit an object file which can be used with an incremental linker
**-internalize-public-api-file=**\ - A file containing list of symbol names to preserve
**-internalize-public-api-list=**\ - A list of symbol names to preserve
**-join-liveintervals** - Coalesce copies (default=true)
**-limit-float-precision=**\ - Generate low-precision inline sequences for some float libcalls
**-lto-pass-remarks-output=**\ - Output filename for pass remarks
**-main-file-name=**\ - Specifies the name we should consider the input file
**-mattr=**\ - Target specific attributes (**-mattr**=*help* for details)
**-mc-relax-all** - When used with filetype=obj, relax all fixups in the emitted object file
**-mcpu=**\ - Target a specific cpu type (**-mcpu**=*help* for details)
**-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
**-n** - Don't assume assembly file starts in the text section
**-no-deprecated-warn** - Suppress all deprecated warnings
**-no-discriminators** - Disable generation of discriminator information.
**-no-exec-stack** - File doesn't need an exec stack
**-no-warn** - Suppress all warnings
**-nvptx-sched4reg** - NVPTX Specific: schedule for register pressue
**-o=**\ - Output filename
**-output-asm-variant=**\ - Syntax variant to use for output printing
**-pie-copy-relocations** - PIE Copy Relocations
**-position-independent** - Position independent
**-preserve-comments** - Preserve Comments in outputted assembly
**-print-after-all** - Print IR after each pass
**-print-before-all** - Print IR before each pass
**-print-imm-hex** - Prefer hex format for immediate values
**-print-machineinstrs=**\ - Print machine instrs
**-r600-ir-structurize** - Use StructurizeCFG IR pass
**-rdf-dump** -
**-rdf-limit=**\ -
**-regalloc** - Register allocator to use
- \=default
\- pick register allocator based on **-O** option
- \=pbqp
\- PBQP register allocator
- \=greedy
\- greedy register allocator
- \=fast
\- fast register allocator
- \=basic
\- basic register allocator
**-relax-relocations** - Emit R\_X86\_64\_GOTPCRELX instead of R\_X86\_64\_GOTPCREL
**-rewrite-map-file=**\ - Symbol Rewrite Map
**-rng-seed=**\ - Seed for the random number generator
**-sample-profile-check-record-coverage=**\ - Emit a warning if less than N% of records in the input profile are matched to the IR.
**-sample-profile-check-sample-coverage=**\ - Emit a warning if less than N% of samples in the input profile are matched to the IR.
**-sample-profile-inline-hot-threshold=**\ - 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=**\ - Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.
**-save-temp-labels** - Don't discard temporary labels
**-show-encoding** - Show instruction encodings
**-show-inst** - Show internal instruction representation
**-show-inst-operands** - Show instructions operands as parsed
**-stackmap-version=**\ - Specify the stackmap encoding version (default = 2)
**-static-func-full-module-prefix** - Use full module build paths in the profile counter names for static functions.
**-stats** - Enable statistics output from program (available with Asserts)
**-stats-json** - Display statistics as json data
**-summary-file=**\ - The summary file to use for function importing.
**-threads=**\ -
**-time-passes** - Time each pass, printing elapsed time for each on exit
**-triple=**\ - Target triple to assemble for, see **-version** for available targets
**-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=**\ - The average number of profile counters allocated per value profiling site.
**-vp-static-alloc** - Do static counter allocation for value profiler
**-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-mc** is maintained as a Texinfo manual. If the **info** and **llvm-mc** programs are properly installed at your site, the command
-
**info llvm-mc**
should give you access to the complete manual.