Whole document tree

2. Command-Line Options

This chapter describes command-line options available in all versions of the GNU assembler; see section 8. Machine Dependent Features, for options specific to particular machine architectures.

If you are invoking as via the GNU C compiler (version 2), you can use the `-Wa' option to pass arguments through to the assembler. The assembler arguments must be separated from each other (and the `-Wa') by commas. For example:

gcc -c -g -O -Wa,-alh,-L file.c

emits a listing to standard output with high-level and assembly source.

Usually you do not need to use this `-Wa' mechanism, since many compiler command-line options are automatically passed to the assembler by the compiler. (You can call the GNU compiler driver with the `-v' option to see precisely what options it passes to each compilation pass, including the assembler.)

2.1 Enable Listings: -a[cdhlns]		-a[cdhlns] enable listings
2.2 -D		-D for compatibility
2.3 Work Faster: -f		-f to work faster
2.4 .include search path: -I path		-I for .include search path
2.5 Difference Tables: -K		-K for difference tables

2.6 Include Local Labels: -L		-L to retain local labels
2.7 Assemble in MRI Compatibility Mode: -M		-M or --mri to assemble in MRI compatibility mode
2.8 Dependency tracking: --MD		--MD for dependency tracking
2.9 Name the Object File: -o		-o to name the object file
2.10 Join Data and Text Sections: -R		-R to join data and text sections
2.11 Display Assembly Statistics: --statistics		--statistics to see statistics about assembly
2.12 Compatible output: --traditional-format		--traditional-format for compatible output
2.13 Announce Version: -v		-v to announce version
2.14 Suppress Warnings: -W		-W to suppress warnings
2.15 Generate Object File in Spite of Errors: -Z		-Z to make object file even after errors