########################################################################

# This file contains example scripts and property files for collecting

# code coverage data of the RMI regression suite.

#

# Since many RMI regression tests spawn child VMs (either directly

# or through activation), special support is required for setting

# command line options and arguments needed by jcov - the code coverage

# instrumentation and collection tool. This special support is provided

# by properties in the test.props file. If a file named ../../test.props

# exists (assuming the working directory is "<path>/JTwork/scratch", this

# will find "<path>/test.props"), then it will be used by test library

# code that spawns VMs or instances of rmid. See the example test.props

# file below for the properties that may be defined.

########################################################################

# The following is a script used to execute RMI regression tests

# on Solaris and collect code coverage data.

#!/bin/ksh

export JAVA_HOME=<path to special JDK jcov instrumented build>

export JT_HOME=<path to special JTREG build with jcov hooks>

export CLASSPATH=.:${JT_HOME}/javatest.jar

export OPTS="-Xms256m -Xmx256m -XX:+UseUnsupportedDeprecatedJVMPI -XX:+EnableJVMPIInstructionStartEvent -XX:-UseFastEmptyMethods -XX:-UseFastAccessorMethods -timeoutFactor:4"

export TESTBASE=/files/<JDK workspace>/test

${JT_HOME}/solaris/bin/jtreg -Xrunjcov:file=/files/rmi.jcov ${OPTS} -va -w:/tmp/JT -r:/tmp/JTreport -jdk:${JAVA_HOME} ${TESTBASE}

########################################################################

# The following section is an example test.props property file

# used for collecting code coverage data for JDK 1.6. These properties

# are currently supported:

# jcov.options are the jcov options that should be added to VMs

# system properties

# rmid.jcov.args are the jcov options that should be added as

# arguments to rmid command line; effectively, these

# are identical to jcov.options but each option is

# prefaced with '-C'

# jcov.sleep.multiplier is an integer that will be multiplied by

# various wait times in the test library; the

# default value used is '1'

jcov.options=-Xrunjcov:file=/files/rmi.jcov -Xms256m -Xmx256m -XX:+UseUnsupportedDeprecatedJVMPI -XX:+EnableJVMPIInstructionStartEvent -XX:-UseFastEmptyMethods -XX:-UseFastAccessorMethods

rmid.jcov.args=-C-Xrunjcov:file=/files/rmi.jcov -C-Xms256m -C-Xmx256m -C-XX:+UseUnsupportedDeprecatedJVMPI -C-XX:+EnableJVMPIInstructionStartEvent -C-XX:-UseFastEmptyMethods -C-XX:-UseFastAccessorMethods

jcov.sleep.multiplier=3

########################################################################

# The following section is an example script that generates the

# jcov report. The important documentation here is the list of Java

# packages and classes that are included in the RMI coverage report.

#!/bin/ksh

export CLASSPATH=<path to jcov.jar>

export SRCS=<path to sources of the instrumented JDK build>

java com.sun.tdk.jcov.MergerMain <path to jcov 'A' template for the build>template_a.jcov /files/rmi.jcov

java -Xms256m -Xmx512m com.sun.tdk.jcov.RepGenMain -fmt=html_ns -src_root=${SRCS} \

-include=java.rmi.* \

-include=java.rmi.activation.* \

-include=java.rmi.dgc.* \

-include=java.rmi.registry.* \

-include=java.rmi.server.* \

-include=sun.rmi.log.* \

-include=sun.rmi.registry.* \

-include=sun.rmi.runtime.* \

-include=sun.rmi.server.* \

-include=sun.rmi.transport.* \

-include=sun.rmi.transport.proxy.* \

-include=sun.rmi.transport.tcp.* \

-include=java.lang.reflect.Proxy \

-include=sun.misc.ProxyGenerator \

-exclude=com.sun.rmi.rmid.* \

-exclude=sun.rmi.rmic.* \

-exclude=javax.rmi.ssl.* \

java.jcov