org.jruby.cext

Class GIL

java.lang.Object

org.jruby.cext.GIL

final class GIL
extends java.lang.Object

The GIL keeps locks for Threads running native code. Only one Thread can usually be running C code at a time.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.concurrent.locks.ReentrantLock	lock

Constructor Summary

Constructors

Modifier	Constructor and Description
private	GIL()

Method Summary

Modifier and Type	Method and Description
static void	acquire()
static void	acquire(int lockCount) Acquire the lock n-times.
static void	release() Decrease the lock holding count by one, and do a GC run if this is the last lock held by this thread.
static int	releaseAllLocks() Release all locks currently held by this thread.
static void	releaseNoCleanup() Fast unlocking without GC.

Methods inherited from class java.lang.Object

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

Field Detail

lock

private static final java.util.concurrent.locks.ReentrantLock lock

Constructor Detail

GIL

private GIL()

Method Detail

acquire

public static void acquire()

acquire

public static void acquire(int lockCount)

Acquire the lock n-times. This method is used to implement JRuby.nativeBlockingRegion(org.jruby.Ruby, long, long, long, long). After finishing execution of unmanaged code, the executing thread has to re-acquire all previously owned locks (for cases where the execution of the Thread went through Java->C->Java->C multiple times)

release

public static void release()

Decrease the lock holding count by one, and do a GC run if this is the last lock held by this thread.

releaseNoCleanup

public static void releaseNoCleanup()

Fast unlocking without GC.

releaseAllLocks

public static int releaseAllLocks()

Release all locks currently held by this thread.

Returns:

the unlock count