NAME

as − common assembler

SYNOPSIS

as [−o objfile] [−n] [−f float] [−j] [−m] [−R] [−r] [−[bwl]] [−A] [−V] [−P] [−T] [−Q] file-name

DESCRIPTION

The as command assembles the named file.  and there are no unresolved external references.  The following flags may be specified in any order:

−o objfile Put the output of the assembly in objfile. 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. 

−n Turn off long/short address optimization.  By default, address optimization takes place. 

−f float Use float as the floating point mode of assembly and the object file. 

−j −j −m Run the m4 macro pre-processor on the input to the assembler. 

−R Remove (unlink) the input file after assembly is completed. 

−r Place all assembled data (normally placed in the .data section) into the .text section.  This option effectively disables the .data pseudo operation.  This option is off by default. 

−[bwl] Create byte (b), word (w) or long (l) The default value for this option is long (l) displacements.  −A Accept certain extensions to the Ada language. 
(1) Allow a string enclosed in double quotes to appear in an identifier, provided the first character of the identifier is not a double quote.  The characters normally allowed in an identifier may appear in the quoted string. Additionally, the characters +, -, ∗, /, =, <, >, and & may appear in the quoted string.
(2) Permit the length of the name in a .file or file directive to be 800 characters. The default limit is 255 characters.
(3) Allow multiple file directives in the source program.

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

−P Create a formatted listing on standard output.  The format of the printout is:
  ’line-number  pc  memory-layout  source-line’
The ’pc’ field in a .data segment will be followed by a ’∗’.

−Tsymtab_size
Have the compiler allocate symtab_size elements in its symbol table.  The default size is 50000 elements. 

−Qfile_buffer_limit=number
Sets file_buffer_limit to amount of buffer space as will use while assembling. Allowing more buffer space will speed assembling of large programs (if you have enough memory on the system to avoid thrashing) since the assembler won’t have to do as much (if any) disk I/O for its temporary files.   If not set, it defaults to the value in the FILE_BUFFER_LIMIT environment variable.  If that environment variable is not set, it defaults to 2097152 (2 Megabytes). 

−Qno_parse_errors
−Qtarget=m88110compat Identify the object file as being compatible with other object files from Series 4000 and Series 5000 systems.  Object file identification assists the link editor in determining whether a program uses features unique to Series 4000 and/or Series 5000 systems. 

−Qtarget=m88100
Give a warning for the use of features which are not available on Series 4000 systems, and identify the object file as having features unique to Series 4000 systems.

−Qtarget=m88110
Give a warning for the use of features which are not available on Series 5000 systems, and identify the object file as having features unique to Series 5000 systems.

Do not check for parsing errors, under the assumption that the code is
syntactically correct.  The presence of undetected errors could cause unpredictable results in the assembled code.

−QOCS On Series 4000 and Series 5000 systems, prohibit the use of Harris-supplied extensions in OCS compliant assembly language programs. 

FILES

/usr/tmp/as[1-6] XXXXXX temporary files

SEE ALSO

ld(1), m4(1), nm(1), strip(1). 
a.out(4) in the CX/UX Programmer’s Reference Manual. 

WARNING

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

BUGS

Arithmetic expressions may only have one forward referenced symbol per expression. 

CX/UX User’s Reference Manual