llvm-mc-9(1)



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

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 out-
              put (default=autodetect)

       General options:

       -I=<directory>                                     - Directory  of  in-
              clude 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  com-
              biner

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

       --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 as-
              semble 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  in-
              struction 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 disassem-
              bly of strings of hex bytes

       --do-counter-promotion                              - Do counter regis-
              ter promotion

       --dwarf-version=<int>                              - Dwarf version

       --emscripten-cxx-exceptions-whitelist=<string>     - The list of  func-
              tion  names  in which Emscripten-style exception handling is en-
              abled (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  Em-
              scripten-style exception handling

       --enable-emscripten-sjlj                            -  WebAssembly  Em-
              scripten-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 de-
              bug 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 de-
              bugging info for assembly source files

       --gpsize=<uint>                                    - Global Pointer Ad-
       dressing 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 exter-
              nal functions in index.

       --incremental-linker-compatible                     -  When  used  with
              filetype=obj,  emit an object file which can be used with an in-
              cremental linker

       --instcombine-code-sinking                         - Enable code  sink-
              ing

       --instcombine-guard-widening-window=<uint>          -  How  wide an in-
              struction 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 pro-
              motion across the whole loop nest.

       --large-code-model                                 - Create cfi  direc-
              tives that assume the code might be more than 2gb away

       --lto-pass-remarks-filter=<regex>                   - Only record opti-
              mization 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  al-
              lowed 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  dis-
              ables 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 con-
              stant 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 pre-
              cision 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 mismatch-
              ing a signed and unsigned value

       -n                                                  -  Don't assume as-
              sembly file starts in the text section

       --no-deprecated-warn                               - Suppress all  dep-
              recated warnings

       --no-discriminators                                - Disable generation
              of discriminator information.

       --no-exec-stack                                    - File doesn't  need
              an exec stack

       --no-warn                                          - Suppress all warn-
              ings

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

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

       --position-independent                             - Position  indepen-
              dent

       --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_GOT-
              PCRELX 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 tem-
              porary labels

       --show-encoding                                     -  Show instruction
              encodings

       --show-inst                                        - Show internal  in-
              struction 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  disal-
       lowed unless the promoted counter
              update  can be further/iteratively promoted into an acyclic  re-
              gion.

       --split-dwarf-file=<filename>                      - DWO  output  file-
              name

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

       --threads=<int>                                    -

       --time-trace-granularity=<uint>                    - Minimum time gran-
              ularity (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 ver-
              sion of this program

llvm-mc 9                        October 2020                       LLVM-MC(1)

Man(1) output converted with man2html
list of all man pages