mirror of
				https://github.com/c64scene-ar/llvm-6502.git
				synced 2025-11-04 05:17:07 +00:00 
			
		
		
		
	* Make links in SEE ALSO section of manpages short without "the ... manpage" git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@14579 91177308-0d34-0410-b5e6-96231b3b80d8
		
			
				
	
	
		
			77 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			77 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
=pod
 | 
						|
 | 
						|
=head1 NAME
 | 
						|
 | 
						|
gccas - optimizing LLVM assembler
 | 
						|
 | 
						|
=head1 SYNOPSIS
 | 
						|
 | 
						|
B<gccas> [I<options>] I<filename>
 | 
						|
 | 
						|
=head1 DESCRIPTION
 | 
						|
 | 
						|
The B<gccas> utility takes an LLVM assembly file generated by the
 | 
						|
L<llvmgcc|llvmgcc> or L<llvmg++|llvmgxx> front-ends and converts
 | 
						|
it into an LLVM bytecode file.  It is primarily used by the GCC
 | 
						|
front end, and as such, attempts to mimic the interface provided
 | 
						|
by the default system assembler so that it can act as a "drop-in"
 | 
						|
replacement.
 | 
						|
 | 
						|
B<gccas> performs a number of optimizations on the input program,
 | 
						|
including but not limited to: promotion of stack values to SSA
 | 
						|
registers; elimination of dead globals, function arguments, code,
 | 
						|
and types; tail-call elimination; loop-invariant code motion; global
 | 
						|
common-subexpression elimination; and sparse conditional constant
 | 
						|
propagation.
 | 
						|
 | 
						|
=head1 OPTIONS
 | 
						|
 | 
						|
=over
 | 
						|
 | 
						|
=item B<--help>
 | 
						|
 | 
						|
Print a summary of command line options.
 | 
						|
 | 
						|
=item B<-o> F<filename>
 | 
						|
 | 
						|
Specify the name of the output file which will hold the assembled bytecode.
 | 
						|
 | 
						|
=item B<--disable-inlining>
 | 
						|
 | 
						|
Disable the inlining pass.  By default, it is enabled.
 | 
						|
 | 
						|
=item B<--disable-opt>
 | 
						|
 | 
						|
Disable all assembler-time optimization passes.
 | 
						|
 | 
						|
=item B<--stats>
 | 
						|
 | 
						|
Print statistics.
 | 
						|
 | 
						|
=item B<--time-passes>
 | 
						|
 | 
						|
Record the amount of time needed for each pass and print it to standard
 | 
						|
error.
 | 
						|
 | 
						|
=item B<--verify>
 | 
						|
 | 
						|
Verify each pass result.
 | 
						|
 | 
						|
=back
 | 
						|
 | 
						|
=head1 EXIT STATUS
 | 
						|
 | 
						|
If B<gccas> succeeds, it will exit with an exit status of 0.
 | 
						|
Otherwise, if an error occurs, it will exit with a non-zero exit
 | 
						|
status.
 | 
						|
 | 
						|
=head1 SEE ALSO
 | 
						|
 | 
						|
L<llvm-as|llvm-as>, L<gccld|gccld>
 | 
						|
 | 
						|
=head1 AUTHORS
 | 
						|
 | 
						|
Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 | 
						|
 | 
						|
=cut
 |