as(1)
NAME
as − assembler
SYNTAX
as [ − ] [ −V ] [ −o objfile ] file...
DESCRIPTION
The as command assembles the concatenation of the named files. If the optional first argument − is used, all undefined symbols in the assembly are treated as global. If the -V option is used, references to global text symbols are not resolved, but left for the loader to resolve. This should be done for files that are to be placed in overlays. It does not hurt to use the -V flag as long as the output is run through the loader, but failure to use it for modules that go into overlays can cause improper text references.
If the -o option is used, output is written to the file objfile. If -o is omitted, a.out is used. It is executable if no errors occurred during the assembly, and if there were no unresolved external references.
RESTRICTIONS
Syntax errors can cause incorrect line numbers in following diagnostics.
DIAGNOSTICS
When an input file cannot be read, its name followed by a question mark is typed and assembly ceases. When syntactic or semantic errors occur, a single-character diagnostic is typed out together with the line number and the file name in which it occurred. Errors in pass 1 cause cancellation of pass 2. The possible errors are:
) Parentheses error
] Parentheses error
< String not terminated properly
* Indirection used illegally
a Error in address
b Branch instruction is odd or too remote
e Error in expression
f Error in local (’f’ or ’b’) type symbol
g Garbage (unknown) character
i End of file inside an if
m Multiply defined symbol as label
o Word quantity assembled at odd address
p . different in pass 1 and 2
r Relocation error
u Undefined symbol
x Syntax error
FILES
/lib/as2 pass 2 of the assembler
/tmp/atm[1-3]?temporary
a.outobject