NAME

as − assembler

SYNOPSIS

as [ −m ] [ −o outfile [ −P ] [ −Dname ] [ −Dname=def ]
[ −Ipath ] [ −Uname ]]...] [ −Q{y|n} ] [ −s ] [ −V ] filename...

DESCRIPTION

The as command creates object files from assembly language source files. and there are no unresolved external references.

OPTIONS

The following flags may be specified in any order:

−m Run the m4(1) macro processor on the input to the assembler. 

−o outfile Put the output of the assembly in outfile. By default, the output file name is formed by removing the .s suffix, if there is one, from the input file name and appending a .o suffix. 

−P Run cpp(1), the C preprocessor, on the files being assembled.  The preprocessor is run separately on each input file, not on their concatenation.  The preprocessor output is passed to the assembler. 

−Dname

−Dname=def When the −P option is in effect, these options are passed to the cpp(1) preprocessor without interpretation by the as command; otherwise, they are ignored. 

−Ipath When the −P option is in effect, this option is passed to the cpp(1) preprocessor without interpretation by the as command; otherwise, it is ignored. 

−Uname When the −P option is in effect, this option is passed to the cpp(1) preprocessor without interpretation by the as command; otherwise, it is ignored. 

−Q Warn the user if a transfer vector operand is used in any context other than a "call" instruction.  }

−Q{y|n} Produce information in the comment section of the output object file if the y option is specified; if the n option is specified, the information is suppressed. 

−s Place all stabs in the .stabs section. By default, stabs are placed in stabs.excl sections, which are stripped out by the static linker, ld(1), during final execution.  When the −s option is used, stabs remain in the final executable because .stab sections are not stripped by the static linker. 

−V Write the version number of the assembler being run on the standard error output. 

FILES

By default, as creates its temporary files in /tmp. 

SEE ALSO

cc(1B), cpp(1), ld(1), m4(1), nm(1), strip(1), tmpnam(3S), a.out(4)

NOTES

If the −m (invoke the m4(1) macro processor) option is used, keywords for m4(1) cannot be used as symbols (variables, functions, labels) in the input file since m4(1) cannot determine which keywords are assembler symbols and which keywords are real m4(1) ­macros. 

Whenever possible, you should access the assembler through a compilation system interface program such as cc(1B). 

All undefined symbols are treated as global. 

SunOS 5.1  —  Last change: 30 Sept 1992