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**\ =\ *puginfilename* 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 301
