blob: a0bafcc82063c20c49191168d1d5d7753046f88c [file] [log] [blame]
John Criswell408128d2003-09-11 19:58:03 +00001<html>
Chris Lattnerfc294d12003-10-07 20:01:09 +00002<title>LLVM: gccas tool</title>
John Criswell408128d2003-09-11 19:58:03 +00003
Chris Lattner7c2b1262003-10-07 20:12:05 +00004<body bgcolor=white>
John Criswell408128d2003-09-11 19:58:03 +00005
6<center>
Chris Lattnerfc294d12003-10-07 20:01:09 +00007<h1>LLVM: <tt>gccas</tt> tool</h1>
John Criswell408128d2003-09-11 19:58:03 +00008</center>
9<HR>
10
Chris Lattnerfc294d12003-10-07 20:01:09 +000011<h3>NAME</h3>
12<tt>gccas</tt>
John Criswell408128d2003-09-11 19:58:03 +000013
Chris Lattnerfc294d12003-10-07 20:01:09 +000014<h3>SYNOPSIS</h3>
15<tt>gccas [options] &lt; filename&gt;</tt>
John Criswell408128d2003-09-11 19:58:03 +000016
Chris Lattnerfc294d12003-10-07 20:01:09 +000017<h3>DESCRIPTION</h3>
John Criswell408128d2003-09-11 19:58:03 +000018
Chris Lattnerfc294d12003-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 Criswell408128d2003-09-11 19:58:03 +000024
Chris Lattnerfc294d12003-10-07 20:01:09 +000025<tt>gccas</tt> performs a number of optimizations on the input program.<p>
John Criswell408128d2003-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 Criswelle9f3af62003-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 Criswell408128d2003-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 Lattnerfc294d12003-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 Criswell408128d2003-09-11 19:58:03 +000070
Chris Lattnerfc294d12003-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 Criswell408128d2003-09-11 19:58:03 +000074
75<HR>
Chris Lattner7c2b1262003-10-07 20:12:05 +000076Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell408128d2003-09-11 19:58:03 +000077</body>
78</html>
79