lli-8(1)



LLI(1)                           User Commands                          LLI(1)

NAME
       lli - manual page for lli 8

DESCRIPTION
       OVERVIEW: llvm interpreter & dynamic compiler

       USAGE: lli [options] <input bitcode> <program arguments>...

       OPTIONS:

       Color Options:

       -color                                             - Use colors in out-
              put (default=autodetect)

       General options:

       -O=<char>                                         - Optimization level.
              [-O0, -O1, -O2, or -O3] (default = '-O2')

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

       =generic
              -   Emit generic NEON assembly

       =apple -   Emit Apple-style NEON assembly

       -addrsig                                            -   Emit   an   ad-
              dress-significance table

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

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

       -code-model                                       - Choose code model

       =tiny  -   Tiny code model

       =small -   Small code model

       =kernel
              -   Kernel code model

       =medium
              -   Medium code model

       =large -   Large code model

       -compile-threads=<uint>                            -  Choose the number
              of compile threads (jit-kind=orc-lazy only)

       -cost-kind                                        - Target cost kind

       =throughput
              -   Reciprocal throughput

       =latency
              -   Instruction latency

       =code-size
              -   Code size

       -cvp-dont-process-adds                            -

       -data-sections                                    - Emit data into sep-
              arate sections

       -debugger-tune                                    - Tune debug info for
              a particular debugger

       =gdb   -   gdb

       =lldb  -   lldb

       =sce   -   SCE targets (e.g. PS4)

       -denormal-fp-math                                 - Select which denor-
              mal numbers the code is permitted to require

       =ieee  -   IEEE 754 denormal numbers

       =preserve-sign
              -    the  sign  of a  flushed-to-zero number is preserved in the
              sign of 0

       =positive-zero
              -   denormals are flushed to positive zero

       -disable-lazy-compilation                         -  Disable  JIT  lazy
              compilation

       -disable-promote-alloca-to-lds                    - Disable promote al-
              loca to LDS

       -disable-promote-alloca-to-vector                 - Disable promote al-
              loca to vector

       -disable-tail-calls                                -  Never  emit  tail
              calls

       -do-counter-promotion                             - Do counter register
              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)

       -emulated-tls                                      -  Use  emulated TLS
              model

       -enable-cache-manager                             - Use  cache  manager
              to save/load mdoules

       -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

       -enable-no-infs-fp-math                           - Enable FP math  op-
              timizations that assume no +-Infs

       -enable-no-nans-fp-math                            - Enable FP math op-
              timizations that assume no NaNs

       -enable-no-signed-zeros-fp-math                   - Enable FP math  op-
              timizations that assume the sign of 0 is insignificant

       -enable-no-trapping-fp-math                        - Enable setting the
              FP exceptions build attribute not to use exceptions

       -enable-unsafe-fp-math                             -  Enable  optimiza-
              tions that may decrease FP precision

       -entry-function=<function>                         -  Specify the entry
              function (default = 'main') of the executable

       -exception-model                                  - exception model

       =default
              -   default exception handling model

       =dwarf -   DWARF-like CFI based exception handling

       =sjlj  -   SjLj exception handling

       =arm   -   ARM EHABI exceptions

       =wineh -   Windows exception model

       =wasm  -   WebAssembly exception handling

       -expensive-combines                                -  Enable  expensive
              instruction combines

       -extra-archive=<input archive>                    - Extra archive files
              to be loaded

       -extra-module=<input bitcode>                     - Extra modules to be
              loaded

       -extra-object=<input  object>                      - Extra object files
              to be loaded

       -fake-argv0=<executable>                            -   Override    the
              'argv[0]' value passed into the executing program

       -fatal-warnings                                    -  Treat warnings as
              errors

       -filetype                                         - Choose a file  type
              (not all types are supported by all targets):

       =asm   -   Emit an assembly ('.s') file

       =obj   -   Emit a native object ('.o') file

       =null  -   Emit nothing, for performance testing

       -float-abi                                         -  Choose  float ABI
              type

       =default
              -   Target default float ABI type

       =soft  -   Soft float ABI (implied by -soft-float)

       =hard  -   Hard float ABI (uses FP registers)

       -force-interpreter                                -  Force  interpreta-
              tion: disable JIT

       -fp-contract                                       -  Enable aggressive
              formation of fused FP ops

       =fast  -   Fuse FP ops whenever profitable

       =on    -   Only fuse 'blessed' FP ops.

       =off   -   Only fuse FP ops when the result won't be affected.

       -frame-pointer                                      -   Specify   frame
              pointer elimination optimization

       =all   -   Disable frame pointer elimination

       =non-leaf
              -   Disable frame pointer elimination for non-leaf frame

       =none  -   Enable frame pointer elimination

       -function-sections                                - Emit functions into
              separate sections

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

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

       -jd=<string>                                      - Specifies the  JIT-
              Dylib to be used for any subsequent -extra-module arguments.

       -jit-kind                                          -  Choose underlying
              JIT kind.

       =mcjit
              -   MCJIT

       =orc-mcjit
              -   Orc-based MCJIT replacement

       =orc-lazy
              -   Orc-based lazy JIT.

       -load=<pluginfilename>                            - Load the  specified
              plugin

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

       -march=<string>                                    -  Architecture   to
              generate code for (see --version)

       -mattr=<a1,+a2,-a3,...>                           - Target specific at-
              tributes (-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

       -mcjit-remote-process=<filename>                  - Specify  the  file-
       name of the process to launch for remote MCJIT execution.
              If  none  is  specified,  remote  execution  will  be  simulated
              in-process.

       -mcpu=<cpu-name>                                  - Target  a  specific
              cpu type (-mcpu=help for details)

       -meabi                                             - Set EABI type (de-
              fault depends on triple):

       =default
              -   Triple default EABI version

       =4     -   EABI version 4

       =5     -   EABI version 5

       =gnu   -   EABI GNU

       -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 Vec-
              tor 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: Com-
              pact 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

       -mtriple=<string>                                  -  Override   target
              triple for module

       -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

       -no-deprecated-warn                               - Suppress all depre-
              cated warnings

       -no-discriminators                                 - Disable generation
              of discriminator information.

       -no-warn                                          - Suppress all  warn-
              ings

       -nozero-initialized-in-bss                           -    Don't   place
              zero-initialized symbols into bss section

       -nvptx-sched4reg                                   -  NVPTX   Specific:
              schedule for register pressue

       -object-cache-dir=<string>                         - Directory to store
              cached object files (must be user writable)

       -per-module-lazy                                  - Performs lazy  com-
              pilation on whole module boundaries rather than individual func-
              tions

       -pie-copy-relocations                             -  PIE  Copy  Reloca-
              tions

       -r600-ir-structurize                               - Use StructurizeCFG
              IR pass

       -rdf-dump                                         -

       -rdf-limit=<uint>                                 -

       -relax-elf-relocations                               -    Emit     GOT-
              PCRELX/REX_GOTPCRELX instead of GOTPCREL on x86-64 ELF

       -relocation-model                                  -  Choose relocation
              model

       =static
              -   Non-relocatable code

       =pic   -   Fully relocatable, position independent code

       =dynamic-no-pic
              -   Relocatable external references, non-relocatable code

       =ropi  -   Code and read-only data relocatable, accessed PC-relative

       =rwpi  -   Read-write data relocatable,  accessed  relative  to  static
              base

       =ropi-rwpi
              -   Combination of ropi and rwpi

       -remote-mcjit                                      -  Execute  MCJIT'ed
              code in a separate process.

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

       -soft-float                                       -  Generate  software
              floating point library calls

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

       -stack-alignment=<uint>                            -  Override  default
              stack alignment

       -stack-size-section                               - Emit a section con-
              taining stack size metadata

       -stack-symbol-ordering                             -  Order local stack
              symbols.

       -stackrealign                                      -  Force  align  the
              stack to the minimum alignment

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

       -tailcallopt                                      - Turn  fastcc  calls
              into tail calls by (potentially) changing ABI.

       -thread-entry=<string>                            - calls the given en-
              try-point on a new thread (jit-kind=orc-lazy only)

       -thread-model                                      -  Choose  threading
              model

       =posix
              -   POSIX thread model

       =single
              -   Single thread model

       -threads=<int>                                    -

       -unique-section-names                              -  Give unique names
              to every section

       -use-ctors                                        - Use .ctors  instead
              of .init_array.

       -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

lli 8                             March 2020                            LLI(1)

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