com.oracle.svm.core.posix.thread

Class PosixVMThreads

java.lang.Object

com.oracle.svm.core.thread.VMThreads

com.oracle.svm.core.posix.thread.PosixVMThreads

public final class PosixVMThreads
extends VMThreads

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.svm.core.thread.VMThreads

VMThreads.OSThreadHandle, VMThreads.OSThreadId, VMThreads.StatusSupport

Field Summary

Fields inherited from class com.oracle.svm.core.thread.VMThreads

IsolateTL, OSThreadHandleTL, THREAD_LIST_CONDITION, THREAD_MUTEX

Constructor Summary

Constructors

Constructor and Description
PosixVMThreads()

Method Summary

Modifier and Type	Method and Description
org.graalvm.nativeimage.IsolateThread	allocateIsolateThread(int isolateThreadSize) Allocate native memory for a IsolateThread.
void	failFatally(int code, org.graalvm.nativeimage.c.type.CCharPointer message) Report a fatal error to the user and exit.
void	freeIsolateThread(org.graalvm.nativeimage.IsolateThread thread) Free the native memory allocated by VMThreads.allocateIsolateThread(int).
protected VMThreads.OSThreadHandle	getCurrentOSThreadHandle() Returns a platform-specific handle to the current thread.
protected VMThreads.OSThreadId	getCurrentOSThreadId() Returns a unique identifier for the current thread.
protected boolean	initializeOnce() Invoked exactly once early during the startup of an isolate.
protected void	joinNoTransition(VMThreads.OSThreadHandle osThreadHandle) Executes a non-multithreading-safe low-level (i.e., non-Java-level) join operation on the given native thread.

Methods inherited from class com.oracle.svm.core.thread.VMThreads

attachThread, cleanupExitedOsThreads, detachThread, detachThreads, ensureInitialized, findIsolateThreadforCurrentOSThread, firstThread, firstThreadUnsafe, guaranteeOwnsThreadMutex, isInitialized, isTearingDown, nextThread, setTearingDown, singleton, tearDown

Methods inherited from class java.lang.Object

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

Constructor Detail

PosixVMThreads

public PosixVMThreads()

Method Detail

getCurrentOSThreadHandle

protected VMThreads.OSThreadHandle getCurrentOSThreadHandle()

Description copied from class: VMThreads

Returns a platform-specific handle to the current thread. This handle can for example be used for joining a thread. Depending on the specific platform, it can be necessary to explicitly free the handle when it is no longer used. To avoid leaking operating system resources, this method should therefore only be called in VMThreads.attachThread(IsolateThread), when VMThreads.OSThreadHandleTL is not set yet.

Specified by:

getCurrentOSThreadHandle in class VMThreads

getCurrentOSThreadId

protected VMThreads.OSThreadId getCurrentOSThreadId()

Description copied from class: VMThreads

Returns a unique identifier for the current thread.

Specified by:

getCurrentOSThreadId in class VMThreads

joinNoTransition

protected void joinNoTransition(VMThreads.OSThreadHandle osThreadHandle)

Description copied from class: VMThreads

Executes a non-multithreading-safe low-level (i.e., non-Java-level) join operation on the given native thread. If the thread hasn't yet exited on the operating system level, this method blocks until the thread exits on the operating system level. After successfully joining a thread, the operating system may free resources and recycle/reuse the given thread id for other newly started threads. As this method is marked as uninterruptible, it may only be used for joining threads that were already detached from SVM. Otherwise, this could result in deadlocks.

Specified by:

joinNoTransition in class VMThreads

initializeOnce

protected boolean initializeOnce()

Description copied from class: VMThreads

Invoked exactly once early during the startup of an isolate. Subclasses can perform initialization of native OS resources.

Specified by:

initializeOnce in class VMThreads

allocateIsolateThread

public org.graalvm.nativeimage.IsolateThread allocateIsolateThread(int isolateThreadSize)

Description copied from class: VMThreads

Allocate native memory for a IsolateThread. The returned memory must be initialized to 0.

Specified by:

allocateIsolateThread in class VMThreads

freeIsolateThread

public void freeIsolateThread(org.graalvm.nativeimage.IsolateThread thread)

Description copied from class: VMThreads

Free the native memory allocated by VMThreads.allocateIsolateThread(int).

Specified by:

freeIsolateThread in class VMThreads

failFatally

public void failFatally(int code,
                        org.graalvm.nativeimage.c.type.CCharPointer message)

Description copied from class: VMThreads

Report a fatal error to the user and exit. This method must not return.

Specified by:

failFatally in class VMThreads