as_ia(1)                                                           as_ia(1)
                        For Itanium(R)-based Systems



 NAME    [Toc]    [Back]
      as_ia: as - assembler for Itanium-based systems

 SYNOPSIS    [Toc]    [Back]
      as [-eVw] [+A32] [+A64] [+E32] [-elf32] [-elf64]
           -H lvl[=what[,what]...] [-o outfile] -W num[,num]...
           -We num[,num]... [file]

 DESCRIPTION    [Toc]    [Back]
      as assembles the named source file file, or the standard input if file
      is not specified.  The output of the assembler is an ELF relocatable
      object file that must be processed by ld before it can be executed.

      Assembler output is stored in file outfile.  If the -o outfile option
      is not specified, the assembler constructs a default name.  If no
      source file is specified, outfile will be a.out; otherwise the .s
      suffix (if present) is stripped from the name of the source file and
      .o is appended to it.  Any directory names are removed from the name
      so that the object file is always written to the current directory.

      as does not not perform any macro processing.  Standard C preprocessor
      constructs can be used if the assembler is invoked through the C
      compiler.

    Options    [Toc]    [Back]
      as recognizes the following options:

      +A32           Specify that the source file contains 32-bit ABI
                     targeted code.  This option is overridden by the .psr
                     abi64 assembler directive in the source file.  The
                     object file is a 32-bit ELF file by default.

      +A64           Specify that the source file contains 64-bit ABI
                     targeted code.  This option is overridden by the .psr
                     abi32 assembler directive in the source file.  The
                     object file is a 64-bit ELF file by default.

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

      +E32           Specify that the object file should be 32-bit ELF.
                     This is the default (see also +A32).  Note that it is
                     valid to write 64-bit ABI targeted code to a 32-bit ELF
                     file.  All 32-bit addresses in the object file are
                     zero-extended to 64-bit upon loading.  Zero-extension,
                     however, may invalidate any negative addresses (such as
                     with relocations).





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






 as_ia(1)                                                           as_ia(1)
                        For Itanium(R)-based Systems



      +E64           Specify that the object file should be 64-bit ELF (see
                     also +A64).

      -elf32         See +E32.

      -elf64         See +E64.

      -H lvl[=what[,what]...]
                     Set dependency checking.  lvl must be one of the
                     following: off, warn, or err.  what must be one of the
                     following: data, impl, or inst.

      -o outfile     Produce an output object file with the name outfile
                     instead of constructing a default name.

      -V             Print the version information to stderr before
                     assembling the input.

      -W num[,num]...
                     Suppress the specified warning messages.

      -We num[,num]...
                     Promote the specified warning messages to errors.

      -w             Suppress all warning messages.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      NLSPATH determines the location of the message catalog for the
      processing of LC_MESSAGES.

      SDKROOT controls which assembler to invoke and enables support for
      multiple (cross-) development kits.  The SDKROOT variable points to
      the root of a specific SDK.  No provision has been made to validate
      the value of the variable or the suitability of the assembler that's
      being invoked.

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

 WARNINGS    [Toc]    [Back]
      The assembler does not check dependencies.

 DIAGNOSTICS    [Toc]    [Back]
      When syntactic or semantic errors occur, a single-line diagnostic is
      displayed on standard error, together with the line number and the
      file name in which it occurred.

 FILES    [Toc]    [Back]
      /usr/lib/nls/C/as.cat              assembler error message catalog




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






 as_ia(1)                                                           as_ia(1)
                        For Itanium(R)-based Systems



      a.out                              default assembler output file

 SEE ALSO    [Toc]    [Back]
      cc(1), ld(1), elf(3E).


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