---
name: "llvm-mc-9"
section: "1"
platform: "linux"
package: "llvm-9"
version: "1:9.0.1-16.1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/llvm-mc-9"
---

# llvm-mc-9(1)

manual page for llvm-mc 9

## NAME

llvm-mc - manual page for llvm-mc 9

## DESCRIPTION

OVERVIEW: llvm machine code playground

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

OPTIONS:

Color Options:

**--color**                                            - Use colors in output (default=autodetect)

General options:

**-I=**\<directory\>                                     - Directory of include files

**--aarch64-neon-syntax=**\<value\>                      - Choose style of NEON code to emit from AArch64 backend:

- \=generic

  \-   Emit generic NEON assembly

- \=apple

  \-   Emit Apple-style NEON assembly

**--amdgpu-disable-loop-alignment**                    - Do not align and prefetch loops

**--amdgpu-disable-power-sched**                       - Disable scheduling to minimize mAI power bursts

**--amdgpu-dpp-combine**                               - Enable DPP combiner

**--amdgpu-dump-hsa-metadata**                         - Dump AMDGPU HSA Metadata

**--amdgpu-enable-global-sgpr-addr**                   - Enable use of SGPR regs for GLOBAL LOAD/STORE instructions

**--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=**\<value\>                          - 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-show-inst**                                    - Emit internal instruction 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

**--compress-debug-sections=**\<value\>                  - Choose DWARF debug sections compression:

- \=none

  \-   No compression

- \=zlib

  \-   Use zlib compression

- \=zlib-gnu

  \-   Use zlib-gnu compression (deprecated)

**--cost-kind=**\<value\>                                - Target cost kind

- \=throughput

  \-   Reciprocal throughput

- \=latency

  \-   Instruction latency

- \=code-size

  \-   Code size

**--cvp-dont-add-nowrap-flags**                        -

**--defsym=**\<string\>                                  - Defines a symbol to be an integer constant

**--disable-promote-alloca-to-lds**                    - Disable promote alloca to LDS

**--disable-promote-alloca-to-vector**                 - Disable promote alloca to vector

-

  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-cse-in-irtranslator**                       - Should enable CSE in irtranslator

**--enable-cse-in-legalizer**                          - Should enable CSE in Legalizer

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

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

**--enable-gvn-memdep**                                -

**--enable-load-pre**                                  -

**--enable-loop-simplifycfg-term-folding**             -

**--enable-name-compression**                          - Enable name string compression

**--expensive-combines**                               - Enable expensive instruction combines

**--fatal-warnings**                                   - Treat warnings as errors

**--fdebug-compilation-dir=**\<string\>                  - Specifies the debug info's compilation dir

**--fdebug-prefix-map=**\<= separated key-value pairs\>  - Map file source paths in debug info

**--filetype=**\<value\>                                 - 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 debugging info for assembly source files

- **--gpsize=**\<uint\> - Global Pointer Addressing 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 incremental linker

**--instcombine-code-sinking**                         - Enable code sinking

**--instcombine-guard-widening-window=**\<uint\>         - How wide an instruction window to bypass looking for another guard

**--instcombine-max-num-phis=**\<uint\>                  - Maximum number phis to handle in intptr/ptrint folding

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

**--instrprof-atomic-counter-update-all**              - Make all profile counter updates atomic (for testing only)

**--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-filter=**\<regex\>                  - Only record optimization remarks from passes whose names match the given regular expression

**--lto-pass-remarks-format=**\<format\>                 - The format used for serializing remarks (default: YAML)

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

**--main-file-name=**\<string\>                          - Specifies the name we should consider the input file

**--masm-integers**                                    - Enable binary and hex masm integers (0b110 and 0ABCh)

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

**--mhvx=**\<value\>                                     - Enable Hexagon Vector eXtensions

- \=v60

  \-   Build for HVX v60

- \=v62

  \-   Build for HVX v62

- \=v65

  \-   Build for HVX v65

- \=v66

  \-   Build for HVX v66

**--mips-compact-branches=**\<value\>                    - 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=**\<filename\>                                      - Output filename

**--output-asm-variant=**\<uint\>                        - Syntax variant to use for output printing

**--pie-copy-relocations**                             - PIE Copy Relocations

**--poison-checking-function-local**                   - Check that returns are non-poison (for testing)

**--position-independent**                             - Position independent

**--preserve-comments**                                - Preserve Comments in outputted assembly

**--print-imm-hex**                                    - Prefer hex format for immediate values

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

**--remarks-section**                                  - Emit a section containing remark diagnostics metadata

**--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-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-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 disallowed unless the promoted counter

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

**--split-dwarf-file=**\<filename\>                      - DWO output filename

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

**--threads=**\<int\>                                    -

**--time-trace-granularity=**\<uint\>                    - Minimum time granularity (in microseconds) traced by time profiler

**--triple=**\<string\>                                  - Target triple to assemble for, see **-version** for available targets

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