org.jikesrvm.adaptive.controller

Class ControllerThread

java.lang.Object

org.jikesrvm.scheduler.SystemThread

org.jikesrvm.adaptive.controller.ControllerThread

public final class ControllerThread
extends SystemThread

This class implements the controller thread. This entity is the brains of the adaptive optimization system. It communicates with the runtime measurements subsystem to instruct and gather profiling information. It also talks to the compilation threads to generate

• instrumented executables;
• optimized executables;
• static information about a method; or
• all of the above.

Field Summary

Fields

Modifier and Type	Field and Description
private DynamicCallGraphOrganizer	dcgOrg There are several ways in which a dcg organizer might be created; keep track of it once it is created so that we only create one instance of it.
private SoftLatch	sentinel

Fields inherited from class org.jikesrvm.scheduler.SystemThread

rvmThread

Constructor Summary

Constructors

Constructor and Description
ControllerThread(SoftLatch sentinel) constructor

Method Summary

Modifier and Type	Method and Description
void	aboutToWait() Called when the controller thread is about to wait on Controller.controllerInputQueue
private void	controllerInitDone()
private void	createCompilationThread() Creates and schedules the compilationThread.
private void	createDynamicCallGraphOrganizer() Create a dynamic call graph organizer of one doesn't already exist
private void	createOrganizerThreads() Create the organizerThreads and schedule them
private void	createProfilers() Create profiling entities that are independent of whether or not adaptive recompilation is actually enabled.
void	doneWaiting() Called when the controller thread is woken after waiting on Controller.controllerInputQueue
boolean	earlyRestrictOptLevels() If we're going to be gathering a dynamic call graph, then we don't want to let the opt compiler compile anything above O0 until we have some initial data in the call graph to work with.
static void	report() Final report
void	run() This method is the entry point to the controller, it is called when the controllerThread is created.

Methods inherited from class org.jikesrvm.scheduler.SystemThread

getRVMThread, start, stop

Methods inherited from class java.lang.Object

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

Field Detail

sentinel

private final SoftLatch sentinel

dcgOrg

private DynamicCallGraphOrganizer dcgOrg

There are several ways in which a dcg organizer might be created; keep track of it once it is created so that we only create one instance of it.

Constructor Detail

ControllerThread

ControllerThread(SoftLatch sentinel)

constructor

Parameters:

sentinel - An object to signal when up and running

Method Detail

run

public void run()

This method is the entry point to the controller, it is called when the controllerThread is created.

Specified by:

run in class SystemThread

controllerInitDone

private void controllerInitDone()

aboutToWait

public void aboutToWait()

Called when the controller thread is about to wait on Controller.controllerInputQueue

doneWaiting

public void doneWaiting()

Called when the controller thread is woken after waiting on Controller.controllerInputQueue

earlyRestrictOptLevels

public boolean earlyRestrictOptLevels()

If we're going to be gathering a dynamic call graph, then we don't want to let the opt compiler compile anything above O0 until we have some initial data in the call graph to work with. The goal of this restriction is to avoid making early bad decisions that we don't get a chance to revisit because methods get to maxOptLevel too quickly.

Returns:

true if we need to restrict the optimization levels to ensure that we don't make bad optimization decisions, false if no restriction is necessary

createCompilationThread

private void createCompilationThread()

Creates and schedules the compilationThread.

createDynamicCallGraphOrganizer

private void createDynamicCallGraphOrganizer()

Create a dynamic call graph organizer of one doesn't already exist

createProfilers

private void createProfilers()

Create profiling entities that are independent of whether or not adaptive recompilation is actually enabled.

createOrganizerThreads

private void createOrganizerThreads()

Create the organizerThreads and schedule them

report

public static void report()

Final report