hpux man page for as_pa

as_pa(1)						      General Commands Manual							  as_pa(1)

NAME
       as_pa: as - assembler for PA-RISC systems

SYNOPSIS
       [file]...

   Remarks
       This manpage describes on PA-RISC systems.  For on Integrity systems, see as_ia(1).

DESCRIPTION
       The  command  assembles	source text from files or standard input and produces a relocatable object file suitable for the link editor, (see
       ld(1)).

       Source text is read from standard input only if no file argument is given.  Standard input cannot be a device file,  such  as  a  terminal.
       The option and file arguments can be intermingled on the command line.  Every specified option applies to every specified file, or standard
       input.  The source files are concatenated to form a single input stream.

       If the option is not specified, the suffix (if any) is stripped from the end of the last source file name and is appended to  the  name	to
       form the name of the default object code output file.

       output is not optimized.  creates a relocatable object file that must be processed by before it can be successfully executed (see ld(1)).

       The compiler normally runs the C preprocessor (see cpp(1)), then invokes to assemble the files together with and subsequently invokes

   Options and Operands
       recognizes the following options and operands:

	      file	     A text file containing assembler source code.

	      Permit an unlimited number of errors to be tolerated
			     before the assembly process is abandoned.	By default, one hundred errors are allowed before the assembler aborts.

	      Set the default value for the
			     directive to The normal default value for a that omits the or parameter is

	      Write a listing of the program to standard output after assembly.
			     This listing shows the offsets of instructions and actual values for fields.

	      Name the output object file
			     objfile instead of using the default suffix on the file name of the last file specified.

	      Set the default privilege level for an
			     directive to number.  By default, all user-level procedures are exported at privilege level 3.

	      Set the output file suffix to
			     instead of The file will have a format suitable for conversion to the ROM burning programs.

	      Do not create unwind descriptors.
			     To avoid the need for the directive, the and directives must not have been used.

	      Write cross-reference data to the file named
			     xrfile.

	      Print the version number of the assembler program to standard error
			     before assembling the source text.

	      Either suppress all warning messages if no
			     number is supplied or suppress just the warning number provided.  Multiple options can be used to suppress additional
			     warning messages.

	      Assemble code for the
			     architecture specified.  The use of this option is discouraged.  The preferred method for selecting the  architecture
			     is to have a directive contained within the assembly source file.

			     The assembler uses the following precedence to determine the target architecture.

				  1. Use the directive within the assembly source file.
				  2. Use the command-line specification.
				  3. Use the default architecture of

	      Both of these options are used in the building of shared libraries.
			     For a more complete discussion regarding these options, see the manual

EXTERNAL INFLUENCES
   International Code Set Support
       Single- and multibyte character code sets are supported.

DIAGNOSTICS
       When  syntactic	or  semantic errors occur, a single-line diagnostic is written to standard error, that includes the file name and the line
       number where it occurred.  The format is as follows:

	      as: "filename",line line: error error: message
		  source = source-line

WARNINGS
       does not invoke cpp(1) or m4(1) to perform macro processing.

FILES
       Hardware register definitions
       Software calling convention register definitions
       Standard space and subspace definition
       Assembler error message catalog
       Space, subspace and register definitions
       Object file

SEE ALSO
       adb(1), cc_bundled(1), cpp(1), ld(1), nm(1), crt0(3).

PA-RISC Systems Only															  as_pa(1)