docs/CommandGuide/llvm-as.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 llvm-as - LLVM assembler
   6
   7 =head1 SYNOPSIS
   8
   9 llvm-as [options] [filename]
  10
  11 =head1 DESCRIPTION
  12
  13 The B<llvm-as> command invokes the LLVM assembler.  It reads a file containing
  14 human-readable LLVM assembly language, translates it to LLVM bytecode, and
  15 writes the result into a file or to standard output.
  16
  17 If F<filename> is omitted or is C<->, then B<llvm-as> reads its input from
  18 standard input.
  19
  20 If an output file is not specified with the B<-o> option, then
  21 B<llvm-as> sends its output to a file or standard output by following
  22 these rules:
  23
  24 =over
  25
  26 =item *
  27
  28 If the input is standard input, then the output is standard output.
  29
  30 =item *
  31
  32 If the input is a file that ends with C<.ll>, then the output file is of
  33 the same name, except that the suffix is changed to C<.bc>.
  34
  35 =item *
  36
  37 If the input is a file that does not end with the C<.ll> suffix, then the
  38 output file has the same name as the input file, except that the C<.bc>
  39 suffix is appended.
  40
  41 =back
  42
  43 =head1 OPTIONS
  44
  45 =over
  46
  47 =item B<-f>
  48
  49 Force overwrite.  Normally, B<llvm-as> will refuse to overwrite an
  50 output file that already exists.  With this option, B<llvm-as>
  51 will overwrite the output file and replace it with new bytecode.
  52
  53 =item B<--help>
  54
  55 Print a summary of command line options.
  56
  57 =item B<-o> F<filename>
  58
  59 Specify the output file name.  If F<filename> is C<->, then B<llvm-as>
  60 sends its output to standard output.
  61
  62 =item B<--stats>
  63
  64 Print statistics.
  65
  66 =item B<--time-passes>
  67
  68 Record the amount of time needed for each pass and print it to standard
  69 error.
  70
  71 =back
  72
  73 =head1 EXIT STATUS
  74
  75 If B<llvm-as> succeeds, it will exit with 0.  Otherwise, if an error
  76 occurs, it will exit with a non-zero value.
  77
  78 =head1 SEE ALSO
  79
  80 L<llvm-dis>, L<gccas>
  81
  82 =head1 AUTHORS
  83
  84 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
  85
  86 =cut
  87