Change the heading of the page to reflect the tool name
[oota-llvm.git] / docs / CommandGuide / llc.html
1 <html>
2 <title>
3 LLVM: llc tool
4 </title>
5
6 <body>
7
8 <center>
9 <h1>LLVM: llc tool</h1>
10 </center>
11 <HR>
12
13 <h3>
14 NAME
15 </h3>
16
17 llc
18
19 <h3>
20 SYNOPSIS
21 </h3>
22
23 llc [options] &lt; filename&gt;
24 <h3>
25 DESCRIPTION
26 </h3>
27
28 The llc command compiles LLVM bytecode into assembly language for a specified
29 architecture.  The assembly language output can then be passed through a native
30 assembler and linker to generate native code.
31
32 <h3>
33 OPTIONS
34 </h3>
35
36 <ul>
37         <li>-disable-fp-elim     
38         <br>
39         Disable frame pointer elimination optimization
40         <p>
41
42         <li>-disable-local-ra    
43         <br>
44         Use Simple RA instead of Local RegAlloc
45         <p>
46
47         <li>-disable-pattern-isel
48         <br>
49         Use the 'simple' X86 instruction selector
50         <p>
51
52         <li>-disable-peephole    
53         <br>
54         Disable peephole optimization pass
55         <p>
56
57         <li>-disable-preopt      
58         <br>
59         Disable optimizations prior to instruction selection
60         <p>
61
62         <li>-disable-sched       
63         <br>
64         Disable local scheduling pass
65         <p>
66
67         <li>-disable-strip       
68         <br>
69         Do not strip the LLVM bytecode included in executable
70         <p>
71
72         <li>-enable-maps         
73         <br>
74         Emit LLVM-to-MachineCode mapping info to assembly
75         <p>
76
77         <li>-f                   
78         <br>
79         Overwrite output files
80         <p>
81
82         <li>-load=&lt;plugin.so&gt;
83         <br>
84         Load the specified plugin
85         <p>
86
87         <li>-m&lt;arch&gt;
88         <br>
89         Specify the architecture for which to generate assembly.  Valid
90         <p>
91         architectures are:
92
93         <dl compact>
94                 <di> x86               
95                 <dd>
96                 IA-32 (Pentium and above)
97                 <p>
98
99                 <di> sparc             
100                 <dd>SPARC V9
101         </dl>
102         <p>
103
104         <li>-o &lt;filename&gt;
105         <br>
106         Output filename
107         <p>
108
109         <li>-print-machineinstrs 
110         <br>
111         Print generated machine code
112         <p>
113
114         <li> -help
115         <br>
116         Print a summary of command line options.
117         <p>
118
119         <li> -stats
120         <br>
121         Print statistics.
122         <p>
123
124         <li> -time-passes
125         <br>
126         Record the amount of time needed for each pass and print it to standard
127         error.
128         <p>
129 </ul>
130
131 <h3>
132 EXIT STATUS
133 </h3>
134
135 If llc succeeds, it will exit with 0.  Otherwise, if an error occurs, it
136 will exit with a non-zero value.
137
138 <h3>
139 SEE ALSO
140 </h3>
141 llvm-dis, lli
142
143 <HR>
144 <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
145 </body>
146 </html>
147