Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / d4ba0a5721416ec71c42b3d51ad8606b29899a01 / . / llvm / docs / CommandGuide / gccas.html
blob: 4c22a9934a5743a7d28a69161abb2272dfe5d265 [file] [log] [blame]
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]1<html>
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]2<title>LLVM: gccas tool</title>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]3
Chris Lattner7c2b1262003-10-07 20:12:05 +0000[diff] [blame]4<body bgcolor=white>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]5
6<center>
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]7<h1>LLVM: <tt>gccas</tt> tool</h1>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]8</center>
9<HR>
10
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]11<h3>NAME</h3>
12<tt>gccas</tt>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]13
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]14<h3>SYNOPSIS</h3>
15<tt>gccas [options] &lt; filename&gt;</tt>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]16
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]17<h3>DESCRIPTION</h3>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]18
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]19The <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 +0000[diff] [blame]24
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]25<tt>gccas</tt> performs a number of optimizations on the input program.<p>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]26
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 +0000[diff] [blame]42 <li>-disable-inlining
43 <br>
44 Disable the inlining pass. By default, it is enabled.
45 <p>
46
John Criswell13875932004-03-12 22:45:35 +0000[diff] [blame]47 <li> -disable-opt
48 <br>
49 Disable all assemble-time optimization passes.
50 <p>
51
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]52 <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 Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]73If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
74it will exit with a non-zero value.
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]75
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]76<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 Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]79
80<HR>
Chris Lattner7c2b1262003-10-07 20:12:05 +0000[diff] [blame]81Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]82</body>
83</html>
84