docs/CommandGuide/lli.rst

   1 lli - directly execute programs from LLVM bitcode
   2 =================================================
   3
   4
   5 SYNOPSIS
   6 --------
   7
   8
   9 **lli** [*options*] [*filename*] [*program args*]
  10
  11
  12 DESCRIPTION
  13 -----------
  14
  15
  16 **lli** directly executes programs in LLVM bitcode format.  It takes a program
  17 in LLVM bitcode format and executes it using a just-in-time compiler, if one is
  18 available for the current architecture, or an interpreter.  **lli** takes all of
  19 the same code generator options as llc|llc, but they are only effective when
  20 **lli** is using the just-in-time compiler.
  21
  22 If *filename* is not specified, then **lli** reads the LLVM bitcode for the
  23 program from standard input.
  24
  25 The optional *args* specified on the command line are passed to the program as
  26 arguments.
  27
  28
  29 GENERAL OPTIONS
  30 ---------------
  31
  32
  33
  34 **-fake-argv0**\ =\ *executable*
  35
  36  Override the ``argv[0]`` value passed into the executing program.
  37
  38
  39
  40 **-force-interpreter**\ =\ *{false,true}*
  41
  42  If set to true, use the interpreter even if a just-in-time compiler is available
  43  for this architecture. Defaults to false.
  44
  45
  46
  47 **-help**
  48
  49  Print a summary of command line options.
  50
  51
  52
  53 **-load**\ =\ *pluginfilename*
  54
  55  Causes **lli** to load the plugin (shared object) named *pluginfilename* and use
  56  it for optimization.
  57
  58
  59
  60 **-stats**
  61
  62  Print statistics from the code-generation passes. This is only meaningful for
  63  the just-in-time compiler, at present.
  64
  65
  66
  67 **-time-passes**
  68
  69  Record the amount of time needed for each code-generation pass and print it to
  70  standard error.
  71
  72
  73
  74 **-version**
  75
  76  Print out the version of **lli** and exit without doing anything else.
  77
  78
  79
  80
  81 TARGET OPTIONS
  82 --------------
  83
  84
  85
  86 **-mtriple**\ =\ *target triple*
  87
  88  Override the target triple specified in the input bitcode file with the
  89  specified string.  This may result in a crash if you pick an
  90  architecture which is not compatible with the current system.
  91
  92
  93
  94 **-march**\ =\ *arch*
  95
  96  Specify the architecture for which to generate assembly, overriding the target
  97  encoded in the bitcode file.  See the output of **llc -help** for a list of
  98  valid architectures.  By default this is inferred from the target triple or
  99  autodetected to the current architecture.
 100
 101
 102
 103 **-mcpu**\ =\ *cpuname*
 104
 105  Specify a specific chip in the current architecture to generate code for.
 106  By default this is inferred from the target triple and autodetected to
 107  the current architecture.  For a list of available CPUs, use:
 108  **llvm-as < /dev/null | llc -march=xyz -mcpu=help**
 109
 110
 111
 112 **-mattr**\ =\ *a1,+a2,-a3,...*
 113
 114  Override or control specific attributes of the target, such as whether SIMD
 115  operations are enabled or not.  The default set of attributes is set by the
 116  current CPU.  For a list of available attributes, use:
 117  **llvm-as < /dev/null | llc -march=xyz -mattr=help**
 118
 119
 120
 121
 122 FLOATING POINT OPTIONS
 123 ----------------------
 124
 125
 126
 127 **-disable-excess-fp-precision**
 128
 129  Disable optimizations that may increase floating point precision.
 130
 131
 132
 133 **-enable-no-infs-fp-math**
 134
 135  Enable optimizations that assume no Inf values.
 136
 137
 138
 139 **-enable-no-nans-fp-math**
 140
 141  Enable optimizations that assume no NAN values.
 142
 143
 144
 145 **-enable-unsafe-fp-math**
 146
 147  Causes **lli** to enable optimizations that may decrease floating point
 148  precision.
 149
 150
 151
 152 **-soft-float**
 153
 154  Causes **lli** to generate software floating point library calls instead of
 155  equivalent hardware instructions.
 156
 157
 158
 159
 160 CODE GENERATION OPTIONS
 161 -----------------------
 162
 163
 164
 165 **-code-model**\ =\ *model*
 166
 167  Choose the code model from:
 168
 169
 170  .. code-block:: perl
 171
 172       default: Target default code model
 173       small: Small code model
 174       kernel: Kernel code model
 175       medium: Medium code model
 176       large: Large code model
 177
 178
 179
 180
 181 **-disable-post-RA-scheduler**
 182
 183  Disable scheduling after register allocation.
 184
 185
 186
 187 **-disable-spill-fusing**
 188
 189  Disable fusing of spill code into instructions.
 190
 191
 192
 193 **-enable-correct-eh-support**
 194
 195  Make the -lowerinvoke pass insert expensive, but correct, EH code.
 196
 197
 198
 199 **-jit-enable-eh**
 200
 201  Exception handling should be enabled in the just-in-time compiler.
 202
 203
 204
 205 **-join-liveintervals**
 206
 207  Coalesce copies (default=true).
 208
 209
 210
 211 **-nozero-initialized-in-bss** Don't place zero-initialized symbols into the BSS section.
 212
 213
 214
 215 **-pre-RA-sched**\ =\ *scheduler*
 216
 217  Instruction schedulers available (before register allocation):
 218
 219
 220  .. code-block:: perl
 221
 222       =default: Best scheduler for the target
 223       =none: No scheduling: breadth first sequencing
 224       =simple: Simple two pass scheduling: minimize critical path and maximize processor utilization
 225       =simple-noitin: Simple two pass scheduling: Same as simple except using generic latency
 226       =list-burr: Bottom-up register reduction list scheduling
 227       =list-tdrr: Top-down register reduction list scheduling
 228       =list-td: Top-down list scheduler -print-machineinstrs - Print generated machine code
 229
 230
 231
 232
 233 **-regalloc**\ =\ *allocator*
 234
 235  Register allocator to use (default=linearscan)
 236
 237
 238  .. code-block:: perl
 239
 240       =bigblock: Big-block register allocator
 241       =linearscan: linear scan register allocator =local -   local register allocator
 242       =simple: simple register allocator
 243
 244
 245
 246
 247 **-relocation-model**\ =\ *model*
 248
 249  Choose relocation model from:
 250
 251
 252  .. code-block:: perl
 253
 254       =default: Target default relocation model
 255       =static: Non-relocatable code =pic -   Fully relocatable, position independent code
 256       =dynamic-no-pic: Relocatable external references, non-relocatable code
 257
 258
 259
 260
 261 **-spiller**
 262
 263  Spiller to use (default=local)
 264
 265
 266  .. code-block:: perl
 267
 268       =simple: simple spiller
 269       =local: local spiller
 270
 271
 272
 273
 274 **-x86-asm-syntax**\ =\ *syntax*
 275
 276  Choose style of code to emit from X86 backend:
 277
 278
 279  .. code-block:: perl
 280
 281       =att: Emit AT&T-style assembly
 282       =intel: Emit Intel-style assembly
 283
 284
 285
 286
 287
 288 EXIT STATUS
 289 -----------
 290
 291
 292 If **lli** fails to load the program, it will exit with an exit code of 1.
 293 Otherwise, it will return the exit code of the program it executes.
 294
 295
 296 SEE ALSO
 297 --------
 298
 299
 300 llc|llc