MMTk port to SSCLI -> Documentation -> Requirements for RMTk

Requirements for RMTk

This document describes the environment required to build and run RMTk.

Operating system

RMTk requires FreeBSD 5.2.1 on an Intel machine.

During the installation, when prompted to choose a distribution, select X-Developer. When asked if you would like to install the BSD Ports collection, select Yes. Configure the network devices appropriately for your network, so that the machine can access the Internet. Select the option to browse the FreeBSD package collection and install the following packages:

• editors -> emacs-21.2_2
• shells -> bash-2.05b.004

When creating a user account, set the login shell to /usr/local/bin/bash.

Notes: According to Shared Source CLI Essentials FreeBSD Version 4.7 is recommend for building Rotor under FreeBSD. However, RMTk has only been built on FreeBSD 5.2.1. RMTk incorporates Jan Kotas' updates to make Rotor build on FreeBSD 5.2. I have not looked at running RMTk under Windows or Mac OS X (the other platforms Rotor supports). Configuring access to the Internet is important, as the install scripts for the BSD ports automatically download distribution files from the Internet.

Software

RMTk requires the installation of some packages, including a patched version of GCC. These packages are listed below with step-by-step installation instructions.

• Blackdown Java Development Kit 1.4

  As root:

  cd /usr/ports/java/linux-blackdown-jdk14
  make install clean
  

• GCC 3.3 (patched)

  Download gcc33patch.tar.gz (1.3 KiB, a patch for a bug in GCC that affects RMTk.

  As root:

  cd /usr/ports/lang/gcc33/files
  tar xzf download_directory/gcc33patch.tar.gz
  cd ..
  make install clean
  

• ANTLR 2.7.2

  Download antlr-2.7.2.tar.gz (1.48 MiB)

  As each RMTk user:

  cd
  tar xzf download_directory/antlr-2.7.2.tar.gz antlr-2.7.2/antlr.jar
  

Checks

To check that the required packages have been installed, use the following commands

• Blackdown Java Development Kit 1.4

  $ /usr/local/linux-blackdown-jdk1.4.1/bin/java -version
  java version "1.4.1"
  Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.1-01)
  Java HotSpot(TM) Client VM (build Blackdown-1.4.1-01, mixed mode)
  

  The output will include Java HotSpot(TM) Client VM warning: Cannot read /proc/self/stat. This is normal.

• GCC 3.3 (patched)

  $ gcj33 --version
  gcj33 (GCC) 3.3.3 20031103 (prerelease) [FreeBSD]
  Copyright (C) 2003 Free Software Foundation, Inc.
  This is free software; see the source for copying conditions.  There is NO
  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  

  To check that the patch was applied, see Checking GCC 3.3 fix.

• ANTLR 2.7.2

  $ cd
  $ md5 antlr-2.7.2/antlr.jar
  MD5 (antlr-2.7.2/antlr.jar) = a73459120df5cadf75eaa98453433a01
  

Author: Andrew Gray; Date: 13 December 2004