AS(1)

NAME
as - UNIX-style ARM assembler

SYNOPSIS
as [ -o file ] [ -r ] [ -s ] [ -l ] [ -L ] [ -x ] file

DESCRIPTION
As is an assembler which may be used to create object files suitable for incorporation into an executable image, and is used as a pass in various compilers.

By default the assembler assembles the specified file and places the object file into the file a.out, with no listing.

The option -o file may be used to give a different name to the object file.

The option -l may be used to generate a listing file. The listing file name is generated by deleting the last suffix, if any, and appending .lst, thus in the default case the listing file name is a.lst, and the listing file name corresponding to an object file name of the form x.o is x.lst.

The option -L is similar to -l except that a "full listing" (with expansion of all the object code rather than the first 4 bytes of each line) is specified. The assembler directives .list, .listall and .nolist may be used to subsequently modify these options within the source code.

The number of lines per page is assumed to be 66 for the purpose of producing a source listing. This however may be varied by appending a different number to the -l or -L option thus: -L88.

The option -r specifies that the relocation table is to be listed. This is normally only useful for debugging purposes.

The option -s specifies that the symbol table is to be listed. This is also normally only useful for debugging purposes.

The option -x specifies that a cross-reference listing of symbol names is to be produced. Local symbols are not included in the cross-reference. Columns per page of 120 is assumed in preparing the cross reference, however a different number may be specified by appending a different number thus: -x80

The relocation table, symbol table and cross-reference table are appended to the source listing file in that order. This will be created if a source listing is not requested.

FILES
a.out
a.lst

SEE ALSO
cc(1), ld(1), Assembler manual.