Scroll to navigation

LLVM-MC(1) User Commands LLVM-MC(1)


llvm-mc - manual page for llvm-mc 6.0


OVERVIEW: llvm machine code playground

USAGE: llvm-mc [options] <input file>


General options:

-I=<directory> - Directory of include files

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

- Emit generic NEON assembly
- 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 peepholer

-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 assemble for, see -version for available targets

-arm-add-build-attributes -

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

- Accept in both ISAs, emit implicit ITs in Thumb
- Warn in ARM, reject in Thumb
- Accept in ARM, reject in Thumb
- Warn in ARM, emit implicit ITs in Thumb

-asm-instrumentation - Instrumentation of inline assembly and assembly source files

- no instrumentation at all
- instrument instructions with memory arguments

-asm-show-inst - Emit internal instruction representation to assembly file

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:

- No compression
- Use zlib compression
- Use zlib-gnu compression (deprecated)

-cost-kind - Target cost kind

- Reciprocal throughput
- Instruction latency
- Code size

-cvp-dont-process-adds -

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

- Controls which variables are renamed with predicateinfo
- Controls which instructions are visited
- Controls which instructions are value numbered
- Controls which instructions we create phi of ops for
- 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 function names in which Emscripten-style exception handling is enabled (see emscripten EMSCRIPTEN_CATCHING_WHITELIST options)

-enable-emscripten-cxx-exceptions - WebAssembly Emscripten-style exception handling

-enable-emscripten-sjlj - WebAssembly Emscripten-style setjmp/longjmp handling

-enable-load-pre -

-enable-name-compression - Enable name string compression

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

-enable-si-insert-waitcnts - Use new waitcnt insertion 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:

- Emit an assembly ('.s') file
- Don't emit anything (for timing purposes)
- Emit a native object ('.o') file

-g - Generate dwarf debugging info for assembly source files

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 incremental 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 promotion across the whole loop nest.

-large-code-model - Create cfi directives 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 attributes (-mattr=help for details)

-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

-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 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

-mhvx - Enable Hexagon Vector eXtensions

- Build for HVX v60
- Build for HVX v62
- Build for HVX v65

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

- Do not use compact branches if possible.
- Use compact branches where appropiate (default).
- 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=<filename> - Output filename

-output-asm-variant=<uint> - 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-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_GOTPCRELX 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 temporary labels

-show-encoding - Show instruction encodings

-show-inst - Show internal instruction representation

-show-inst-operands - Show instructions operands as parsed

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

-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

May 2020 llvm-mc 6.0