usr.bin/clang/lli/lli.1

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