com.oracle.svm.core.thread

Class VMOperation

java.lang.Object

com.oracle.svm.core.thread.VMOperation

Direct Known Subclasses:

JavaVMOperation, NativeVMOperation

public abstract class VMOperation
extends Object

Only one thread at a time can execute VMOperations (see VMOperationControl). While executing a VM operation, it is guaranteed that the yellow zone is enabled and that recurring callbacks are paused. This is necessary to avoid unexpected exceptions while executing critical code.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	VMOperation.SystemEffect

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	VMOperation(String name, VMOperation.SystemEffect systemEffect)

Method Summary

Modifier and Type	Method and Description
protected void	execute(NativeVMOperationData data)
boolean	getCausesSafepoint()
String	getName()
protected abstract org.graalvm.nativeimage.IsolateThread	getQueuingThread(NativeVMOperationData data)
static void	guaranteeGCInProgress(String message)
static void	guaranteeInProgress(String message) Check that there is a VMOperation in progress.
static void	guaranteeInProgressAtSafepoint(String message)
static void	guaranteeNotInProgress(String message) Check that there is not a VMOperation in progress.
protected boolean	hasWork(NativeVMOperationData data) Used to determine if a VM operation must be executed or if it can be skipped.
protected abstract boolean	isFinished(NativeVMOperationData data)
protected boolean	isGC()
static boolean	isGCInProgress()
static boolean	isInProgress() Returns true if the current thread is currently executing a VM operation.
static boolean	isInProgressAtSafepoint() Returns true if the current thread is currently executing a VM operation that causes a safepoint.
protected abstract void	operate(NativeVMOperationData data)
protected abstract void	setFinished(NativeVMOperationData data, boolean value)
protected abstract void	setQueuingThread(NativeVMOperationData data, org.graalvm.nativeimage.IsolateThread value)

Methods inherited from class java.lang.Object

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

Constructor Detail

VMOperation

protected VMOperation(String name,
                      VMOperation.SystemEffect systemEffect)

Method Detail

getName

public final String getName()

isGC

protected boolean isGC()

getCausesSafepoint

public final boolean getCausesSafepoint()

execute

protected final void execute(NativeVMOperationData data)

isInProgress

public static boolean isInProgress()

Returns true if the current thread is currently executing a VM operation.

isInProgressAtSafepoint

public static boolean isInProgressAtSafepoint()

Returns true if the current thread is currently executing a VM operation that causes a safepoint.

isGCInProgress

public static boolean isGCInProgress()

guaranteeInProgress

public static void guaranteeInProgress(String message)

Check that there is a VMOperation in progress.

guaranteeNotInProgress

public static void guaranteeNotInProgress(String message)

Check that there is not a VMOperation in progress.

guaranteeInProgressAtSafepoint

public static void guaranteeInProgressAtSafepoint(String message)

guaranteeGCInProgress

public static void guaranteeGCInProgress(String message)

hasWork

protected boolean hasWork(NativeVMOperationData data)

Used to determine if a VM operation must be executed or if it can be skipped. Regardless of the VMOperation.SystemEffect that was specified for the VM operation, this method might be called before or after a safepoint was initiated.

getQueuingThread

protected abstract org.graalvm.nativeimage.IsolateThread getQueuingThread(NativeVMOperationData data)

setQueuingThread

protected abstract void setQueuingThread(NativeVMOperationData data,
                                         org.graalvm.nativeimage.IsolateThread value)

isFinished

protected abstract boolean isFinished(NativeVMOperationData data)

setFinished

protected abstract void setFinished(NativeVMOperationData data,
                                    boolean value)

operate

protected abstract void operate(NativeVMOperationData data)