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> -disable-opt
  48         <br>
  49   Disable all assemble-time optimization passes.
  50         <p>
  51
  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>
  70 EXIT STATUS
  71 </h3>
  72
  73 If <tt>gccas</tt> succeeds, it will exit with 0.  Otherwise, if an error occurs,
  74 it will exit with a non-zero value.
  75
  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>
  79
  80 <HR>
  81 Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
  82 </body>
  83 </html>
  84