Provided by: llvm-5.0_5.0-3~16.04.1_amd64 bug

NAME

       llvm-mc - manual page for llvm-mc 5.0

DESCRIPTION

       OVERVIEW: llvm machine code playground

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

       OPTIONS:

       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-dump-comd                                 - Dump AMDGPU Code Object 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-comd                               - Verify AMDGPU Code Object 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

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

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

       =predicateinfo-rename
              -   Controls which variables are renamed with predicateinfo

       =newgvn-vn
              -   Controls which instructions are value numbered

       =newgvn-phi
              -   Controls which instructions we create phi of ops for

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

       -do-counter-promotion                             - Do counter register promotion

       -dwarf-version=<int>                              - 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-packed-inlinable-literals                  -  Enable  packed  inlinable   literals
              (v2f16, v2i16)

       -enable-scoped-noalias                            -

       -enable-si-insert-waitcnts                        - Use new waitcnt insertion pass

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

       -filter-print-funcs=<function names>              - 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=<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

       -imp-null-check-page-size=<int>                   - The page size of the target in bytes

       -imp-null-max-insts-to-consider=<uint>            - 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

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

       -join-liveintervals                               - Coalesce copies (default=true)

       -limit-float-precision=<uint>                        -   Generate   low-precision   inline
              sequences for some float libcalls

       -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

       -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=<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-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=<pass-name>                  - Print machine instrs

       -r600-ir-structurize                              - Use StructurizeCFG IR pass

       -rdf-dump                                         -

       -rdf-limit=<uint>                                 -

       -regalloc                                         - Register allocator to use

       =pbqp  -   PBQP register allocator

       =greedy
              -   greedy register allocator

       =fast  -   fast register allocator

       =basic -   basic register allocator

       =default
              -   pick register allocator based on -O option

       -relax-relocations                                -  Emit  R_X86_64_GOTPCRELX  instead  of
              R_X86_64_GOTPCREL

       -rewrite-map-file=<filename>                      - Symbol Rewrite Map

       -rng-seed=<seed>                                  - Seed for the random number generator

       -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

       -simplify-mir                                     - Leave out unnecessary information when
              printing MIR

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

       -stackmap-version=<int>                           - Specify the stackmap encoding  version
              (default = 3)

       -static-func-full-module-prefix                    -  Use  full  module build paths in the
              profile counter names for static functions.

       -static-func-strip-dirname-prefix=<uint>          - Strip  specified  level  of  directory
              name from source path in the profile counter name for static functions.

       -stats                                             - Enable statistics output from program
              (available with Asserts)

       -stats-json                                       - Display statistics as json data

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

       -threads=<int>                                    -

       -time-passes                                       - Time each pass, printing elapsed time
              for each on exit

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