2004-05-14 19:50:33 +00:00
|
|
|
=pod
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
llc - LLVM static compiler
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2004-07-02 16:06:19 +00:00
|
|
|
B<llc> [I<options>] [I<filename>]
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2007-07-09 11:24:05 +00:00
|
|
|
The B<llc> command compiles LLVM bitcode into assembly language for a
|
2004-05-14 19:50:33 +00:00
|
|
|
specified architecture. The assembly language output can then be passed through
|
2005-05-13 20:01:11 +00:00
|
|
|
a native assembler and linker to generate a native executable.
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
The choice of architecture for the output assembly code is automatically
|
2007-07-09 11:24:05 +00:00
|
|
|
determined from the input bitcode file, unless the B<-march> option is used to
|
2005-05-13 20:01:11 +00:00
|
|
|
override the default.
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
2007-07-09 11:24:05 +00:00
|
|
|
If I<filename> is - or omitted, B<llc> reads LLVM bitcode from standard input.
|
|
|
|
Otherwise, it will read LLVM bitcode from I<filename>.
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
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 -,
|
|
|
|
then the output will also be sent to standard output.
|
|
|
|
|
|
|
|
If no B<-o> option is specified and an input file other than - is specified,
|
|
|
|
then B<llc> creates the output filename by taking the input filename,
|
|
|
|
removing any existing F<.bc> extension, and adding a F<.s> suffix.
|
|
|
|
|
|
|
|
Other B<llc> options are as follows:
|
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=head2 End-user Options
|
|
|
|
|
2004-05-14 19:50:33 +00:00
|
|
|
=over
|
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=item B<--help>
|
|
|
|
|
|
|
|
Print a summary of command line options.
|
|
|
|
|
2004-05-14 19:50:33 +00:00
|
|
|
=item B<-f>
|
|
|
|
|
|
|
|
Overwrite output files. By default, B<llc> will refuse to overwrite
|
|
|
|
an output file which already exists.
|
|
|
|
|
2005-12-16 05:19:35 +00:00
|
|
|
=item B<-mtriple>=I<target triple>
|
2005-12-16 05:18:53 +00:00
|
|
|
|
2007-07-09 11:24:05 +00:00
|
|
|
Override the target triple specified in the input bitcode file with the
|
2005-12-16 05:18:53 +00:00
|
|
|
specified string.
|
|
|
|
|
2004-05-14 19:50:33 +00:00
|
|
|
=item B<-march>=I<arch>
|
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
Specify the architecture for which to generate assembly, overriding the target
|
2007-07-09 11:24:05 +00:00
|
|
|
encoded in the bitcode file. See the output of B<llc --help> for a list of
|
2005-12-16 05:18:53 +00:00
|
|
|
valid architectures. By default this is inferred from the target triple or
|
|
|
|
autodetected to the current architecture.
|
|
|
|
|
|
|
|
=item B<-mcpu>=I<cpuname>
|
|
|
|
|
|
|
|
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>
|
|
|
|
|
|
|
|
=item B<-mattr>=I<a1,+a2,-a3,...>
|
|
|
|
|
|
|
|
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>
|
2004-11-15 20:22:49 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=item B<--disable-fp-elim>
|
2004-11-15 20:22:49 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
Disable frame pointer elimination optimization.
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=item B<--disable-excess-fp-precision>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
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).
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=item B<--enable-unsafe-fp-math>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
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).
|
2004-12-09 21:16:40 +00:00
|
|
|
|
|
|
|
=item B<--enable-correct-eh-support>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
2004-12-09 21:16:40 +00:00
|
|
|
Instruct the B<lowerinvoke> pass to insert code for correct exception handling
|
2004-05-14 19:50:33 +00:00
|
|
|
support. This is expensive and is by default omitted for efficiency.
|
|
|
|
|
2004-12-09 21:16:40 +00:00
|
|
|
=item B<--stats>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
Print statistics recorded by code-generation passes.
|
|
|
|
|
2004-12-09 21:16:40 +00:00
|
|
|
=item B<--time-passes>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
Record the amount of time needed for each pass and print a report to standard
|
|
|
|
error.
|
|
|
|
|
2005-05-13 20:01:11 +00:00
|
|
|
=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
|
|
|
|
|
2004-05-14 19:50:33 +00:00
|
|
|
=item B<--print-machineinstrs>
|
|
|
|
|
2004-12-09 21:16:40 +00:00
|
|
|
Print generated machine code between compilation phases (useful for debugging).
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=item B<--regalloc>=I<allocator>
|
|
|
|
|
|
|
|
Specify the register allocator to use. The default I<allocator> is I<local>.
|
|
|
|
Valid register allocators are:
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item I<simple>
|
|
|
|
|
|
|
|
Very simple "always spill" register allocator
|
|
|
|
|
|
|
|
=item I<local>
|
|
|
|
|
|
|
|
Local register allocator
|
|
|
|
|
|
|
|
=item I<linearscan>
|
|
|
|
|
2004-07-21 08:18:50 +00:00
|
|
|
Linear scan global register allocator
|
2004-07-21 08:24:35 +00:00
|
|
|
|
2004-07-21 12:53:14 +00:00
|
|
|
=item I<iterativescan>
|
2004-07-21 08:24:35 +00:00
|
|
|
|
|
|
|
Iterative scan global register allocator
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=item B<--spiller>=I<spiller>
|
|
|
|
|
|
|
|
Specify the spiller to use for register allocators that support it. Currently
|
|
|
|
this option is used only by the linear scan register allocator. The default
|
|
|
|
I<spiller> is I<local>. Valid spillers are:
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item I<simple>
|
|
|
|
|
|
|
|
Simple spiller
|
|
|
|
|
|
|
|
=item I<local>
|
|
|
|
|
|
|
|
Local spiller
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
2004-12-09 21:16:40 +00:00
|
|
|
=head2 Intel IA-32-specific Options
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item B<--x86-asm-syntax=att|intel>
|
|
|
|
|
|
|
|
Specify whether to emit assembly code in AT&T syntax (the default) or intel
|
|
|
|
syntax.
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
2004-05-14 19:50:33 +00:00
|
|
|
=head1 EXIT STATUS
|
|
|
|
|
|
|
|
If B<llc> succeeds, it will exit with 0. Otherwise, if an error occurs,
|
|
|
|
it will exit with a non-zero value.
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2004-07-02 16:06:19 +00:00
|
|
|
L<lli|lli>
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=head1 AUTHORS
|
|
|
|
|
2006-03-14 05:42:07 +00:00
|
|
|
Maintained by the LLVM Team (L<http://llvm.org>).
|
2004-05-14 19:50:33 +00:00
|
|
|
|
|
|
|
=cut
|