blob: b0297a45e71b3746147c6962ae30a206c99b5e8f [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
42 <li> -stats
43 <br>
44 Print statistics.
45 <p>
46
47 <li> -time-passes
48 <br>
49 Record the amount of time needed for each pass and print it to standard
50 error.
51 <p>
52
53 <li> -verify
54 <br>
55 Verify each pass result.
56 <p>
57</ul>
58
59<h3>
60EXIT STATUS
61</h3>
62
Chris Lattnerfc294d12003-10-07 20:01:09 +000063If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
64it will exit with a non-zero value.
John Criswell408128d2003-09-11 19:58:03 +000065
Chris Lattnerfc294d12003-10-07 20:01:09 +000066<h3>SEE ALSO</h3>
67<a href="llvm-as.html"><tt>llvm-as</tt></a>
68<a href="gccld.html"><tt>gccld</tt></a>
John Criswell408128d2003-09-11 19:58:03 +000069
70<HR>
Chris Lattner7c2b1262003-10-07 20:12:05 +000071Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell408128d2003-09-11 19:58:03 +000072</body>
73</html>
74