*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> as_pa (1)              


 as_pa(1)                                                           as_pa(1)
                             For PA-RISC Systems

 NAME    [Toc]    [Back]
      as_pa: as - assembler for PA-RISC systems

 SYNOPSIS    [Toc]    [Back]
      as [-eflsuV] [-o objfile] [-p number] [-v xrfile] [-w[number]]...
           [+DAarchitecture] [+z] [+Z] [file]...

 DESCRIPTION    [Toc]    [Back]
      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

      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

      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.

    Options and Operands    [Toc]    [Back]
      as recognizes the following options and operands:

           file           A text file containing assembler source code.

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

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

 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004

 as_pa(1)                                                           as_pa(1)
                             For PA-RISC Systems

           -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

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

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

                          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

           +z,+Z          Both of these options are used in the building of
                          shared libraries.  For a more complete discussion
                          regarding these options, see the manual HP-UX
                          Linker and Libraries User's Guide.


 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004

 as_pa(1)                                                           as_pa(1)
                             For PA-RISC Systems

    International Code Set Support    [Toc]    [Back]
      Single- and multibyte character code sets are supported.

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

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

 SEE ALSO    [Toc]    [Back]
      adb(1), cc_bundled(1), cpp(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 11i Version 2: Sep 2004
[ Back ]
 Similar pages
Name OS Title
as_ia HP-UX assembler for Itanium-based systems
as HP-UX assembler for Itanium-based systems
io OpenBSD HP PA-RISC I/O subsystem reference
Aries HP-UX emulate PA-RISC HP-UX applications on Itanium-based processor
as Tru64 assembler
as Linux the portable GNU assembler.
as OpenBSD the portable GNU assembler.
as IRIX SGI MIPSpro Assembler
as FreeBSD the portable GNU assembler.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service