usr.bin/clang/lli/lli.1

   1 .\" $FreeBSD$
   2 .TH "LLI" "1" "2012-08-16" "3.2" "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=\fIpuginfilename\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 .sp
 189 .nf
 190 .ft C
 191 default: Target default code model
 192 small: Small code model
 193 kernel: Kernel code model
 194 medium: Medium code model
 195 large: Large code model
 196 .ft P
 197 .fi
 198 .UNINDENT
 199 .UNINDENT
 200 .sp
 201 \fB\-disable\-post\-RA\-scheduler\fP
 202 .INDENT 0.0
 203 .INDENT 3.5
 204 Disable scheduling after register allocation.
 205 .UNINDENT
 206 .UNINDENT
 207 .sp
 208 \fB\-disable\-spill\-fusing\fP
 209 .INDENT 0.0
 210 .INDENT 3.5
 211 Disable fusing of spill code into instructions.
 212 .UNINDENT
 213 .UNINDENT
 214 .sp
 215 \fB\-enable\-correct\-eh\-support\fP
 216 .INDENT 0.0
 217 .INDENT 3.5
 218 Make the \-lowerinvoke pass insert expensive, but correct, EH code.
 219 .UNINDENT
 220 .UNINDENT
 221 .sp
 222 \fB\-jit\-enable\-eh\fP
 223 .INDENT 0.0
 224 .INDENT 3.5
 225 Exception handling should be enabled in the just\-in\-time compiler.
 226 .UNINDENT
 227 .UNINDENT
 228 .sp
 229 \fB\-join\-liveintervals\fP
 230 .INDENT 0.0
 231 .INDENT 3.5
 232 Coalesce copies (default=true).
 233 .UNINDENT
 234 .UNINDENT
 235 .sp
 236 \fB\-nozero\-initialized\-in\-bss\fP Don\(aqt place zero\-initialized symbols into the BSS section.
 237 .sp
 238 \fB\-pre\-RA\-sched\fP=\fIscheduler\fP
 239 .INDENT 0.0
 240 .INDENT 3.5
 241 Instruction schedulers available (before register allocation):
 242 .sp
 243 .nf
 244 .ft C
 245 =default: Best scheduler for the target
 246 =none: No scheduling: breadth first sequencing
 247 =simple: Simple two pass scheduling: minimize critical path and maximize processor utilization
 248 =simple\-noitin: Simple two pass scheduling: Same as simple except using generic latency
 249 =list\-burr: Bottom\-up register reduction list scheduling
 250 =list\-tdrr: Top\-down register reduction list scheduling
 251 =list\-td: Top\-down list scheduler \-print\-machineinstrs \- Print generated machine code
 252 .ft P
 253 .fi
 254 .UNINDENT
 255 .UNINDENT
 256 .sp
 257 \fB\-regalloc\fP=\fIallocator\fP
 258 .INDENT 0.0
 259 .INDENT 3.5
 260 Register allocator to use (default=linearscan)
 261 .sp
 262 .nf
 263 .ft C
 264 =bigblock: Big\-block register allocator
 265 =linearscan: linear scan register allocator =local \-   local register allocator
 266 =simple: simple register allocator
 267 .ft P
 268 .fi
 269 .UNINDENT
 270 .UNINDENT
 271 .sp
 272 \fB\-relocation\-model\fP=\fImodel\fP
 273 .INDENT 0.0
 274 .INDENT 3.5
 275 Choose relocation model from:
 276 .sp
 277 .nf
 278 .ft C
 279 =default: Target default relocation model
 280 =static: Non\-relocatable code =pic \-   Fully relocatable, position independent code
 281 =dynamic\-no\-pic: Relocatable external references, non\-relocatable code
 282 .ft P
 283 .fi
 284 .UNINDENT
 285 .UNINDENT
 286 .sp
 287 \fB\-spiller\fP
 288 .INDENT 0.0
 289 .INDENT 3.5
 290 Spiller to use (default=local)
 291 .sp
 292 .nf
 293 .ft C
 294 =simple: simple spiller
 295 =local: local spiller
 296 .ft P
 297 .fi
 298 .UNINDENT
 299 .UNINDENT
 300 .sp
 301 \fB\-x86\-asm\-syntax\fP=\fIsyntax\fP
 302 .INDENT 0.0
 303 .INDENT 3.5
 304 Choose style of code to emit from X86 backend:
 305 .sp
 306 .nf
 307 .ft C
 308 =att: Emit AT&T\-style assembly
 309 =intel: Emit Intel\-style assembly
 310 .ft P
 311 .fi
 312 .UNINDENT
 313 .UNINDENT
 314 .SH EXIT STATUS
 315 .sp
 316 If \fBlli\fP fails to load the program, it will exit with an exit code of 1.
 317 Otherwise, it will return the exit code of the program it executes.
 318 .SH SEE ALSO
 319 .sp
 320 llc|llc
 321 .SH AUTHOR
 322 Maintained by The LLVM Team (http://llvm.org/).
 323 .SH COPYRIGHT
 324 2012, LLVM Project
 325 .\" Generated by docutils manpage writer.
 326 .