mirror of
				https://github.com/c64scene-ar/llvm-6502.git
				synced 2025-10-31 08:16:47 +00:00 
			
		
		
		
	git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@26747 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.org>).
 | |
| 
 | |
| =cut
 |