Jikes RVM

Chapter 18
Preliminaries

18.1 Getting MMTk and Jikes RVM and Eclipse working

1. Download the latest Jikes RVM release (or use git HEAD)
2. Ensure you can Build and Run Jikes RVM.
3. Ensure you can build and run the BaseBaseNoGC configuration (build with: bin/buildit localhost BaseBaseNoGC, run with something like:
   dist/BaseBaseNoGC_ia32-linux/rvm HelloWorld

   Note that this configuration does not perform garbage collection so can only run small benchmarks which do not exhaust available memory. This configuration will be used as the basis for the tutorial.

4. Ensure that your source is successfully imported (and editable) within an IDE such as Eclipse.
5. Set up an Eclipse Run configuration for the NoGC plan using the MMTk Test Harness.

18.2 Creating The Base Tutorial Collector

1. Copy the org.mmtk.plan.nogc package to org.mmtk.plan.tutorial (copy and paste the package in Eclipse).
2. Rename the constituent classes from NoGC* to Tutorial* (use Refactor → Rename on each class within the org.mmtk.plan.tutorial package in Eclipse).
3. Edit file class org.mmtk.harness.PlanSpecificConfig, and add the following lines
   register(new PlanSpecific("org.mmtk.plan.tutorial.Tutorial").addExpectedSpaces("default"), "Tutorial");

   to the static initializer (look for ”NoGC”).

4. Modify your MMTk Harness Eclipse Run Configuration to use the new Plan (the name of the plan is the second parameter to the ”register” method you inserted above), and click ’Run’ to run it.
5. Go to build/configs in the source directory and copy BaseBaseNoGC.properties to BaseBaseTutorial.properties. Then edit BaseBaseTutorial.properties and change config.mmtk.plan to org.mmtk.plan.tutorial.Tutorial and save the file.
6. Build and run the resulting collector.
   Build with something like:
   bin/buildit localhost BaseBaseTutorial

   run with something like:

   dist/BaseBaseTutorial_ia32-linux/rvm HelloWorld