docs/CommandGuide/gccas.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 gccas - optimizing LLVM assembler
   6
   7 =head1 SYNOPSIS
   8
   9 B<gccas> [I<options>] I<filename>
  10
  11 =head1 DESCRIPTION
  12
  13 The B<gccas> utility takes an LLVM assembly file generated by the
  14 L<llvmgcc|llvmgcc> or L<llvmg++|llvmgxx> front-ends and converts
  15 it into an LLVM bytecode file.  It is primarily used by the GCC
  16 front end, and as such, attempts to mimic the interface provided
  17 by the default system assembler so that it can act as a "drop-in"
  18 replacement.
  19
  20 B<gccas> performs a number of optimizations on the input program,
  21 including but not limited to: promotion of stack values to SSA
  22 registers; elimination of dead globals, function arguments, code,
  23 and types; tail-call elimination; loop-invariant code motion; global
  24 common-subexpression elimination; and sparse conditional constant
  25 propagation.
  26
  27 =head1 OPTIONS
  28
  29 =over
  30
  31 =item B<--help>
  32
  33 Print a summary of command line options.
  34
  35 =item B<-o> F<filename>
  36
  37 Specify the name of the output file which will hold the assembled bytecode.
  38
  39 =item B<--disable-inlining>
  40
  41 Disable the inlining pass.  By default, it is enabled.
  42
  43 =item B<--disable-opt>
  44
  45 Disable all assembler-time optimization passes.
  46
  47 =item B<--stats>
  48
  49 Print statistics.
  50
  51 =item B<--time-passes>
  52
  53 Record the amount of time needed for each pass and print it to standard
  54 error.
  55
  56 =item B<--verify>
  57
  58 Verify each pass result.
  59
  60 =back
  61
  62 =head1 EXIT STATUS
  63
  64 If B<gccas> succeeds, it will exit with an exit status of 0.
  65 Otherwise, if an error occurs, it will exit with a non-zero exit
  66 status.
  67
  68 =head1 SEE ALSO
  69
  70 L<llvm-as|llvm-as>, L<gccld|gccld>
  71
  72 =head1 AUTHORS
  73
  74 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
  75
  76 =cut