blob: c0a5a7462d298547a44e4dda74133da2f1a0f094 [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
4<body>
5
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
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 Lattner537a02c2003-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 Criswellecf32e52003-09-11 19:58:03 +000065
Chris Lattner537a02c2003-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 Criswellecf32e52003-09-11 19:58:03 +000069
70<HR>
John Criswell32003302003-09-11 20:23:52 +000071<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
John Criswellecf32e52003-09-11 19:58:03 +000072</body>
73</html>
74