Install SUIF2

Wenrui Gong
(Revised by Brian DeRenzi)
Department of Electrical and Computer Engineering
University of California, Santa Barbara
Email: gong@engineering.ucsb.edu

Jun 07, 2005

1  Preparing your systems

The SUIF2 packages was initially developed and released from 1999. Originally, it could be successfully compiled using gcc 2.91, without any patches. When gcc was upgraded to 2.96, a couple of patches became necessary to enable SUIF2 to be compiled successfully. Until now, there was no known methods to install SUIF2 packages on machines using gcc 3.x.
If at any time you encounter errors, please start over and make sure that you follow all steps carefully.
Before starting to install SUIF2, we must make sure that a useable gcc compiler (2.96 or less) exists on the machine.
RedHat 7.3
RedHat 7.3 uses gcc 2.96 as its default compiler. If users do not want to patch the SUIF package, they can choose the egcs compiler, which could be found in the RedHat 7.3 release with the name starting with "compat-egcs" or " compat-glibc". This compiler is gcc 2.91;
RedHat 9
RedHat 9 uses gcc 3.2.2 as its default compiler. Users should install gcc 2.96 in order to compile SUIF2. gcc 2.96 could be installed by installing the following rpm files: "compat-gcc-7.3-"x, "compat-gcc-c++-7.3-"x, "compat-glibc-"x, and "compat-libstdc++-7.3-"x. All of those files could be found in the RedHat 9 release. It is best (especially for the Fedora Core systems) to install the precompiled binaries instead of trying to build a fresh copy from source. NOTE to get the c2suif to work properly, you need to edit the script and modify the include path, changing the string '-I/usr/lib/gcc-lib/i386-redhat-linux/egcs-2.91.66/include' to ;-I/usr/lib/gcc-lib/i386-redhat-linux7/2.96/include/'
Fedora Core 2/3
FC 2+ also use gcc 3.x. Users should take the same steps as those for RedHat 9 to install gcc 2.96 compiler. NOTE Fedora Core 4 may not work using this method. At this time FC4 has not been tested.
RHEL 3
RHEL 3 also uses gcc 3.x. Users should take the same steps as those for RedHat 9 to install gcc 2.96 compiler.
For those people, who are using other releases, or could find original release discs. Please go to www.rpmfind.net, where most rpm files could be found, and search "compat-gcc" to get those compat-gcc-7.3- packages.

2  Install SUIF2

Below is a step-by-step guide for installing SUIF2 on RedHat 9, on which gcc 2.96 were installed, and could be accessed via /usr/bin/gcc296 and /usr/bin/g++296.
  1. Download the SUIF2 release from the Stanford SUIF website
  2. Execute the following command in your home directory. A nci directory will be created.
    [gong@ares gong] tar -xvzf basesuif-2.2.0-4.tar.gz
  3. Execute the install script:
    [gong@ares gong] cd nci
    [gong@ares nci] /bin/sh ./install --with-CC=/usr/bin/gcc296 \
    > --with-CXX=/usr/bin/g++296 --with-CXXLINK=/usr/bin/g++296
    Three files will be created in the nci directory. They are Makefile.std, nci_setup.csh and nci_setup.sh.
  4. Setup the object directories bin and solib by executing
    [gong@ares nci] make setup
  5. Import SUIF environmental variables
    [gong@ares nci] . ./nci_setup.sh
  6. Patches your SUIF2 releases. In order to be compiled using gcc 2.96, a couple of patches should be applied. They are gcc296.patch, and extras.patch.
    [gong@ares nci] patch -p1 < ./patches/gcc296.patch
    [gong@ares nci] patch -p1 < ./patches/extras.patch
  7. Compile the SUIF2 package.
    [gong@ares nci] make
The above guide is based on a system with bash. For those using csh or others, please use correspond commands import environmental variables.


File translated from TEX by TTH, version 3.64.
On 29 Nov 2004, 02:35.