From d26a2a0ff308f1a8469d9c712184b7620c2934f8 Mon Sep 17 00:00:00 2001 From: Yi Lin Date: Wed, 17 May 2023 03:21:43 +0000 Subject: [PATCH 1/2] Update README to mention how to set a GC plan --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 6e5c071e..72134108 100644 --- a/README.md +++ b/README.md @@ -209,6 +209,10 @@ $ VO_BIT=1 make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$P ## Test +We support most MMTk GC plans in OpenJDK, such as `SemiSpace`, `Immix`, `GenImmix`, `StickyImmix`, `GenCopy`, `MarkCompact`, `MarkSweep`, `PageProtect`, and `NoGC`. +When you run with the OpenJDK build from previous steps, you can choose one of the plans by setting an environment variable `MMTK_PLAN`. In the following examples, we use +the generational immix plan, `GenImmix`. + ### Run HelloWorld (without MMTk) ```console @@ -219,7 +223,7 @@ class HelloWorld { } } $ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/javac HelloWorld.java -$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java HelloWorld +$ MMTK_PLAN=GenImmix ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java HelloWorld Hello World! ``` @@ -233,7 +237,7 @@ $ wget https://sourceforge.net/projects/dacapobench/files/9.12-bach-MR1/dacapo-9 Run a DaCapo benchmark (e.g. `lusearch`): ```console -$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap -Xms512M -Xmx512M -jar ./dacapo-9.12-MR1-bach.jar lusearch +$ MMTK_PLAN=GenImmix ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap -Xms512M -Xmx512M -jar ./dacapo-9.12-MR1-bach.jar lusearch Using scaled threading model. 24 processors detected, 24 threads used to drive the workload, in a possible range of [1,64] ===== DaCapo 9.12-MR1 lusearch starting ===== 4 query batches completed From 05f704388ed5dfa3b2cc363e3212a0f137ced307 Mon Sep 17 00:00:00 2001 From: Yi Lin Date: Mon, 16 Oct 2023 23:29:23 +0000 Subject: [PATCH 2/2] Link to mmtk-core doc about a list of plans --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4a0f58b4..42d665c7 100644 --- a/README.md +++ b/README.md @@ -209,9 +209,9 @@ $ VO_BIT=1 make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$P ## Test -We support most MMTk GC plans in OpenJDK, such as `SemiSpace`, `Immix`, `GenImmix`, `StickyImmix`, `GenCopy`, `MarkCompact`, `MarkSweep`, `PageProtect`, and `NoGC`. -When you run with the OpenJDK build from previous steps, you can choose one of the plans by setting an environment variable `MMTK_PLAN`. In the following examples, we use -the generational immix plan, `GenImmix`. +We support all the MMTk GC plans in OpenJDK. A full list of MMTk plans can be found [here](https://docs.mmtk.io/api/mmtk/util/options/enum.PlanSelector.html). +When you run with the OpenJDK build from previous steps, you can choose one of the plans by setting an environment variable `MMTK_PLAN` to one of the plan names. +In the following examples, we use the generational immix plan, `GenImmix`. ### Run HelloWorld (without MMTk)