Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / llvm / 53d91b23a6ab629e5b9f77d993ff4839f39f5047 / . / docs / CommandGuide / llc.html
blob: 3a1efd1df114b2fcefdccdf009b2e40e1c971704 [file] [log] [blame]
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]1<html>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]2<title>LLVM: llc tool</title>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]3
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]4<body bgcolor=white>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]5
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]6<center><h1>LLVM: <tt>llc</tt> tool</h1></center>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]7<HR>
8
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]9<h3>NAME</h3>
10<tt>llc</tt>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]11
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]12<h3>SYNOPSIS</h3>
13<tt>llc [options] [filename]</tt>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]14
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]15<h3>DESCRIPTION</h3>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]16
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]17The <tt>llc</tt> command compiles LLVM bytecode into assembly language for a
18specified architecture. The assembly language output can then be passed through
19a native assembler and linker to generate native code.
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]20<p>
21The choice of architecture for the output assembly code is determined as
22follows:
23
24<ul>
25 <li>
26 If the user has specified an architecture with the -m option, use that
27 architecture.
28 <p>
29
30 <li>
31 Examine the input LLVM bytecode file:
32 <ul>
33 <li>
34 If it specifies little endian and a pointer size of 32 bits, select the
35 x86 architecture.
36 <p>
37
38 <li>
39 If it specifies big endian and a pointer size of 64 bit pointers,
40 select the SparcV9 architecture.
41 </ul>
42 <p>
43
44 <li>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]45 If <tt>llc</tt> was compiled on an architecture for which it can
46 generate code, select the architecture upon which <tt>llc</tt> was
47 compiled.
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]48 <p>
49
50 <li>
51 Print a message to the user asking him or her to specify the output
52 architecture explicitly.
53</ul>
54
55<p>
56
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]57If filename is not specified, or if filename is -, <tt>llc</tt> reads its input
58from standard input. Otherwise, it will read its input from filename.
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]59<p>
60
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]61If the -o option is left unspecified, then <tt>llc</tt> will send its output to standard
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]62output if the input is from standard input. If the -o option specifies -, then
63the output will also be sent to standard output.
64<p>
65
66If no -o option is specified and an input file other than - is specified, then
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]67<tt>llc</tt> creates the output filename as follows:
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]68
69<ul>
70 <li>
71 If the file ends in .bc, then the .bc suffix is removed, and the .s suffix
72 is appended.
73 <p>
74 <li>
75 Otherwise, the .s suffix is appended to the input filename.
76</ul>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]77
78<h3>
79OPTIONS
80</h3>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]81<ul>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]82 <li>-f
83 <br>
84 Overwrite output files
85 <p>
86
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]87 <li>-m&lt;arch&gt;
88 <br>
89 Specify the architecture for which to generate assembly. Valid
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]90 architectures are:
91
92 <dl compact>
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]93 <dt> x86 </dt>
Alkis Evlogimenoseed462b2003-10-02 06:13:19 +0000[diff] [blame]94 <dd>IA-32 (Pentium and above)</dd>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]95
John Criswell84171422004-03-12 22:45:35 +0000[diff] [blame]96 <dt> sparcv9 </dt>
Alkis Evlogimenoseed462b2003-10-02 06:13:19 +0000[diff] [blame]97 <dd>SPARC V9</dd>
Chris Lattner15a29862004-02-18 23:30:02 +0000[diff] [blame]98
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]99 <dt> c </dt>
Chris Lattner15a29862004-02-18 23:30:02 +0000[diff] [blame]100 <dd>Emit C code</dd>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]101 </dl>
102 <p>
103
104 <li>-o &lt;filename&gt;
105 <br>
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]106 Specify the output filename.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]107 <p>
108
John Criswell84171422004-03-12 22:45:35 +0000[diff] [blame]109 <li>-enable-correct-eh-support
110 <br>
111 Instruct the -lowerinvoke pass to insert code for correct exception handling
112 support. This is expensive and is by default omitted for efficiency.
113 <p>
114
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]115 <li> -help
116 <br>
117 Print a summary of command line options.
118 <p>
119
120 <li> -stats
121 <br>
122 Print statistics.
123 <p>
124
125 <li> -time-passes
126 <br>
127 Record the amount of time needed for each pass and print it to standard
128 error.
129 <p>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]130
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]131</ul>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]132<h4>X86 Specific Options</h4>
133<ul>
134 <li>-disable-fp-elim
135 <br>
136 Disable frame pointer elimination optimization.
137 <p>
138
139 <li>-disable-pattern-isel
140 <br>
141 Use the 'simple' X86 instruction selector (the default).
142 <p>
143
144 <li>-print-machineinstrs
145 <br>
146 Print generated machine code.
147 <p>
148
149 <li>-regalloc=&lt;ra&gt;
150 <br>
Alkis Evlogimenos4e644dd2004-03-06 22:27:41 +0000[diff] [blame]151 Specify the register allocator to use. The default is <i>local</i>.
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]152 Valid register allocators are:
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]153 <p>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]154 <dl compact>
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]155 <dt> simple </dt>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]156 <dd>Very simple register allocator</dd>
157
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]158 <dt> local </dt>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]159 <dd>Local register allocator</dd>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame]160
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]161 <dt> linearscan </dt>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame]162 <dd>Linear scan global register allocator (experimental)</dd>
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]163 </dl>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame]164
165 <li>-spiller=&lt;sp&gt;
166 <br>
167 Specify the spiller to use for register allocators that support it.
168 Currently this option is used by the linear scan register
169 allocator. The default is <i>local</i>.
170 Valid spillers are:
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]171 <p>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame]172 <dl compact>
Alkis Evlogimenos499b2ba2004-03-06 22:38:29 +0000[diff] [blame]173 <dt> simple </dt>
174 <dd>Simple spiller</dd>
175
Alkis Evlogimenos89157a22004-03-02 03:36:10 +0000[diff] [blame]176 <dt> local </dt>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame]177 <dd>Local spiller</dd>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]178 </dl>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]179
180</ul>
181
182<h4>Sparc Specific Options</h4>
183<ul>
184 <li>-disable-peephole
185 <br>
186 Disable peephole optimization pass.
187 <p>
188
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]189 <li>-disable-sched
190 <br>
191 Disable local scheduling pass.
192 <p>
193
194 <li>-disable-strip
195 <br>
196 Do not strip the LLVM bytecode included in executable.
197 <p>
198
199 <li>-enable-maps
200 <br>
201 Emit LLVM-to-MachineCode mapping info to assembly.
202 <p>
203</ul>
204
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]205
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]206<h3>EXIT STATUS</h3>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]207
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]208If <tt>llc</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
209it will exit with a non-zero value.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]210
211<h3>
212SEE ALSO
213</h3>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]214<a href="lli.html"><tt>lli</tt></a>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]215
216<HR>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]217Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]218</body>
219</html>
220