unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 as(1)								       as(1)




 NAME
      as - assembler (Precision Architecture)

 SYNOPSIS
      as [[option]... [file] ... ]...

 DESCRIPTION
      The as command assembles source text from files or standard input and
      produces a relocatable object file suitable for the link editor, ld
      (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 -o objfile option is not specified, the .s suffix (if any) is
      stripped from the end of the last source file name and .o is appended
      to the name to form the name of the default object code output file.

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

      The cc compiler normally runs the C preprocessor cpp (see cpp(1)),
      then invokes as to assemble the .s files together with
      /usr/lib/pcc_prefix.s, and subsequently invokes ld.

    Arguments
      as recognizes the following arguments.

	   file		    A text file contain assembler source code.

	   option	    An option described below in Options.

    Options
      as recognizes the following values for the option argument.

	   -e		    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.

	   -f		    Set the default value for the .CALLINFO
			    directive to CALLS, The normal default value for
			    a .CALLINFO that omits the CALLER, CALLS or
			    NO_CALLS parameter is NO_CALLS.





 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 as(1)								       as(1)




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

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

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

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

	   -u		    Do not create unwind descriptors.  To avoid the
			    need for the .CALLINFO directive, the .ENTER and
			    .LEAVE directives must not have been used.

	   -v xrfile	    Write cross-reference data to the file named
			    xrfile.

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

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

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

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

				 1. Use the .LEVEL directive within the
				    assembly source file.
				 2. Use the +DA command-line specification.
				 3. Use the default architecture of
				    PA_RISC_1.0.

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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 as(1)								       as(1)




			    manual HP-UX Linker and Libraries User's Guide.

 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
      as does not invoke cpp(1) or m4(1) to perform macro processing.

 FILES
      /usr/include/hard_reg.hr		      Hardware register definitions
      /usr/include/soft_reg.h		      Software calling convention
					      register definitions
      /usr/include/std_space.h		      Standard space and subspace
					      definition
      /usr/lib/nls/msg/C/as.cat		      Assembler error message
					      catalog
      /usr/lib/pcc_prefix.s		      Space, subspace and register
					      definitions
      file.o				      Object file

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

      Assembly Language Reference Manual,
      Precision Architecture and Instruction Reference Manual,
      Procedure Calling Conventions Reference Manual.



















 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000