Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / llvm / e610cbbaadaa2885bbaaf3fb4680cdadaa5e0891 / . / docs / CommandGuide / llc.html
blob: 36226933f958c05ce8b3a3a5115ecb98e646f4a1 [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>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]98 </dl>
99 <p>
100
101 <li>-o &lt;filename&gt;
102 <br>
John Criswell511a4912003-09-29 20:10:08 +0000[diff] [blame]103 Specify the output filename.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]104 <p>
105
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]106 <li> -help
107 <br>
108 Print a summary of command line options.
109 <p>
110
111 <li> -stats
112 <br>
113 Print statistics.
114 <p>
115
116 <li> -time-passes
117 <br>
118 Record the amount of time needed for each pass and print it to standard
119 error.
120 <p>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]121
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]122</ul>
Chris Lattner7a59bc82003-10-07 19:42:50 +0000[diff] [blame]123<h4>X86 Specific Options</h4>
124<ul>
125 <li>-disable-fp-elim
126 <br>
127 Disable frame pointer elimination optimization.
128 <p>
129
130 <li>-disable-pattern-isel
131 <br>
132 Use the 'simple' X86 instruction selector (the default).
133 <p>
134
135 <li>-print-machineinstrs
136 <br>
137 Print generated machine code.
138 <p>
139
140 <li>-regalloc=&lt;ra&gt;
141 <br>
142 Specify the register allocator to use. The default is <i>simple</i>.
143 Valid register allocators are:
144 <dl compact>
145 <di> simple
146 <dd>Very simple register allocator</dd>
147
148 <di> local
149 <dd>Local register allocator</dd>
150 </dl>
151 <p>
152
153</ul>
154
155<h4>Sparc Specific Options</h4>
156<ul>
157 <li>-disable-peephole
158 <br>
159 Disable peephole optimization pass.
160 <p>
161
162 <li>-disable-preopt
163 <br>
164 Disable optimizations prior to instruction selection.
165 <p>
166
167 <li>-disable-sched
168 <br>
169 Disable local scheduling pass.
170 <p>
171
172 <li>-disable-strip
173 <br>
174 Do not strip the LLVM bytecode included in executable.
175 <p>
176
177 <li>-enable-maps
178 <br>
179 Emit LLVM-to-MachineCode mapping info to assembly.
180 <p>
181</ul>
182
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]183
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]184<h3>EXIT STATUS</h3>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]185
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]186If <tt>llc</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
187it will exit with a non-zero value.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]188
189<h3>
190SEE ALSO
191</h3>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]192<a href="lli.html"><tt>lli</tt></a>
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]193
194<HR>
Chris Lattner08a04fd2003-10-07 20:12:05 +0000[diff] [blame]195Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell69d903d2003-09-12 15:46:24 +0000[diff] [blame]196</body>
197</html>
198