Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / llvm / dd420e060accd1d773c731e77335cff65ca34013 / . / docs / CommandGuide / llc.html
blob: 4583b11fc60b339b4852feb6d2a78e0e12b84c2c [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 Evlogimenoseed462b2003-10-02 06:13:19 +0000[diff] [blame]93 <di> x86
94 <dd>IA-32 (Pentium and above)</dd>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]95
Alkis Evlogimenoseed462b2003-10-02 06:13:19 +0000[diff] [blame]96 <di> sparc
97 <dd>SPARC V9</dd>
Chris Lattner15a29862004-02-18 23:30:02 +0000[diff] [blame]98
99 <di> c
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 Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]109 <li> -help
110 <br>
111 Print a summary of command line options.
112 <p>
113
114 <li> -stats
115 <br>
116 Print statistics.
117 <p>
118
119 <li> -time-passes
120 <br>
121 Record the amount of time needed for each pass and print it to standard
122 error.
123 <p>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]124
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]125</ul>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]126<h4>X86 Specific Options</h4>
127<ul>
128 <li>-disable-fp-elim
129 <br>
130 Disable frame pointer elimination optimization.
131 <p>
132
133 <li>-disable-pattern-isel
134 <br>
135 Use the 'simple' X86 instruction selector (the default).
136 <p>
137
138 <li>-print-machineinstrs
139 <br>
140 Print generated machine code.
141 <p>
142
143 <li>-regalloc=&lt;ra&gt;
144 <br>
145 Specify the register allocator to use. The default is <i>simple</i>.
146 Valid register allocators are:
147 <dl compact>
148 <di> simple
149 <dd>Very simple register allocator</dd>
150
151 <di> local
152 <dd>Local register allocator</dd>
Alkis Evlogimenosdd420e02004-03-01 23:18:15 +0000[diff] [blame^]153
154 <di> linearscan
155 <dd>Linear scan global register allocator (experimental)</dd>
156
157 <li>-spiller=&lt;sp&gt;
158 <br>
159 Specify the spiller to use for register allocators that support it.
160 Currently this option is used by the linear scan register
161 allocator. The default is <i>local</i>.
162 Valid spillers are:
163 <dl compact>
164 <di> local
165 <dd>Local spiller</dd>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]166 </dl>
167 <p>
168
169</ul>
170
171<h4>Sparc Specific Options</h4>
172<ul>
173 <li>-disable-peephole
174 <br>
175 Disable peephole optimization pass.
176 <p>
177
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]178 <li>-disable-sched
179 <br>
180 Disable local scheduling pass.
181 <p>
182
183 <li>-disable-strip
184 <br>
185 Do not strip the LLVM bytecode included in executable.
186 <p>
187
188 <li>-enable-maps
189 <br>
190 Emit LLVM-to-MachineCode mapping info to assembly.
191 <p>
192</ul>
193
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]194
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]195<h3>EXIT STATUS</h3>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]196
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]197If <tt>llc</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
198it will exit with a non-zero value.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]199
200<h3>
201SEE ALSO
202</h3>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]203<a href="lli.html"><tt>lli</tt></a>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]204
205<HR>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]206Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]207</body>
208</html>
209