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 **-jit-enable-eh** 194 195 Exception handling should be enabled in the just-in-time compiler. 196 197 198 199 **-join-liveintervals** 200 201 Coalesce copies (default=true). 202 203 204 205 **-nozero-initialized-in-bss** Don't place zero-initialized symbols into the BSS section. 206 207 208 209 **-pre-RA-sched**\ =\ *scheduler* 210 211 Instruction schedulers available (before register allocation): 212 213 214 .. code-block:: perl 215 216 =default: Best scheduler for the target 217 =none: No scheduling: breadth first sequencing 218 =simple: Simple two pass scheduling: minimize critical path and maximize processor utilization 219 =simple-noitin: Simple two pass scheduling: Same as simple except using generic latency 220 =list-burr: Bottom-up register reduction list scheduling 221 =list-tdrr: Top-down register reduction list scheduling 222 =list-td: Top-down list scheduler -print-machineinstrs - Print generated machine code 223 224 225 226 227 **-regalloc**\ =\ *allocator* 228 229 Register allocator to use (default=linearscan) 230 231 232 .. code-block:: perl 233 234 =bigblock: Big-block register allocator 235 =linearscan: linear scan register allocator =local - local register allocator 236 =simple: simple register allocator 237 238 239 240 241 **-relocation-model**\ =\ *model* 242 243 Choose relocation model from: 244 245 246 .. code-block:: perl 247 248 =default: Target default relocation model 249 =static: Non-relocatable code =pic - Fully relocatable, position independent code 250 =dynamic-no-pic: Relocatable external references, non-relocatable code 251 252 253 254 255 **-spiller** 256 257 Spiller to use (default=local) 258 259 260 .. code-block:: perl 261 262 =simple: simple spiller 263 =local: local spiller 264 265 266 267 268 **-x86-asm-syntax**\ =\ *syntax* 269 270 Choose style of code to emit from X86 backend: 271 272 273 .. code-block:: perl 274 275 =att: Emit AT&T-style assembly 276 =intel: Emit Intel-style assembly 277 278 279 280 281 282 EXIT STATUS 283 ----------- 284 285 286 If **lli** fails to load the program, it will exit with an exit code of 1. 287 Otherwise, it will return the exit code of the program it executes. 288 289 290 SEE ALSO 291 -------- 292 293 294 llc|llc 295
