This chapter describes command-line options available in all versions of the GNU assembler; see Machine Dependencies, for options specific to particular machine architectures.
If you are invoking as via the GNU C compiler,
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
This passes two options to the assembler: ‘-alh’ (emit a listing to standard output with high-level and assembly source) and ‘-L’ (retain local symbols in the symbol table).
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.)
| • a: | -a[cdghlns] enable listings | |
| • alternate: | –alternate enable alternate macro syntax | |
| • D: | -D for compatibility | |
| • f: | -f to work faster | |
| • I: | -I for .include search path | |
| • K: | -K for difference tables | |
| • L: | -L to retain local symbols | |
| • listing: | –listing-XXX to configure listing output | |
| • M: | -M or –mri to assemble in MRI compatibility mode | |
| • MD: | –MD for dependency tracking | |
| • o: | -o to name the object file | |
| • R: | -R to join data and text sections | |
| • statistics: | –statistics to see statistics about assembly | |
| • traditional-format: | –traditional-format for compatible output | |
| • v: | -v to announce version | |
| • W: | -W, –no-warn, –warn, –fatal-warnings to control warnings | |
| • Z: | -Z to make object file even after errors | |