org.jikesrvm.tools.oth

Class OptTestHarness

java.lang.Object

org.jikesrvm.tools.oth.OptTestHarness

class OptTestHarness
extends Object

A test harness for the optimizing compiler.

The role of this class is to allow the optimizing compiler to be run as an "application" to enabling selective testing and debugging of the optimizing compiler. For example, the following command line:

rvm -X:h=100 org.jikesrvm.tools.oth.OptTestHarness -oc:O2 -oc:phases=true -class hanoi -er hanoi run  -

invokes the opt compiler at Opt level 2 and phases=true to compile the class hanoi, it then executes the run method of class hanoi.

Any command that can be given to the optimizing compiler via -X:irc:<cmd> can be given to the optimizing compiler by org.jikesrvm.tools.oth.OptTestHarness via -oc:<cmd>. In addition, the org.jikesrvm.tools.oth.OptTestHarness supports the following commands:

 -useBootOptions           Use the same OptOptions as the bootimage compiler.
 -longcommandline <filename>    Read commands (one per line) from a file
 +baseline                      Switch default compiler to baseline
 -baseline                      Switch default compiler to optimizing
 -load  <class    >             Load a class
 -class <class>                 Load a class and compile all its methods
 -method <class> <method> [-|<descrip>] Compile method with default compiler
 -methodOpt <class> <method> [-|<descrip>] Compile method with opt compiler
 -methodBase <class> <method> [-|<descrip>] Compile method with base compiler
 -er <class> <method> [-|<descrip>] {args} Compile with default compiler and execute a method
 -performance                   Show performance results
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	OptTestHarness.Performance

Field Summary

Fields

Modifier and Type	Field and Description
(package private) boolean	addCallbackForPerformancePrintout
(package private) Vector<RVMMethod>	baselineMethodVector
(package private) ClassLoader	cl
(package private) boolean	disableClassloading
(package private) boolean	executeMainMethod
(package private) boolean	executeWithReflection
private FileAccess	fileAccess
(package private) String[]	mainArgs
(package private) RVMClass	mainClass
(package private) OptOptions	options
(package private) Vector<RVMMethod>	optMethodVector
(package private) Vector<OptOptions>	optOptionsVector
private OptTestHarnessOutput	output
(package private) OptTestHarness.Performance	perf Record and show performance of executed methods, if any
(package private) boolean	printCodeAddress Should we print the address of compiled methods (useful for debugging)
(package private) Object[]	reflectMethodArgs
(package private) Vector<Object[]>	reflectMethodArgsVector
(package private) Vector<RVMMethod>	reflectMethodVector
(package private) Method	reflectoid
(package private) Vector<Method>	reflectoidVector
(package private) boolean	useBaselineCompiler Default value for for compiling opt/baseline

Constructor Summary

Constructors

Constructor and Description
OptTestHarness(OptTestHarnessOutput output, OptOptions optOptions, FileAccess fileAccess)

Method Summary

Modifier and Type	Method and Description
private static String	addrToString(Address addr)
private Object	attemptToInvokeDefaultConstructor(RVMMethod method)
(package private) static String	compiledMethodMessage(NormalMethod method)
private void	compileMethodsInVector()
(package private) static String	convertToClassName(String s)
private void	duplicateOptions()
(package private) static String	endOfExecutionString(RVMMethod method)
private void	executeCommand()
(package private) RVMMethod	findDeclaredOrFirstMethod(RVMClass klass, String methname, String methdesc) Finds a method, either one with a given descriptor or the first matching one in in the given class.
(package private) RVMClass	loadClass(String s)
static void	main(String[] args)
void	mainMethod(String[] args)
(package private) int	parseMethodArgs(TypeReference[] argDesc, String[] args, int i, Object[] methodArgs)
(package private) void	printFormatString()
private void	processClass(RVMClass klass, OptOptions opts)
private void	processMethod(RVMMethod method, OptOptions opts)
private void	processMethod(RVMMethod method, OptOptions opts, boolean isBaseline)
private void	processOptionString(String[] args)
(package private) static String	resultString(Object result)
(package private) static String	startOfExecutionString(RVMMethod method)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

disableClassloading

boolean disableClassloading

executeWithReflection

boolean executeWithReflection

executeMainMethod

boolean executeMainMethod

useBaselineCompiler

boolean useBaselineCompiler

Default value for for compiling opt/baseline

printCodeAddress

boolean printCodeAddress

Should we print the address of compiled methods (useful for debugging)

addCallbackForPerformancePrintout

boolean addCallbackForPerformancePrintout

perf

OptTestHarness.Performance perf

Record and show performance of executed methods, if any

cl

ClassLoader cl

optMethodVector

Vector<RVMMethod> optMethodVector

optOptionsVector

Vector<OptOptions> optOptionsVector

baselineMethodVector

Vector<RVMMethod> baselineMethodVector

reflectoid

Method reflectoid

reflectMethodArgs

Object[] reflectMethodArgs

reflectoidVector

Vector<Method> reflectoidVector

reflectMethodVector

Vector<RVMMethod> reflectMethodVector

reflectMethodArgsVector

Vector<Object[]> reflectMethodArgsVector

mainClass

RVMClass mainClass

mainArgs

String[] mainArgs

output

private final OptTestHarnessOutput output

fileAccess

private final FileAccess fileAccess

options

OptOptions options

Constructor Detail

OptTestHarness

OptTestHarness(OptTestHarnessOutput output,
               OptOptions optOptions,
               FileAccess fileAccess)

Method Detail

parseMethodArgs

int parseMethodArgs(TypeReference[] argDesc,
                    String[] args,
                    int i,
                    Object[] methodArgs)

findDeclaredOrFirstMethod

RVMMethod findDeclaredOrFirstMethod(RVMClass klass,
                                    String methname,
                                    String methdesc)

Finds a method, either one with a given descriptor or the first matching one in in the given class.

Parameters:

klass - the class to search

methname - the method's name

methdesc - a descriptor of the method's signature if a specific method is desired or "-" to find the first method with the given name

Returns:

the method or null if no method was found

loadClass

RVMClass loadClass(String s)
            throws ClassNotFoundException

Throws:

ClassNotFoundException

convertToClassName

static String convertToClassName(String s)

printFormatString

void printFormatString()

processClass

private void processClass(RVMClass klass,
                          OptOptions opts)

processMethod

private void processMethod(RVMMethod method,
                           OptOptions opts)

processMethod

private void processMethod(RVMMethod method,
                           OptOptions opts,
                           boolean isBaseline)

processOptionString

private void processOptionString(String[] args)

duplicateOptions

private void duplicateOptions()

compiledMethodMessage

static String compiledMethodMessage(NormalMethod method)

compileMethodsInVector

private void compileMethodsInVector()

executeCommand

private void executeCommand()
                     throws InvocationTargetException,
                            IllegalAccessException

Throws:

InvocationTargetException

IllegalAccessException

attemptToInvokeDefaultConstructor

private Object attemptToInvokeDefaultConstructor(RVMMethod method)

resultString

static String resultString(Object result)

endOfExecutionString

static String endOfExecutionString(RVMMethod method)

startOfExecutionString

static String startOfExecutionString(RVMMethod method)

main

public static void main(String[] args)
                 throws InvocationTargetException,
                        IllegalAccessException

Throws:

InvocationTargetException

IllegalAccessException

mainMethod

public void mainMethod(String[] args)
                throws InvocationTargetException,
                       IllegalAccessException

Throws:

InvocationTargetException

IllegalAccessException

addrToString

private static String addrToString(Address addr)