blob: 4c22a9934a5743a7d28a69161abb2272dfe5d265 [file] [log] [blame]
John Criswellecf32e52003-09-11 19:58:03 +00001<html>
Chris Lattner537a02c2003-10-07 20:01:09 +00002<title>LLVM: gccas tool</title>
John Criswellecf32e52003-09-11 19:58:03 +00003
Chris Lattner08a04fd2003-10-07 20:12:05 +00004<body bgcolor=white>
John Criswellecf32e52003-09-11 19:58:03 +00005
6<center>
Chris Lattner537a02c2003-10-07 20:01:09 +00007<h1>LLVM: <tt>gccas</tt> tool</h1>
John Criswellecf32e52003-09-11 19:58:03 +00008</center>
9<HR>
10
Chris Lattner537a02c2003-10-07 20:01:09 +000011<h3>NAME</h3>
12<tt>gccas</tt>
John Criswellecf32e52003-09-11 19:58:03 +000013
Chris Lattner537a02c2003-10-07 20:01:09 +000014<h3>SYNOPSIS</h3>
15<tt>gccas [options] &lt; filename&gt;</tt>
John Criswellecf32e52003-09-11 19:58:03 +000016
Chris Lattner537a02c2003-10-07 20:01:09 +000017<h3>DESCRIPTION</h3>
John Criswellecf32e52003-09-11 19:58:03 +000018
Chris Lattner537a02c2003-10-07 20:01:09 +000019The <tt>gccas</tt> utility takes an LLVM assembly file generated by the <a
20href="llvmgcc.html">C</a> or <a href="llvmgxx.html">C++</a> frontends and
21converts it into an LLVM bytecode file. It is primarily used by the GCC front
22end, and as such, attempts to mimic the interface provided by the default system
23assembler so that it can act as a "drop-in" replacement.<p>
John Criswellecf32e52003-09-11 19:58:03 +000024
Chris Lattner537a02c2003-10-07 20:01:09 +000025<tt>gccas</tt> performs a number of optimizations on the input program.<p>
John Criswellecf32e52003-09-11 19:58:03 +000026
27<h3>
28OPTIONS
29</h3>
30
31<ul>
32 <li> -help
33 <br>
34 Print a summary of command line options.
35 <p>
36
37 <li> -o &lt;filename&gt;
38 <br>
39 Specify the output filename which will hold the assembled bytecode.
40 <p>
41
John Criswell3beefec2003-10-16 20:05:48 +000042 <li>-disable-inlining
43 <br>
44 Disable the inlining pass. By default, it is enabled.
45 <p>
46
John Criswell84171422004-03-12 22:45:35 +000047 <li> -disable-opt
48 <br>
49 Disable all assemble-time optimization passes.
50 <p>
51
John Criswellecf32e52003-09-11 19:58:03 +000052 <li> -stats
53 <br>
54 Print statistics.
55 <p>
56
57 <li> -time-passes
58 <br>
59 Record the amount of time needed for each pass and print it to standard
60 error.
61 <p>
62
63 <li> -verify
64 <br>
65 Verify each pass result.
66 <p>
67</ul>
68
69<h3>
70EXIT STATUS
71</h3>
72
Chris Lattner537a02c2003-10-07 20:01:09 +000073If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
74it will exit with a non-zero value.
John Criswellecf32e52003-09-11 19:58:03 +000075
Chris Lattner537a02c2003-10-07 20:01:09 +000076<h3>SEE ALSO</h3>
77<a href="llvm-as.html"><tt>llvm-as</tt></a>
78<a href="gccld.html"><tt>gccld</tt></a>
John Criswellecf32e52003-09-11 19:58:03 +000079
80<HR>
Chris Lattner08a04fd2003-10-07 20:12:05 +000081Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswellecf32e52003-09-11 19:58:03 +000082</body>
83</html>
84