Provided by: llvm-8_8.0.1-9_amd64 bug

NAME

       llvm-mc - manual page for llvm-mc 8

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                               -  Choose  style  of  NEON  code  to emit from AArch64
              backend:

       =generic
              -   Emit generic NEON assembly

       =apple -   Emit Apple-style NEON assembly

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

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

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

       =v60   -   Build for HVX v60

       =v62   -   Build for HVX v62

       =v65   -   Build for HVX v65

       =v66   -   Build for HVX v66

       =      -

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

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

       -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