Testing race conditions in HeapStats and HotSpot VM

This repostiory includes a framework and test cases for testing race conditions in HeapStats and HotSpot VM.

Usage

1. set HEAPSTATS_LIB environment variables to the heapstats shared object file
2. Add directories of test cases to testlist.txt
3. Run testcase.sh

$ bash testcase.sh <file>

OR

$ bash testcase.sh <--clean|--result> <file>

<> are optional.

• file: specify a test list file. You can ommit it if you aim to use testlist.txt
• --clean: clear all test cases' results.
• --result: show a summary of all test cases' result (not run test).

When you use --clean and --result, you can also specify test cases by file.

command example:

export HEAPSTATS_LIB=/usr/lib64/heapstats/libheapstats-2.1.so.3
$ bash testcase.sh testlist.txt

Environment

• HeapStats : 2.1.*
• python : 2.*
• OS : Fedora

Other Notice

VMDeath/DataDumpRequest may fail because of JVM bug. If so, delete the test.

rm -rf VMDeath/DataDumpRequest

How to add new tase cases for testing race conditions.

1. Create a directory.
2. Create a buildenv.sh to set environment for testing.
3. Write test.py and testcase such like as existing test codes.

buildenv.sh

buildenv.sh requires the following.

• CLASSPATH
  • Classpath to build test code.
  • Should write an absolute path.
• MAINCLASS
  • A main class of test code.
• JAVA_OPTS
  • Options for launching java process.
• HEAPSTATS_CONF
  • Path to heapstats.conf for testing
• Command line to build test code.

test.py

• Import common.py on parent directory
• Use common.initialize() method with passing break point names and break condition as arguments

Result

• test.py will touch test-succeeded when the test passed correctly. Otherwise, will touch test-failed or test-timeout.
• testcase.sh --result <file> will show a summary of specified test cases's result as below.

Test summary:
  Testcase1: succeeded
  Testcase2: succeeded
  Testcase3: failed
  :