README.Pro64.src

README.Pro64.src
-----------------------------------------------------------------------
NOTICE: This is the README.src file for SGI Pro64(TM) compiler.
        SGI Pro64 compiler is the ancestor of the Open64 compiler.
-----------------------------------------------------------------------

This document contains information about installing and building
the SGI Pro64 compiler source release.

Installation Information

Untar the tar file that you downloaded from the ftp site:

  % cd installation_directory 
  % gunzip pro64-0.01.0-13-sources.tar.gz 
  % tar xvf pro64-0.01.0-13-sources.tar 

HOW TO BUILD

Prerequisites:

We used the following version of gcc to compile the binaries
include in our rpm:

   gcc version 2.96 19991114 (experimental)

We also used g77 for compiling parts of the Fortran 90
front-end. The version that we used was:

   GNU F77 version egcs-2.91.66 19990314/Linux (egcs-1.1.2 release) 
   (i386-redhat)

For this release we have not verified the build with
gcc version 2.95 19990728 (release).


You will also need to install the NUE environment in order to build 
IA64 libraries. Information about NUE can be found at:

       http://www.software.hp.com/ia64linux

We used our own sgicc and sgif90 compilers to
build the IA-64 libraries. You will need to install those
from the sgicc rpm under the NUE environment.


Installing the pro64 RPMs

You need to install the pro64 rpm from the nue environment.
Note that the nue command will put you under your home
directory in NUE, which may not be your regular home
directory. You should move the pro64 rpm and osprey
source tree to a directory that is accessible under NUE.

To install the pro64 rpm do the following:

  %su
  #nue
  #rpm -i --force --nodeps pro64-0.01.0-13.ia64.rpm

The --nodeps flag is needed because the installation
under NUE only sees files installed under NUE. It does
not see the files installed from the NUE rpm.

To remove it:

  #rpm -e --nodeps pro64

To update it:

  #rpm -U --force --nodeps pro64-0.01.0-13.ia64.rpm

You can verify your installation by doing a simple
hello world test under NUE:

  %cat hello.c
  #include <stdio.h>

  main()
  {
     printf("hello world\n");
  }

  %sgicc hello.c
  %./a.out
  hello world 
  %


Doing the Build

Before doing the build make sure you have permissions
in the tree where you will be doing the builds. You
can do this by:

       %chown -R your_username kpro64

Each of the programs below is included in the rpm
that you downloaded from the ftp site. A short description
of each rpm entry is provided along with instructions
how to build it.

The compilers suite contains CROSS compiler components and IA-64
Libraries.


CROSS compiler components

The following components are CROSS components in that
they will be built by IA-32 tools and run on IA-32 platforms
but they produce IA-64 code. They are built by doing a make 
in the corresponding 
kpro64/targia32_ia64_nodebug directories.


A sample makefile has been provided for your convenience
to build all of the CROSS components listed below.
To do a full build of the CROSS components:

          %make build -f Make.cross

NOTE**********************************************

You must NOT be in the NUE environment when running this
makefile (Make.cross).

**************************************************

Each component may also be built separately as described
below:

==================================================
Compiler Drivers

/usr/bin/sgicc  -- C   compiler driver
/usr/bin/sgiCC  -- C++ compiler driver
/usr/bin/sgi++  -- C++ compiler driver (alternate name)
/usr/bin/sgif90 -- Fortran90 compiler driver

These are links to 
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/driver

To build the driver:
% cd kpro64/targia32_ia64_nodebug/driver; gmake

==================================================
C Front-End

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/gfec

is the C compiler front-end. We have upgraded it
from gcc version 2.95 19990929 to gcc version
2.96 20000530.

To build:

% cd kpro64/targia32_ia64_nodebug/gccfe; gmake

==================================================
C++ Front-End

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/gfecc

is the C++ compiler front-end. We have upgraded
it from g++ version 2.96 20000111 (experimental)
to g++ version 2.96 20000605 (experimental).

To build:

% cd kpro64/targia32_ia64_nodebug/g++fe; gmake

==================================================
Fortran 90 Front-End

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/mfef90

is the Fortran90 compiler front-end. 

And
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/cf90.cat

Is the message catalog file for it:

To build:

% cd kpro64/targia32_ia64_nodebug/crayf90; gmake

NOTE: mfef90 does not build at this time because it
      needs an IA-32 version of f90 to compile parts
      of itself. While SGI has a prototype of such
      a compiler, it is good enough only to compile
      what is needed and thus we are not making it
      available. Mfef90 contains only code 
      developed by SGI.

==================================================

Backend

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/be
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/be.so

are the backend components

To build:

%cd kpro64/targia32_ia64_nodebug/be ; gmake


==================================================

Code Generator

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/cg.so

is the code generator

To build:
%cd kpro64/targia32_ia64_nodebug/cg ; gmake

==================================================

Global Optimizer

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/wopt.so

