docs/CommandGuide/gccas.html

   1 <html>
   2 <title>LLVM: gccas tool</title>
   3
   4 <body bgcolor=white>
   5
   6 <center>
   7 <h1>LLVM: <tt>gccas</tt> tool</h1>
   8 </center>
   9 <HR>
  10
  11 <h3>NAME</h3>
  12 <tt>gccas</tt>
  13
  14 <h3>SYNOPSIS</h3>
  15 <tt>gccas [options] &lt; filename&gt;</tt>
  16
  17 <h3>DESCRIPTION</h3>
  18
  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>
  24
  25 <tt>gccas</tt> performs a number of optimizations on the input program.<p>
  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 &lt;filename&gt;
  38         <br>
  39         Specify the output filename which will hold the assembled bytecode.
  40         <p>
  41
  42         <li>-disable-inlining
  43         <br>
  44         Disable the inlining pass.  By default, it is enabled.
  45         <p>
  46
  47         <li> -stats
  48         <br>
  49         Print statistics.
  50         <p>
  51
  52         <li> -time-passes
  53         <br>
  54         Record the amount of time needed for each pass and print it to standard
  55         error.
  56         <p>
  57
  58         <li> -verify
  59         <br>
  60         Verify each pass result.
  61         <p>
  62 </ul>
  63
  64 <h3>
  65 EXIT STATUS
  66 </h3>
  67
  68 If <tt>gccas</tt> succeeds, it will exit with 0.  Otherwise, if an error occurs,
  69 it will exit with a non-zero value.
  70
  71 <h3>SEE ALSO</h3>
  72 <a href="llvm-as.html"><tt>llvm-as</tt></a>
  73 <a href="gccld.html"><tt>gccld</tt></a>
  74
  75 <HR>
  76 Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
  77 </body>
  78 </html>
  79