Here is a brief summary of how to invoke the assembler. For details, see Chapter 24.
m1750-coff-as [ -a[dhlns][=file] ] [ -D ] [ --defsym sym=val ] [ -f ] [ --help ] [ -I dir ] [ -J ] [ -K ] [ -L ] [ -o objfile ] [ -R ] [ --statistics ] [ -v ] [ -version ] [ --version ] [ -W ] [ -w ] [ -x ] [ -Z ] [ -ACBA | -ACCA | -Av7] [ -- | files ... ]
Turn on listings, in any of a variety of ways:
omit debugging directives
include high-level source
omit forms processing
set the name of the listing file
You may combine these options; for example, use “-aln” for assembly listing without forms processing. The “=file” option, if used, must be the last one. By itself, “-a” defaults to “-ahls”—that is, all listings turned on.
Ignored. This option is accepted for script compatibility with calls to other assemblers.
Define the symbol sym to be value before assembling the input file. value must be an integer constant. As in C, a leading “0x” indicates a hexadecimal value, and a leading “0” indicates an octal value.
"fast"--skip white-space and comment preprocessing (assume source is compiler output).
Print a summary of the command line options and exit.
Add directory dir to the search list for .include directives.
Don't warn about signed overflow.
Issue warnings when difference tables altered for long displacements.
Keep (in the symbol table) local symbols, starting with “L”.
Name the object-file output from the assembler objfile.
Fold the data section into the text section.
Print the maximum space (in bytes) and total time (in seconds) used by assembly.
Print the as version.
Print the as version and exit.
Suppress warning messages.
Generate an object file even after errors.
Standard input, or source files to assemble.
The GNU assembler is really a family of assemblers. If you have used the GNU assembler on one architecture, you should find a fairly similar environment when you use it on another architecture. Each version has much in common with the others, including object file formats, most assembler directives (often called pseudo-ops) and assembler syntax.
The assembler is primarily intended to assemble the output of the compiler for use by the linker. Nevertheless, we've tried to make the assembler assemble correctly everything that other assemblers for the same machine would assemble.
Unlike older assemblers, the assembler is designed to assemble a source program in one pass of the source file. This has a subtle impact on the .org directive (see Section 29.43).