| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 1 | <html> | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 2 | <title>LLVM: gccas tool</title> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 3 |  | 
| Chris Lattner | 08a04fd | 2003-10-07 20:12:05 +0000 | [diff] [blame^] | 4 | <body bgcolor=white> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 5 |  | 
|  | 6 | <center> | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 7 | <h1>LLVM: <tt>gccas</tt> tool</h1> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 8 | </center> | 
|  | 9 | <HR> | 
|  | 10 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 11 | <h3>NAME</h3> | 
|  | 12 | <tt>gccas</tt> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 13 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 14 | <h3>SYNOPSIS</h3> | 
|  | 15 | <tt>gccas [options] < filename></tt> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 16 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 17 | <h3>DESCRIPTION</h3> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 18 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 19 | The <tt>gccas</tt> utility takes an LLVM assembly file generated by the <a | 
|  | 20 | href="llvmgcc.html">C</a> or <a href="llvmgxx.html">C++</a> frontends and | 
|  | 21 | converts it into an LLVM bytecode file.  It is primarily used by the GCC front | 
|  | 22 | end, and as such, attempts to mimic the interface provided by the default system | 
|  | 23 | assembler so that it can act as a "drop-in" replacement.<p> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 24 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 25 | <tt>gccas</tt> performs a number of optimizations on the input program.<p> | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 26 |  | 
|  | 27 | <h3> | 
|  | 28 | OPTIONS | 
|  | 29 | </h3> | 
|  | 30 |  | 
|  | 31 | <ul> | 
|  | 32 | <li> -help | 
|  | 33 | <br> | 
|  | 34 | Print a summary of command line options. | 
|  | 35 | <p> | 
|  | 36 |  | 
|  | 37 | <li> -o <filename> | 
|  | 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> | 
|  | 60 | EXIT STATUS | 
|  | 61 | </h3> | 
|  | 62 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 63 | If <tt>gccas</tt> succeeds, it will exit with 0.  Otherwise, if an error occurs, | 
|  | 64 | it will exit with a non-zero value. | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 65 |  | 
| Chris Lattner | 537a02c | 2003-10-07 20:01:09 +0000 | [diff] [blame] | 66 | <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 Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 69 |  | 
|  | 70 | <HR> | 
| Chris Lattner | 08a04fd | 2003-10-07 20:12:05 +0000 | [diff] [blame^] | 71 | Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>. | 
| John Criswell | ecf32e5 | 2003-09-11 19:58:03 +0000 | [diff] [blame] | 72 | </body> | 
|  | 73 | </html> | 
|  | 74 |  |