Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / fa2f3686a379a49bdfc5e21c2dc43832a808e5c8 / . / llvm / docs / CommandGuide / gccas.html
blob: 67a270c968c30d3e4122294063a8d453a251cc36 [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
52 <li>-enable-correct-eh-support
53 <br>
54 Instruct the -lowerinvoke pass to insert code for correct exception handling
55 support. This is expensive and is by default omitted for efficiency.
56 <p>
57
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]58 <li> -stats
59 <br>
60 Print statistics.
61 <p>
62
63 <li> -time-passes
64 <br>
65 Record the amount of time needed for each pass and print it to standard
66 error.
67 <p>
68
69 <li> -verify
70 <br>
71 Verify each pass result.
72 <p>
73</ul>
74
75<h3>
76EXIT STATUS
77</h3>
78
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]79If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
80it will exit with a non-zero value.
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]81
Chris Lattnerfc294d12003-10-07 20:01:09 +0000[diff] [blame]82<h3>SEE ALSO</h3>
83<a href="llvm-as.html"><tt>llvm-as</tt></a>
84<a href="gccld.html"><tt>gccld</tt></a>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]85
86<HR>
Chris Lattner7c2b1262003-10-07 20:12:05 +0000[diff] [blame]87Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]88</body>
89</html>
90