is the global optimizer. It is invoked when sgicc
is run with -O2.

To build:
%cd kpro64/targia32_ia64_nodebug/wopt ; gmake

==================================================

Loop Nest Optimizer

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/lno.so

is the loop nest optimizer. It is invoked when
sgicc is run with -O3.

To build:
%cd kpro64/targia32_ia64_nodebug/lno ; gmake

==================================================

Stand-Alone Inliner

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/inline

is the stand-alone inliner

To build:
%cd kpro64/targia32_ia64_nodebug/lw_inline; gmake

(lw_inline is built which is renamed to inline)

==================================================

Interprocedural analysis optimizer

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/ipa.so

is the interprocedural analysis optimizer

To build:
%cd kpro64/targia32_ia64_nodebug/ipa; gmake

==================================================

Interprocedural analysis optimizer (local summary phase)

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/ipl.so
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/ipl

is the interprocedural analysis optimizer 
(local summary phase).

To build:
%cd kpro64/targia32_ia64_nodebug/ipl; gmake

==================================================

Interprocedural analysis linker driver (ipa_link)

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/ipa_link

is the interprocedural analysis linker driver

To build:
%cd kpro64/targcygnus_ia32_ia64; ./CONFIGURE ; gmake

ld-new is created under the targcygnus_ia32_ia64/ld
directory. It is renamed to ipa_link in the INSTALL
script.

==================================================

Itanium(TM) processor target description module

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/itanium.so

is the Itanium(TM) processor target description
module.

To build:
%cd kpro64/targia32_ia64_nodebug/targ_info; gmake

==================================================

WHIRL (the sgicc intermediate language) to C converter

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/whirl2c
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/whirl2c.so

is the WHIRL (the sgicc intermediate language)
to C converter.

To build:
%cd kpro64/targia32_ia64_nodebug/whirl2c; gmake

==================================================

WHIRL to Fortran converter

/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/whirl2f
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/whirl2f.so

is the WHIRL (the sgicc intermediate language)
to Fortran converter.


To build:
%cd kpro64/targia32_ia64_nodebug/whirl2f; gmake

==================================================

WHIRL to ASCII converter

/usr/local/bin/ir_b2a

is the WHIRL (the sgicc intermediate language)
to ASCII converter utility.

To build:
%cd kpro64/targia32_ia64_nodebug/ir_tools; gmake

==================================================


IA64 NATIVE LIBRARIES


The following components are IA-64 native libraries. 
in that they will be built by the IA-64 tools. As
a result, you must do the builds under the NUE
environment.

To run under NUE, you will need to install the NUE
environment. Information about NUE can be found at:

     http://www.software.hp.com/ia64linux


To get into the NUE environment, simply type:

          %nue

A sample makefile has been provided for your convenience
to build all of the CROSS components listed below.
To do a full build of the CROSS components:

          %make build -f Make.NUE.lib

Each library may also be built separately 
by doing a make in the corresponding 
kpro64/targia64 directories as described below.

==================================================
/usr/lib/libfortran.a

is the Fortran90 runtime library:

To build:
%cd kpro64/targia64/include; gmake
%cd kpro64/targia64/libfortran; gmake

==================================================
/usr/lib/libffio.a

is the Fast Fortran I/O runtime library:

To build:
%cd kpro64/targia64/include; gmake
%cd kpro64/targia64/libu; gmake


==================================================
/usr/lib/libmsgi.a

is the SGI math library:

To build:
%cd kpro64/targia64/libmsgi; gmake

==================================================
/usr/lib/libmv.a

is the SGI math library (vector version):

To build:
%cd kpro64/targia64/libmv; gmake

==================================================
/usr/lib/libgcc.a

To build:
%cd kpro64/targia64/libgcc; gmake

==================================================
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/libstdc++.a.2.10.0

To build:
%cd kpro64/targia64/libstdc++; gmake

==================================================
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/libinstr.a

is the SGI feedback instrumentation library

To build:
%cd kpro64/targia64/libinstr; gmake

==================================================
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/ftz.o

is the SGI implementation for turning on 
FLUSH to ZERO

To build:
%cd kpro64/targia64/init; gmake

==================================================
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/lib.cat
/usr/lib/gcc-lib/ia64-sgi-linux/sgicc-1.0/lib.exp

Are already provided under:

kpro64/targia32_ia64_nodebug/temp_f90/libs
==================================================
==================================================



INSTALLING YOUR NEWLY BUILT COMPILER


An INSTALL script has been provided under kpro64.
What it does is install all of the components into their
proper locations in the NUE environment after they 
have been built.

To run it:

NOTE***********************************

Be Extremely CAREFUL using this script
as you will be overwriting the files
from the rpm's that you installed

***************************************

       # INSTALL


The spec file for creating the sgicc rpms has also
been provided. After you have rebuilt and re-installed
the sgicc compilers using the script above, you can
create the pro64 rpm by doing:

       # rpm -bb pro64.rpm