org.jikesrvm.compilers.opt.driver
Class OptimizingCompiler

java.lang.Object
  org.jikesrvm.compilers.opt.driver.OptimizingCompiler

All Implemented Interfaces:

Callbacks.StartupMonitor

public final class OptimizingCompiler
extends Object
implements Callbacks.StartupMonitor

The main driver of the Compiler.

External drivers are responsible for providing the policies; the role of this class is simply to take a CompilationPlan and execute it.

Currently, this class is invoked from four clients:

• (1) Command line: ExecuteOptCode
• (2) BootImageWriting: BootImageCompiler.compile (optimizing version)
• (3) RuntimeCompiler: RuntimeCompiler.compile (optimizing version)
• (4) AOS: Compilation threads execute controller plans by invoking the opt compiler.

Clients are responsible for ensuring that:

• (1) the VM has been initialized
• (2) Compiler.init has been called before the first opt compilation

This class is not meant to be instantiated.

appStarted

private static boolean appStarted

indicate when the application has started

isInitialized

private static boolean isInitialized

Has the optimizing compiler been initialized?

OptimizingCompiler

private OptimizingCompiler()

Prevent instantiation by clients

init

public static void init(OptOptions options)

Prepare compiler for use.

Parameters:

options - options to use for compilations during initialization

notifyStartup

public void notifyStartup()

Description copied from interface: Callbacks.StartupMonitor

Notify the monitor that the VM has started up.

Specified by:

notifyStartup in interface Callbacks.StartupMonitor

getAppStarted

public static boolean getAppStarted()

setAppStarted

public static void setAppStarted()

setBootOptions

public static void setBootOptions(OptOptions options)

Set up option used while compiling the boot image

Parameters:

options - the options to set

initializeStatics

private static void initializeStatics()

Call the static init functions for the Compiler subsystems

isInitialized

public static boolean isInitialized()

Has the optimizing compiler been initialized?

reset

static void reset()

Reset the optimizing compiler

compile

public static CompiledMethod compile(CompilationPlan cp)

Invoke the opt compiler to execute a compilation plan.

Parameters:

cp - the compilation plan to be executed

Returns:

the CompiledMethod object that is the result of compilation

report

public static void report(String what)

Debugging aid.

Parameters:

what - a string message to print

report

public static void report(String what,
                          long time)

Debugging aid.

Parameters:

what - a string message to print

time - a timestamp to print

header

public static void header(String what,
                          NormalMethod method)

Debugging aid to be called before printing the IR

Parameters:

what - a string message to print

method - the method being compiled

bottom

public static void bottom(String what,
                          NormalMethod method)

Debugging aid to be called after printing the IR

Parameters:

what - a string message to print

method - the method being compiled

printInstructions

public static void printInstructions(IR ir,
                                     String message)

Print the IR along with a message

Parameters:

ir -

message -

printMethodMessage

private static void printMethodMessage(NormalMethod method,
                                       OptOptions options)

Print a message of a method name

Parameters:

method -

options -

fail

private static void fail(Throwable e,
                         NormalMethod method)

Abort a compilation with an error.

Parameters:

e - The exception thrown by a compiler phase

method - The method being compiled

checkSupported

private static void checkSupported(NormalMethod method,
                                   OptOptions options)

Check whether opt compilation of a particular method is supported. If not, throw a non-fatal run-time exception.