=head1 DESCRIPTION
-The B<llc> command compiles LLVM bytecode into assembly language for a
+The B<llc> command compiles LLVM bitcode into assembly language for a
specified architecture. The assembly language output can then be passed through
-a native assembler and linker to generate native code.
+a native assembler and linker to generate a native executable.
-The choice of architecture for the output assembly code is automatically
-determined from the input bytecode file, unless a B<-m> option is used to override
-the default.
+The choice of architecture for the output assembly code is automatically
+determined from the input bitcode file, unless the B<-march> option is used to
+override the default.
=head1 OPTIONS
-If I<filename> is - or omitted, B<llc> reads LLVM bytecode from standard input.
-Otherwise, it will read LLVM bytecode from I<filename>.
+If I<filename> is - or omitted, B<llc> reads LLVM bitcode from standard input.
+Otherwise, it will read LLVM bitcode from I<filename>.
If the B<-o> option is omitted, then B<llc> will send its output to standard
output if the input is from standard input. If the B<-o> option specifies -,
Other B<llc> options are as follows:
+=head2 End-user Options
+
=over
+=item B<--help>
+
+Print a summary of command line options.
+
=item B<-f>
Overwrite output files. By default, B<llc> will refuse to overwrite
an output file which already exists.
-=item B<-march>=I<arch>
+=item B<-mtriple>=I<target triple>
-Specify the architecture for which to generate assembly. Valid
-architectures are:
+Override the target triple specified in the input bitcode file with the
+specified string.
-=over
+=item B<-march>=I<arch>
-=item I<x86>
+Specify the architecture for which to generate assembly, overriding the target
+encoded in the bitcode file. See the output of B<llc --help> for a list of
+valid architectures. By default this is inferred from the target triple or
+autodetected to the current architecture.
-Intel IA-32 (Pentium and above)
+=item B<-mcpu>=I<cpuname>
-=item I<ppc32>
+Specify a specific chip in the current architecture to generate code for.
+By default this is inferred from the target triple and autodetected to
+the current architecture. For a list of available CPUs, use:
+B<llvm-as E<lt> /dev/null | llc -march=xyz -mcpu=help>
-32-bit PowerPC (MacOS X, 32-bit ABI)
+=item B<-mattr>=I<a1,+a2,-a3,...>
-=item I<sparcv9>
+Override or control specific attributes of the target, such as whether SIMD
+operations are enabled or not. The default set of attributes is set by the
+current CPU. For a list of available attributes, use:
+B<llvm-as E<lt> /dev/null | llc -march=xyz -mattr=help>
-64-bit SPARC V9
+=item B<--disable-fp-elim>
-=item I<c>
+Disable frame pointer elimination optimization.
-Emit C code, not assembly
+=item B<--disable-excess-fp-precision>
-=back
+Disable optimizations that may produce excess precision for floating point.
+Note that this option can dramatically slow down code on some systems
+(e.g. X86).
-=item B<--disable-fp-elim>
+=item B<--enable-unsafe-fp-math>
-Disable frame pointer elimination optimization.
+Enable optimizations that make unsafe assumptions about IEEE math (e.g. that
+addition is associative) or may not work for all input ranges. These
+optimizations allow the code generator to make use of some instructions which
+would otherwise not be usable (such as fsin on X86).
=item B<--enable-correct-eh-support>
Instruct the B<lowerinvoke> pass to insert code for correct exception handling
support. This is expensive and is by default omitted for efficiency.
-=item B<--help>
-
-Print a summary of command line options.
-
=item B<--stats>
Print statistics recorded by code-generation passes.
Record the amount of time needed for each pass and print a report to standard
error.
+=item B<--load>=F<dso_path>
+
+Dynamically load F<dso_path> (a path to a dynamically shared object) that
+implements an LLVM target. This will permit the target name to be used with the
+B<-march> option so that code can be generated for that target.
+
+=back
+
+=head2 Tuning/Configuration Options
+
+=over
+
=item B<--print-machineinstrs>
Print generated machine code between compilation phases (useful for debugging).
=back
-=item B<--load>=F<dso_path>
-
-Dynamically load F<dso_path> (a path to a dynamically shared object) that
-implements an LLVM target. This will permit the target name to be used with the
-B<-march> option so that code can be generated for that target.
-
=back
=head2 Intel IA-32-specific Options
=back
-=head2 SPARCV9-specific Options
-
-=over
-
-=item B<--disable-peephole>
-
-Disable peephole optimization pass.
-
-=item B<--disable-sched>
-
-Disable local scheduling pass.
-
-=back
-
=head1 EXIT STATUS
If B<llc> succeeds, it will exit with 0. Otherwise, if an error occurs,
=head1 AUTHORS
-Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
+Maintained by the LLVM Team (L<http://llvm.org>).
=cut