blob: a0bafcc82063c20c49191168d1d5d7753046f88c [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 Criswellecf32e52003-09-11 19:58:03 +000047 <li> -stats
48 <br>
49 Print statistics.
50 <p>
51
52 <li> -time-passes
53 <br>
54 Record the amount of time needed for each pass and print it to standard
55 error.
56 <p>
57
58 <li> -verify
59 <br>
60 Verify each pass result.
61 <p>
62</ul>
63
64<h3>
65EXIT STATUS
66</h3>
67
Chris Lattner537a02c2003-10-07 20:01:09 +000068If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
69it will exit with a non-zero value.
John Criswellecf32e52003-09-11 19:58:03 +000070
Chris Lattner537a02c2003-10-07 20:01:09 +000071<h3>SEE ALSO</h3>
72<a href="llvm-as.html"><tt>llvm-as</tt></a>
73<a href="gccld.html"><tt>gccld</tt></a>
John Criswellecf32e52003-09-11 19:58:03 +000074
75<HR>
Chris Lattner08a04fd2003-10-07 20:12:05 +000076Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswellecf32e52003-09-11 19:58:03 +000077</body>
78</html>
79