forked from OSchip/llvm-project
67 lines
1.4 KiB
Plaintext
67 lines
1.4 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
llvm-upgrade - LLVM assembly upgrade tool
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<llvm-upgrade> [I<options>] [I<filename>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
B<llvm-upgrade> is the LLVM assembly upgrade tool. It reads a file containing
|
|
human-readable LLVM assembly language, and upgrades that assembly to the current
|
|
version of LLVM. If the input is in the form currently accepted by LLVM, then
|
|
no upgrades are performed.
|
|
|
|
The expected usage of this tool is as a filter, like this:
|
|
|
|
=over
|
|
|
|
B<llvm-1.9/bin/llvm-dis < 1.9.bc | llvm-upgrade | llvm-2.0/bin/llvm-as -o 2.0.bc>
|
|
|
|
=back
|
|
|
|
If F<filename> is omitted or is C<->, then B<llvm-upgrade> reads its input from
|
|
standard input.
|
|
|
|
If an output file is not specified with the B<-o> option, then
|
|
B<llvm-upgrade> sends its output to standard output.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over
|
|
|
|
=item B<-f>
|
|
|
|
Force overwrite. Normally, B<llvm-upgrade> will refuse to overwrite an
|
|
output file that already exists. With this option, B<llvm-upgrade>
|
|
will overwrite the output file.
|
|
|
|
=item B<--help>
|
|
|
|
Print a summary of command line options.
|
|
|
|
=item B<-o> F<filename>
|
|
|
|
Specify the output file name. If F<filename> is C<->, then B<llvm-upgrade>
|
|
sends its output to standard output.
|
|
|
|
=back
|
|
|
|
=head1 EXIT STATUS
|
|
|
|
If B<llvm-upgrade> succeeds, it will exit with 0. Otherwise, if an error
|
|
occurs, it will exit with a non-zero value.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<llvm-as|llvm-as>, L<llvm-dis|llvm-dis>
|
|
|
|
=head1 AUTHORS
|
|
|
|
Maintained by the LLVM Team (L<http://llvm.org>).
|
|
|
|
=cut
|