This is the OpenVMS I64 version of the Intel Itanium Assembler (IAS) and
the Intel Itanium Disassembler (IDIS).


1) Background

We started with the opensource kit for the Intel Itanium Assembler available 
from Intel at:

  http://developer.intel.com/software/products/opensource

along with the documentation in the same location.

We then applied several small edits to the assembler.

   1. Fixed several small bugs relating to ELF contents.  The OpenVMS I64
      linker was sensitive to these bugs that are apparently benign on other
      targets.
   2. Add OpenVMS-specific ELF information such as extra .NOTE sections
      that include compiler information, module name, compilation date/time, 
      etc.
   3. Set OpenVMS-specific flags in the ELF header.
   4. Add .VMS_MODULE_NAME "string" and .VMS_MODULE_VERSION "string" 
      directives.
   5. Add .VMS_OSSD integer directive to provide a mechanism to specify the
      OpenVMS-specific OSSD flags in a routine's unwind descriptors.
   6. Upcase all global function and data symbol names.  Also upcase the 
      module name.
   7. Set correct RMS file attributes for generated ".o" files to match all
      the other OpenVMS compilers.
   8. Set correct ELF section type on various ".debug_*" ELF sections.
   9. Set OpenVMS-specific SHR flag on all sections that include instructions.

All of these changes can be found in the source tree provided.


2) Contents of kit

This kit provides the following files:

   1. IASI64.EXE - Native Itanium assembler built and linked on 
      OpenVMS I64 V8.2 using HP C and HP C++ for OpenVMS I64
   2. IDISI64.EXE - Native Itanium disassembler built and linked on
      OpenVMS I64 V8.2 using HP C and HP C++ for OpenVMS I64
   3. IASSRC.ZIP - ZIP file containing source tree used for our last
      build as well as a changes document and build scripts
   4. This file.

There is no installation procedure.


3) Using IAS/IDIS on OpenVMS I64

Since these tools have a UNIX and Linux heritage, they are provided as 
foreign commends with UNIX-like command line interfaces.

Define the following DCL commands:

$ ias :== $disk:[dir]iasi64.exe
$ idis :== $disk:[dir]idisi64.exe

then compile Itanium assembly files as follows:

$ ias foo.s

That will produce a foo.o (it is a UNIX-based tool after all).  If you
prefer to get an .OBJ file, then use

$ ias -o foo.obj foo.s

Use "-h" for a command option summary.

$ idis "-SALL_X" foo.obj

will disassemble all executable sections found in foo.obj.  Use "-H" for
a command option summary.


4) Building IAS and IDIS on OpenVMS I64

Unzip the IASSRC.ZIP kit.  

In the [.IAS] directory, you will find a BUILD_00_MASTER.COM, invoke it as:

$ @BUILD_00_MASTER.COM verbose

When the build is finished, look in [.IAS.LIB_VMS] for IAS.EXE and IDIS.EXE

There are several readme files in [.IAS].



Open Source Tools License Agreement

IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING. By
downloading, copying, installing or using the software you agree to this
license. If you do not agree to this license, do not download, install,
copy or use the software.

Intel License Agreement

Copyright (c) 2000, Intel Corporation

All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.

* The name of Intel Corporation may not be used to endorse or promote
products derived from this software without specific prior written
permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR CONTRIBUTORS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.