提交 c08f212f 编写于 作者: D dl

8056248: Improve ForkJoin thread throttling

Reviewed-by: psandoz, martin, chegar
上级 0affdd8c
...@@ -49,6 +49,7 @@ import java.util.concurrent.RejectedExecutionException; ...@@ -49,6 +49,7 @@ import java.util.concurrent.RejectedExecutionException;
import java.util.concurrent.RunnableFuture; import java.util.concurrent.RunnableFuture;
import java.util.concurrent.ThreadLocalRandom; import java.util.concurrent.ThreadLocalRandom;
import java.util.concurrent.TimeUnit; import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicLong;
import java.security.AccessControlContext; import java.security.AccessControlContext;
import java.security.ProtectionDomain; import java.security.ProtectionDomain;
import java.security.Permissions; import java.security.Permissions;
...@@ -80,9 +81,9 @@ import java.security.Permissions; ...@@ -80,9 +81,9 @@ import java.security.Permissions;
* *
* <p>For applications that require separate or custom pools, a {@code * <p>For applications that require separate or custom pools, a {@code
* ForkJoinPool} may be constructed with a given target parallelism * ForkJoinPool} may be constructed with a given target parallelism
* level; by default, equal to the number of available processors. The * level; by default, equal to the number of available processors.
* pool attempts to maintain enough active (or available) threads by * The pool attempts to maintain enough active (or available) threads
* dynamically adding, suspending, or resuming internal worker * by dynamically adding, suspending, or resuming internal worker
* threads, even if some tasks are stalled waiting to join others. * threads, even if some tasks are stalled waiting to join others.
* However, no such adjustments are guaranteed in the face of blocked * However, no such adjustments are guaranteed in the face of blocked
* I/O or other unmanaged synchronization. The nested {@link * I/O or other unmanaged synchronization. The nested {@link
...@@ -178,7 +179,14 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -178,7 +179,14 @@ public class ForkJoinPool extends AbstractExecutorService {
* that may be stolen by other workers. Preference rules give * that may be stolen by other workers. Preference rules give
* first priority to processing tasks from their own queues (LIFO * first priority to processing tasks from their own queues (LIFO
* or FIFO, depending on mode), then to randomized FIFO steals of * or FIFO, depending on mode), then to randomized FIFO steals of
* tasks in other queues. * tasks in other queues. This framework began as vehicle for
* supporting tree-structured parallelism using work-stealing.
* Over time, its scalability advantages led to extensions and
* changes to better support more diverse usage contexts. Because
* most internal methods and nested classes are interrelated,
* their main rationale and descriptions are presented here;
* individual methods and nested classes contain only brief
* comments about details.
* *
* WorkQueues * WorkQueues
* ========== * ==========
...@@ -198,201 +206,318 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -198,201 +206,318 @@ public class ForkJoinPool extends AbstractExecutorService {
* (http://research.sun.com/scalable/pubs/index.html) and * (http://research.sun.com/scalable/pubs/index.html) and
* "Idempotent work stealing" by Michael, Saraswat, and Vechev, * "Idempotent work stealing" by Michael, Saraswat, and Vechev,
* PPoPP 2009 (http://portal.acm.org/citation.cfm?id=1504186). * PPoPP 2009 (http://portal.acm.org/citation.cfm?id=1504186).
* See also "Correct and Efficient Work-Stealing for Weak Memory * The main differences ultimately stem from GC requirements that
* Models" by Le, Pop, Cohen, and Nardelli, PPoPP 2013 * we null out taken slots as soon as we can, to maintain as small
* (http://www.di.ens.fr/~zappa/readings/ppopp13.pdf) for an * a footprint as possible even in programs generating huge
* analysis of memory ordering (atomic, volatile etc) issues. The * numbers of tasks. To accomplish this, we shift the CAS
* main differences ultimately stem from GC requirements that we * arbitrating pop vs poll (steal) from being on the indices
* null out taken slots as soon as we can, to maintain as small a * ("base" and "top") to the slots themselves.
* footprint as possible even in programs generating huge numbers *
* of tasks. To accomplish this, we shift the CAS arbitrating pop * Adding tasks then takes the form of a classic array push(task):
* vs poll (steal) from being on the indices ("base" and "top") to * q.array[q.top] = task; ++q.top;
* the slots themselves. So, both a successful pop and poll *
* mainly entail a CAS of a slot from non-null to null. Because * (The actual code needs to null-check and size-check the array,
* we rely on CASes of references, we do not need tag bits on base * properly fence the accesses, and possibly signal waiting
* or top. They are simple ints as used in any circular * workers to start scanning -- see below.) Both a successful pop
* and poll mainly entail a CAS of a slot from non-null to null.
*
* The pop operation (always performed by owner) is:
* if ((base != top) and
* (the task at top slot is not null) and
* (CAS slot to null))
* decrement top and return task;
*
* And the poll operation (usually by a stealer) is
* if ((base != top) and
* (the task at base slot is not null) and
* (base has not changed) and
* (CAS slot to null))
* increment base and return task;
*
* Because we rely on CASes of references, we do not need tag bits
* on base or top. They are simple ints as used in any circular
* array-based queue (see for example ArrayDeque). Updates to the * array-based queue (see for example ArrayDeque). Updates to the
* indices must still be ordered in a way that guarantees that top * indices guarantee that top == base means the queue is empty,
* == base means the queue is empty, but otherwise may err on the * but otherwise may err on the side of possibly making the queue
* side of possibly making the queue appear nonempty when a push, * appear nonempty when a push, pop, or poll have not fully
* pop, or poll have not fully committed. Note that this means * committed. (Method isEmpty() checks the case of a partially
* that the poll operation, considered individually, is not * completed removal of the last element.) Because of this, the
* wait-free. One thief cannot successfully continue until another * poll operation, considered individually, is not wait-free. One
* in-progress one (or, if previously empty, a push) completes. * thief cannot successfully continue until another in-progress
* However, in the aggregate, we ensure at least probabilistic * one (or, if previously empty, a push) completes. However, in
* the aggregate, we ensure at least probabilistic
* non-blockingness. If an attempted steal fails, a thief always * non-blockingness. If an attempted steal fails, a thief always
* chooses a different random victim target to try next. So, in * chooses a different random victim target to try next. So, in
* order for one thief to progress, it suffices for any * order for one thief to progress, it suffices for any
* in-progress poll or new push on any empty queue to * in-progress poll or new push on any empty queue to
* complete. (This is why we normally use method pollAt and its * complete. (This is why we normally use method pollAt and its
* variants that try once at the apparent base index, else * variants that try once at the apparent base index, else
* consider alternative actions, rather than method poll.) * consider alternative actions, rather than method poll, which
* * retries.)
* This approach also enables support of a user mode in which local *
* task processing is in FIFO, not LIFO order, simply by using * This approach also enables support of a user mode in which
* poll rather than pop. This can be useful in message-passing * local task processing is in FIFO, not LIFO order, simply by
* frameworks in which tasks are never joined. However neither * using poll rather than pop. This can be useful in
* mode considers affinities, loads, cache localities, etc, so * message-passing frameworks in which tasks are never joined.
* rarely provide the best possible performance on a given * However neither mode considers affinities, loads, cache
* machine, but portably provide good throughput by averaging over * localities, etc, so rarely provide the best possible
* these factors. (Further, even if we did try to use such * performance on a given machine, but portably provide good
* information, we do not usually have a basis for exploiting it. * throughput by averaging over these factors. Further, even if
* For example, some sets of tasks profit from cache affinities, * we did try to use such information, we do not usually have a
* but others are harmed by cache pollution effects.) * basis for exploiting it. For example, some sets of tasks
* profit from cache affinities, but others are harmed by cache
* pollution effects. Additionally, even though it requires
* scanning, long-term throughput is often best using random
* selection rather than directed selection policies, so cheap
* randomization of sufficient quality is used whenever
* applicable. Various Marsaglia XorShifts (some with different
* shift constants) are inlined at use points.
* *
* WorkQueues are also used in a similar way for tasks submitted * WorkQueues are also used in a similar way for tasks submitted
* to the pool. We cannot mix these tasks in the same queues used * to the pool. We cannot mix these tasks in the same queues used
* for work-stealing (this would contaminate lifo/fifo * by workers. Instead, we randomly associate submission queues
* processing). Instead, we randomly associate submission queues
* with submitting threads, using a form of hashing. The * with submitting threads, using a form of hashing. The
* ThreadLocalRandom probe value serves as a hash code for * ThreadLocalRandom probe value serves as a hash code for
* choosing existing queues, and may be randomly repositioned upon * choosing existing queues, and may be randomly repositioned upon
* contention with other submitters. In essence, submitters act * contention with other submitters. In essence, submitters act
* like workers except that they are restricted to executing local * like workers except that they are restricted to executing local
* tasks that they submitted (or in the case of CountedCompleters, * tasks that they submitted (or in the case of CountedCompleters,
* others with the same root task). However, because most * others with the same root task). Insertion of tasks in shared
* shared/external queue operations are more expensive than
* internal, and because, at steady state, external submitters
* will compete for CPU with workers, ForkJoinTask.join and
* related methods disable them from repeatedly helping to process
* tasks if all workers are active. Insertion of tasks in shared
* mode requires a lock (mainly to protect in the case of * mode requires a lock (mainly to protect in the case of
* resizing) but we use only a simple spinlock (using bits in * resizing) but we use only a simple spinlock (using field
* field qlock), because submitters encountering a busy queue move * qlock), because submitters encountering a busy queue move on to
* on to try or create other queues -- they block only when * try or create other queues -- they block only when creating and
* creating and registering new queues. * registering new queues. Additionally, "qlock" saturates to an
* unlockable value (-1) at shutdown. Unlocking still can be and
* is performed by cheaper ordered writes of "qlock" in successful
* cases, but uses CAS in unsuccessful cases.
* *
* Management * Management
* ========== * ==========
* *
* The main throughput advantages of work-stealing stem from * The main throughput advantages of work-stealing stem from
* decentralized control -- workers mostly take tasks from * decentralized control -- workers mostly take tasks from
* themselves or each other. We cannot negate this in the * themselves or each other, at rates that can exceed a billion
* implementation of other management responsibilities. The main * per second. The pool itself creates, activates (enables
* tactic for avoiding bottlenecks is packing nearly all * scanning for and running tasks), deactivates, blocks, and
* essentially atomic control state into two volatile variables * terminates threads, all with minimal central information.
* that are by far most often read (not written) as status and * There are only a few properties that we can globally track or
* consistency checks. * maintain, so we pack them into a small number of variables,
* * often maintaining atomicity without blocking or locking.
* Field "ctl" contains 64 bits holding all the information needed * Nearly all essentially atomic control state is held in two
* to atomically decide to add, inactivate, enqueue (on an event * volatile variables that are by far most often read (not
* written) as status and consistency checks. (Also, field
* "config" holds unchanging configuration state.)
*
* Field "ctl" contains 64 bits holding information needed to
* atomically decide to add, inactivate, enqueue (on an event
* queue), dequeue, and/or re-activate workers. To enable this * queue), dequeue, and/or re-activate workers. To enable this
* packing, we restrict maximum parallelism to (1<<15)-1 (which is * packing, we restrict maximum parallelism to (1<<15)-1 (which is
* far in excess of normal operating range) to allow ids, counts, * far in excess of normal operating range) to allow ids, counts,
* and their negations (used for thresholding) to fit into 16bit * and their negations (used for thresholding) to fit into 16bit
* fields. * subfields.
* *
* Field "plock" is a form of sequence lock with a saturating * Field "runState" holds lockable state bits (STARTED, STOP, etc)
* shutdown bit (similarly for per-queue "qlocks"), mainly * also protecting updates to the workQueues array. When used as
* protecting updates to the workQueues array, as well as to * a lock, it is normally held only for a few instructions (the
* enable shutdown. When used as a lock, it is normally only very * only exceptions are one-time array initialization and uncommon
* briefly held, so is nearly always available after at most a * resizing), so is nearly always available after at most a brief
* brief spin, but we use a monitor-based backup strategy to * spin. But to be extra-cautious, after spinning, method
* block when needed. * awaitRunStateLock (called only if an initial CAS fails), uses a
* wait/notify mechanics on a builtin monitor to block when
* (rarely) needed. This would be a terrible idea for a highly
* contended lock, but most pools run without the lock ever
* contending after the spin limit, so this works fine as a more
* conservative alternative. Because we don't otherwise have an
* internal Object to use as a monitor, the "stealCounter" (an
* AtomicLong) is used when available (it too must be lazily
* initialized; see externalSubmit).
*
* Usages of "runState" vs "ctl" interact in only one case:
* deciding to add a worker thread (see tryAddWorker), in which
* case the ctl CAS is performed while the lock is held.
* *
* Recording WorkQueues. WorkQueues are recorded in the * Recording WorkQueues. WorkQueues are recorded in the
* "workQueues" array that is created upon first use and expanded * "workQueues" array. The array is created upon first use (see
* if necessary. Updates to the array while recording new workers * externalSubmit) and expanded if necessary. Updates to the
* and unrecording terminated ones are protected from each other * array while recording new workers and unrecording terminated
* by a lock but the array is otherwise concurrently readable, and * ones are protected from each other by the runState lock, but
* accessed directly. To simplify index-based operations, the * the array is otherwise concurrently readable, and accessed
* array size is always a power of two, and all readers must * directly. We also ensure that reads of the array reference
* tolerate null slots. Worker queues are at odd indices. Shared * itself never become too stale. To simplify index-based
* (submission) queues are at even indices, up to a maximum of 64 * operations, the array size is always a power of two, and all
* slots, to limit growth even if array needs to expand to add * readers must tolerate null slots. Worker queues are at odd
* more workers. Grouping them together in this way simplifies and * indices. Shared (submission) queues are at even indices, up to
* speeds up task scanning. * a maximum of 64 slots, to limit growth even if array needs to
* expand to add more workers. Grouping them together in this way
* simplifies and speeds up task scanning.
* *
* All worker thread creation is on-demand, triggered by task * All worker thread creation is on-demand, triggered by task
* submissions, replacement of terminated workers, and/or * submissions, replacement of terminated workers, and/or
* compensation for blocked workers. However, all other support * compensation for blocked workers. However, all other support
* code is set up to work with other policies. To ensure that we * code is set up to work with other policies. To ensure that we
* do not hold on to worker references that would prevent GC, ALL * do not hold on to worker references that would prevent GC, All
* accesses to workQueues are via indices into the workQueues * accesses to workQueues are via indices into the workQueues
* array (which is one source of some of the messy code * array (which is one source of some of the messy code
* constructions here). In essence, the workQueues array serves as * constructions here). In essence, the workQueues array serves as
* a weak reference mechanism. Thus for example the wait queue * a weak reference mechanism. Thus for example the stack top
* field of ctl stores indices, not references. Access to the * subfield of ctl stores indices, not references.
* workQueues in associated methods (for example signalWork) must *
* both index-check and null-check the IDs. All such accesses * Queuing Idle Workers. Unlike HPC work-stealing frameworks, we
* ignore bad IDs by returning out early from what they are doing, * cannot let workers spin indefinitely scanning for tasks when
* since this can only be associated with termination, in which * none can be found immediately, and we cannot start/resume
* case it is OK to give up. All uses of the workQueues array * workers unless there appear to be tasks available. On the
* also check that it is non-null (even if previously * other hand, we must quickly prod them into action when new
* non-null). This allows nulling during termination, which is * tasks are submitted or generated. In many usages, ramp-up time
* currently not necessary, but remains an option for * to activate workers is the main limiting factor in overall
* resource-revocation-based shutdown schemes. It also helps * performance, which is compounded at program start-up by JIT
* reduce JIT issuance of uncommon-trap code, which tends to * compilation and allocation. So we streamline this as much as
* unnecessarily complicate control flow in some methods. * possible.
* *
* Event Queuing. Unlike HPC work-stealing frameworks, we cannot * The "ctl" field atomically maintains active and total worker
* let workers spin indefinitely scanning for tasks when none can * counts as well as a queue to place waiting threads so they can
* be found immediately, and we cannot start/resume workers unless * be located for signalling. Active counts also play the role of
* there appear to be tasks available. On the other hand, we must * quiescence indicators, so are decremented when workers believe
* quickly prod them into action when new tasks are submitted or * that there are no more tasks to execute. The "queue" is
* generated. In many usages, ramp-up time to activate workers is * actually a form of Treiber stack. A stack is ideal for
* the main limiting factor in overall performance (this is * activating threads in most-recently used order. This improves
* compounded at program start-up by JIT compilation and * performance and locality, outweighing the disadvantages of
* allocation). So we try to streamline this as much as possible. * being prone to contention and inability to release a worker
* We park/unpark workers after placing in an event wait queue * unless it is topmost on stack. We park/unpark workers after
* when they cannot find work. This "queue" is actually a simple * pushing on the idle worker stack (represented by the lower
* Treiber stack, headed by the "id" field of ctl, plus a 15bit * 32bit subfield of ctl) when they cannot find work. The top
* counter value (that reflects the number of times a worker has * stack state holds the value of the "scanState" field of the
* been inactivated) to avoid ABA effects (we need only as many * worker: its index and status, plus a version counter that, in
* version numbers as worker threads). Successors are held in * addition to the count subfields (also serving as version
* field WorkQueue.nextWait. Queuing deals with several intrinsic * stamps) provide protection against Treiber stack ABA effects.
* races, mainly that a task-producing thread can miss seeing (and *
* signalling) another thread that gave up looking for work but * Field scanState is used by both workers and the pool to manage
* has not yet entered the wait queue. We solve this by requiring * and track whether a worker is INACTIVE (possibly blocked
* a full sweep of all workers (via repeated calls to method * waiting for a signal), or SCANNING for tasks (when neither hold
* scan()) both before and after a newly waiting worker is added * it is busy running tasks). When a worker is inactivated, its
* to the wait queue. Because enqueued workers may actually be * scanState field is set, and is prevented from executing tasks,
* rescanning rather than waiting, we set and clear the "parker" * even though it must scan once for them to avoid queuing
* races. Note that scanState updates lag queue CAS releases so
* usage requires care. When queued, the lower 16 bits of
* scanState must hold its pool index. So we place the index there
* upon initialization (see registerWorker) and otherwise keep it
* there or restore it when necessary.
*
* Memory ordering. See "Correct and Efficient Work-Stealing for
* Weak Memory Models" by Le, Pop, Cohen, and Nardelli, PPoPP 2013
* (http://www.di.ens.fr/~zappa/readings/ppopp13.pdf) for an
* analysis of memory ordering requirements in work-stealing
* algorithms similar to the one used here. We usually need
* stronger than minimal ordering because we must sometimes signal
* workers, requiring Dekker-like full-fences to avoid lost
* signals. Arranging for enough ordering without expensive
* over-fencing requires tradeoffs among the supported means of
* expressing access constraints. The most central operations,
* taking from queues and updating ctl state, require full-fence
* CAS. Array slots are read using the emulation of volatiles
* provided by Unsafe. Access from other threads to WorkQueue
* base, top, and array requires a volatile load of the first of
* any of these read. We use the convention of declaring the
* "base" index volatile, and always read it before other fields.
* The owner thread must ensure ordered updates, so writes use
* ordered intrinsics unless they can piggyback on those for other
* writes. Similar conventions and rationales hold for other
* WorkQueue fields (such as "currentSteal") that are only written
* by owners but observed by others.
*
* Creating workers. To create a worker, we pre-increment total
* count (serving as a reservation), and attempt to construct a
* ForkJoinWorkerThread via its factory. Upon construction, the
* new thread invokes registerWorker, where it constructs a
* WorkQueue and is assigned an index in the workQueues array
* (expanding the array if necessary). The thread is then
* started. Upon any exception across these steps, or null return
* from factory, deregisterWorker adjusts counts and records
* accordingly. If a null return, the pool continues running with
* fewer than the target number workers. If exceptional, the
* exception is propagated, generally to some external caller.
* Worker index assignment avoids the bias in scanning that would
* occur if entries were sequentially packed starting at the front
* of the workQueues array. We treat the array as a simple
* power-of-two hash table, expanding as needed. The seedIndex
* increment ensures no collisions until a resize is needed or a
* worker is deregistered and replaced, and thereafter keeps
* probability of collision low. We cannot use
* ThreadLocalRandom.getProbe() for similar purposes here because
* the thread has not started yet, but do so for creating
* submission queues for existing external threads.
*
* Deactivation and waiting. Queuing encounters several intrinsic
* races; most notably that a task-producing thread can miss
* seeing (and signalling) another thread that gave up looking for
* work but has not yet entered the wait queue. When a worker
* cannot find a task to steal, it deactivates and enqueues. Very
* often, the lack of tasks is transient due to GC or OS
* scheduling. To reduce false-alarm deactivation, scanners
* compute checksums of queue states during sweeps. (The
* stability checks used here and elsewhere are probabilistic
* variants of snapshot techniques -- see Herlihy & Shavit.)
* Workers give up and try to deactivate only after the sum is
* stable across scans. Further, to avoid missed signals, they
* repeat this scanning process after successful enqueuing until
* again stable. In this state, the worker cannot take/run a task
* it sees until it is released from the queue, so the worker
* itself eventually tries to release itself or any successor (see
* tryRelease). Otherwise, upon an empty scan, a deactivated
* worker uses an adaptive local spin construction (see awaitWork)
* before blocking (via park). Note the unusual conventions about
* Thread.interrupts surrounding parking and other blocking:
* Because interrupts are used solely to alert threads to check
* termination, which is checked anyway upon blocking, we clear
* status (using Thread.interrupted) before any call to park, so
* that park does not immediately return due to status being set
* via some other unrelated call to interrupt in user code.
*
* Signalling and activation. Workers are created or activated
* only when there appears to be at least one task they might be
* able to find and execute. Upon push (either by a worker or an
* external submission) to a previously (possibly) empty queue,
* workers are signalled if idle, or created if fewer exist than
* the given parallelism level. These primary signals are
* buttressed by others whenever other threads remove a task from
* a queue and notice that there are other tasks there as well.
* On most platforms, signalling (unpark) overhead time is
* noticeably long, and the time between signalling a thread and
* it actually making progress can be very noticeably long, so it
* is worth offloading these delays from critical paths as much as
* possible. Also, because inactive workers are often rescanning
* or spinning rather than blocking, we set and clear the "parker"
* field of WorkQueues to reduce unnecessary calls to unpark. * field of WorkQueues to reduce unnecessary calls to unpark.
* (This requires a secondary recheck to avoid missed signals.) * (This requires a secondary recheck to avoid missed signals.)
* Note the unusual conventions about Thread.interrupts
* surrounding parking and other blocking: Because interrupts are
* used solely to alert threads to check termination, which is
* checked anyway upon blocking, we clear status (using
* Thread.interrupted) before any call to park, so that park does
* not immediately return due to status being set via some other
* unrelated call to interrupt in user code.
*
* Signalling. We create or wake up workers only when there
* appears to be at least one task they might be able to find and
* execute. When a submission is added or another worker adds a
* task to a queue that has fewer than two tasks, they signal
* waiting workers (or trigger creation of new ones if fewer than
* the given parallelism level -- signalWork). These primary
* signals are buttressed by others whenever other threads remove
* a task from a queue and notice that there are other tasks there
* as well. So in general, pools will be over-signalled. On most
* platforms, signalling (unpark) overhead time is noticeably
* long, and the time between signalling a thread and it actually
* making progress can be very noticeably long, so it is worth
* offloading these delays from critical paths as much as
* possible. Additionally, workers spin-down gradually, by staying
* alive so long as they see the ctl state changing. Similar
* stability-sensing techniques are also used before blocking in
* awaitJoin and helpComplete.
* *
* Trimming workers. To release resources after periods of lack of * Trimming workers. To release resources after periods of lack of
* use, a worker starting to wait when the pool is quiescent will * use, a worker starting to wait when the pool is quiescent will
* time out and terminate if the pool has remained quiescent for a * time out and terminate (see awaitWork) if the pool has remained
* given period -- a short period if there are more threads than * quiescent for period IDLE_TIMEOUT, increasing the period as the
* parallelism, longer as the number of threads decreases. This * number of threads decreases, eventually removing all workers.
* will slowly propagate, eventually terminating all workers after * Also, when more than two spare threads exist, excess threads
* periods of non-use. * are immediately terminated at the next quiescent point.
* * (Padding by two avoids hysteresis.)
* Shutdown and Termination. A call to shutdownNow atomically sets *
* a plock bit and then (non-atomically) sets each worker's * Shutdown and Termination. A call to shutdownNow invokes
* qlock status, cancels all unprocessed tasks, and wakes up * tryTerminate to atomically set a runState bit. The calling
* all waiting workers. Detecting whether termination should * thread, as well as every other worker thereafter terminating,
* commence after a non-abrupt shutdown() call requires more work * helps terminate others by setting their (qlock) status,
* and bookkeeping. We need consensus about quiescence (i.e., that * cancelling their unprocessed tasks, and waking them up, doing
* there is no more work). The active count provides a primary * so repeatedly until stable (but with a loop bounded by the
* indication but non-abrupt shutdown still requires a rechecking * number of workers). Calls to non-abrupt shutdown() preface
* scan for any workers that are inactive but not queued. * this by checking whether termination should commence. This
* relies primarily on the active count bits of "ctl" maintaining
* consensus -- tryTerminate is called from awaitWork whenever
* quiescent. However, external submitters do not take part in
* this consensus. So, tryTerminate sweeps through queues (until
* stable) to ensure lack of in-flight submissions and workers
* about to process them before triggering the "STOP" phase of
* termination. (Note: there is an intrinsic conflict if
* helpQuiescePool is called when shutdown is enabled. Both wait
* for quiescence, but tryTerminate is biased to not trigger until
* helpQuiescePool completes.)
*
* *
* Joining Tasks * Joining Tasks
* ============= * =============
...@@ -403,9 +528,9 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -403,9 +528,9 @@ public class ForkJoinPool extends AbstractExecutorService {
* just let them block (as in Thread.join). We also cannot just * just let them block (as in Thread.join). We also cannot just
* reassign the joiner's run-time stack with another and replace * reassign the joiner's run-time stack with another and replace
* it later, which would be a form of "continuation", that even if * it later, which would be a form of "continuation", that even if
* possible is not necessarily a good idea since we sometimes need * possible is not necessarily a good idea since we may need both
* both an unblocked task and its continuation to progress. * an unblocked task and its continuation to progress. Instead we
* Instead we combine two tactics: * combine two tactics:
* *
* Helping: Arranging for the joiner to execute some task that it * Helping: Arranging for the joiner to execute some task that it
* would be running if the steal had not occurred. * would be running if the steal had not occurred.
...@@ -425,16 +550,16 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -425,16 +550,16 @@ public class ForkJoinPool extends AbstractExecutorService {
* The ManagedBlocker extension API can't use helping so relies * The ManagedBlocker extension API can't use helping so relies
* only on compensation in method awaitBlocker. * only on compensation in method awaitBlocker.
* *
* The algorithm in tryHelpStealer entails a form of "linear" * The algorithm in helpStealer entails a form of "linear
* helping: Each worker records (in field currentSteal) the most * helping". Each worker records (in field currentSteal) the most
* recent task it stole from some other worker. Plus, it records * recent task it stole from some other worker (or a submission).
* (in field currentJoin) the task it is currently actively * It also records (in field currentJoin) the task it is currently
* joining. Method tryHelpStealer uses these markers to try to * actively joining. Method helpStealer uses these markers to try
* find a worker to help (i.e., steal back a task from and execute * to find a worker to help (i.e., steal back a task from and
* it) that could hasten completion of the actively joined task. * execute it) that could hasten completion of the actively joined
* In essence, the joiner executes a task that would be on its own * task. Thus, the joiner executes a task that would be on its
* local deque had the to-be-joined task not been stolen. This may * own local deque had the to-be-joined task not been stolen. This
* be seen as a conservative variant of the approach in Wagner & * is a conservative variant of the approach described in Wagner &
* Calder "Leapfrogging: a portable technique for implementing * Calder "Leapfrogging: a portable technique for implementing
* efficient futures" SIGPLAN Notices, 1993 * efficient futures" SIGPLAN Notices, 1993
* (http://portal.acm.org/citation.cfm?id=155354). It differs in * (http://portal.acm.org/citation.cfm?id=155354). It differs in
...@@ -452,37 +577,40 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -452,37 +577,40 @@ public class ForkJoinPool extends AbstractExecutorService {
* which means that we miss links in the chain during long-lived * which means that we miss links in the chain during long-lived
* tasks, GC stalls etc (which is OK since blocking in such cases * tasks, GC stalls etc (which is OK since blocking in such cases
* is usually a good idea). (4) We bound the number of attempts * is usually a good idea). (4) We bound the number of attempts
* to find work (see MAX_HELP) and fall back to suspending the * to find work using checksums and fall back to suspending the
* worker and if necessary replacing it with another. * worker and if necessary replacing it with another.
* *
* Helping actions for CountedCompleters are much simpler: Method * Helping actions for CountedCompleters do not require tracking
* helpComplete can take and execute any task with the same root * currentJoins: Method helpComplete takes and executes any task
* as the task being waited on. However, this still entails some * with the same root as the task being waited on (preferring
* traversal of completer chains, so is less efficient than using * local pops to non-local polls). However, this still entails
* CountedCompleters without explicit joins. * some traversal of completer chains, so is less efficient than
* * using CountedCompleters without explicit joins.
* It is impossible to keep exactly the target parallelism number *
* of threads running at any given time. Determining the * Compensation does not aim to keep exactly the target
* existence of conservatively safe helping targets, the * parallelism number of unblocked threads running at any given
* availability of already-created spares, and the apparent need * time. Some previous versions of this class employed immediate
* to create new spares are all racy, so we rely on multiple * compensations for any blocked join. However, in practice, the
* retries of each. Compensation in the apparent absence of * vast majority of blockages are transient byproducts of GC and
* helping opportunities is challenging to control on JVMs, where * other JVM or OS activities that are made worse by replacement.
* GC and other activities can stall progress of tasks that in * Currently, compensation is attempted only after validating that
* turn stall out many other dependent tasks, without us being * all purportedly active threads are processing tasks by checking
* able to determine whether they will ever require compensation. * field WorkQueue.scanState, which eliminates most false
* Even though work-stealing otherwise encounters little * positives. Also, compensation is bypassed (tolerating fewer
* degradation in the presence of more threads than cores, * threads) in the most common case in which it is rarely
* aggressively adding new threads in such cases entails risk of * beneficial: when a worker with an empty queue (thus no
* unwanted positive feedback control loops in which more threads * continuation tasks) blocks on a join and there still remain
* cause more dependent stalls (as well as delayed progress of * enough threads to ensure liveness.
* unblocked threads to the point that we know they are available) *
* leading to more situations requiring more threads, and so * The compensation mechanism may be bounded. Bounds for the
* on. This aspect of control can be seen as an (analytically * commonPool (see commonMaxSpares) better enable JVMs to cope
* intractable) game with an opponent that may choose the worst * with programming errors and abuse before running out of
* (for us) active thread to stall at any time. We take several * resources to do so. In other cases, users may supply factories
* precautions to bound losses (and thus bound gains), mainly in * that limit thread construction. The effects of bounding in this
* methods tryCompensate and awaitJoin. * pool (like all others) is imprecise. Total worker counts are
* decremented when threads deregister, not when they exit and
* resources are reclaimed by the JVM and OS. So the number of
* simultaneously live threads may transiently exceed bounds.
* *
* Common Pool * Common Pool
* =========== * ===========
...@@ -492,34 +620,52 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -492,34 +620,52 @@ public class ForkJoinPool extends AbstractExecutorService {
* never be used, we minimize initial construction overhead and * never be used, we minimize initial construction overhead and
* footprint to the setup of about a dozen fields, with no nested * footprint to the setup of about a dozen fields, with no nested
* allocation. Most bootstrapping occurs within method * allocation. Most bootstrapping occurs within method
* fullExternalPush during the first submission to the pool. * externalSubmit during the first submission to the pool.
* *
* When external threads submit to the common pool, they can * When external threads submit to the common pool, they can
* perform subtask processing (see externalHelpJoin and related * perform subtask processing (see externalHelpComplete and
* methods). This caller-helps policy makes it sensible to set * related methods) upon joins. This caller-helps policy makes it
* common pool parallelism level to one (or more) less than the * sensible to set common pool parallelism level to one (or more)
* total number of available cores, or even zero for pure * less than the total number of available cores, or even zero for
* caller-runs. We do not need to record whether external * pure caller-runs. We do not need to record whether external
* submissions are to the common pool -- if not, externalHelpJoin * submissions are to the common pool -- if not, external help
* returns quickly (at the most helping to signal some common pool * methods return quickly. These submitters would otherwise be
* workers). These submitters would otherwise be blocked waiting * blocked waiting for completion, so the extra effort (with
* for completion, so the extra effort (with liberally sprinkled * liberally sprinkled task status checks) in inapplicable cases
* task status checks) in inapplicable cases amounts to an odd * amounts to an odd form of limited spin-wait before blocking in
* form of limited spin-wait before blocking in ForkJoinTask.join. * ForkJoinTask.join.
* *
* As a more appropriate default in managed environments, unless * As a more appropriate default in managed environments, unless
* overridden by system properties, we use workers of subclass * overridden by system properties, we use workers of subclass
* InnocuousForkJoinWorkerThread when there is a SecurityManager * InnocuousForkJoinWorkerThread when there is a SecurityManager
* present. These workers have no permissions set, do not belong * present. These workers have no permissions set, do not belong
* to any user-defined ThreadGroup, and erase all ThreadLocals * to any user-defined ThreadGroup, and erase all ThreadLocals
* after executing any top-level task (see WorkQueue.runTask). The * after executing any top-level task (see WorkQueue.runTask).
* associated mechanics (mainly in ForkJoinWorkerThread) may be * The associated mechanics (mainly in ForkJoinWorkerThread) may
* JVM-dependent and must access particular Thread class fields to * be JVM-dependent and must access particular Thread class fields
* achieve this effect. * to achieve this effect.
* *
* Style notes * Style notes
* =========== * ===========
* *
* Memory ordering relies mainly on Unsafe intrinsics that carry
* the further responsibility of explicitly performing null- and
* bounds- checks otherwise carried out implicitly by JVMs. This
* can be awkward and ugly, but also reflects the need to control
* outcomes across the unusual cases that arise in very racy code
* with very few invariants. So these explicit checks would exist
* in some form anyway. All fields are read into locals before
* use, and null-checked if they are references. This is usually
* done in a "C"-like style of listing declarations at the heads
* of methods or blocks, and using inline assignments on first
* encounter. Array bounds-checks are usually performed by
* masking with array.length-1, which relies on the invariant that
* these arrays are created with positive lengths, which is itself
* paranoically checked. Nearly all explicit checks lead to
* bypass/return, not exception throws, because they may
* legitimately arise due to cancellation/revocation during
* shutdown.
*
* There is a lot of representation-level coupling among classes * There is a lot of representation-level coupling among classes
* ForkJoinPool, ForkJoinWorkerThread, and ForkJoinTask. The * ForkJoinPool, ForkJoinWorkerThread, and ForkJoinTask. The
* fields of WorkQueue maintain data structures managed by * fields of WorkQueue maintain data structures managed by
...@@ -527,22 +673,13 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -527,22 +673,13 @@ public class ForkJoinPool extends AbstractExecutorService {
* trying to reduce this, since any associated future changes in * trying to reduce this, since any associated future changes in
* representations will need to be accompanied by algorithmic * representations will need to be accompanied by algorithmic
* changes anyway. Several methods intrinsically sprawl because * changes anyway. Several methods intrinsically sprawl because
* they must accumulate sets of consistent reads of volatiles held * they must accumulate sets of consistent reads of fields held in
* in local variables. Methods signalWork() and scan() are the * local variables. There are also other coding oddities
* main bottlenecks, so are especially heavily * (including several unnecessary-looking hoisted null checks)
* micro-optimized/mangled. There are lots of inline assignments * that help some methods perform reasonably even when interpreted
* (of form "while ((local = field) != 0)") which are usually the * (not compiled).
* simplest way to ensure the required read orderings (which are *
* sometimes critical). This leads to a "C"-like style of listing * The order of declarations in this file is (with a few exceptions):
* declarations of these locals at the heads of methods or blocks.
* There are several occurrences of the unusual "do {} while
* (!cas...)" which is the simplest way to force an update of a
* CAS'ed variable. There are also other coding oddities (including
* several unnecessary-looking hoisted null checks) that help
* some methods perform reasonably even when interpreted (not
* compiled).
*
* The order of declarations in this file is:
* (1) Static utility functions * (1) Static utility functions
* (2) Nested (static) classes * (2) Nested (static) classes
* (3) Static fields * (3) Static fields
...@@ -609,56 +746,37 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -609,56 +746,37 @@ public class ForkJoinPool extends AbstractExecutorService {
public final boolean exec() { return true; } public final boolean exec() { return true; }
} }
// Constants shared across ForkJoinPool and WorkQueue
// Bounds
static final int SMASK = 0xffff; // short bits == max index
static final int MAX_CAP = 0x7fff; // max #workers - 1
static final int EVENMASK = 0xfffe; // even short bits
static final int SQMASK = 0x007e; // max 64 (even) slots
// Masks and units for WorkQueue.scanState and ctl sp subfield
static final int SCANNING = 1; // false when running tasks
static final int INACTIVE = 1 << 31; // must be negative
static final int SS_SEQ = 1 << 16; // version count
// Mode bits for ForkJoinPool.config and WorkQueue.config
static final int MODE_MASK = 0xffff << 16; // top half of int
static final int LIFO_QUEUE = 0;
static final int FIFO_QUEUE = 1 << 16;
static final int SHARED_QUEUE = 1 << 31; // must be negative
/** /**
* Queues supporting work-stealing as well as external task * Queues supporting work-stealing as well as external task
* submission. See above for main rationale and algorithms. * submission. See above for descriptions and algorithms.
* Implementation relies heavily on "Unsafe" intrinsics
* and selective use of "volatile":
*
* Field "base" is the index (mod array.length) of the least valid
* queue slot, which is always the next position to steal (poll)
* from if nonempty. Reads and writes require volatile orderings
* but not CAS, because updates are only performed after slot
* CASes.
*
* Field "top" is the index (mod array.length) of the next queue
* slot to push to or pop from. It is written only by owner thread
* for push, or under lock for external/shared push, and accessed
* by other threads only after reading (volatile) base. Both top
* and base are allowed to wrap around on overflow, but (top -
* base) (or more commonly -(base - top) to force volatile read of
* base before top) still estimates size. The lock ("qlock") is
* forced to -1 on termination, causing all further lock attempts
* to fail. (Note: we don't need CAS for termination state because
* upon pool shutdown, all shared-queues will stop being used
* anyway.) Nearly all lock bodies are set up so that exceptions
* within lock bodies are "impossible" (modulo JVM errors that
* would cause failure anyway.)
*
* The array slots are read and written using the emulation of
* volatiles/atomics provided by Unsafe. Insertions must in
* general use putOrderedObject as a form of releasing store to
* ensure that all writes to the task object are ordered before
* its publication in the queue. All removals entail a CAS to
* null. The array is always a power of two. To ensure safety of
* Unsafe array operations, all accesses perform explicit null
* checks and implicit bounds checks via power-of-two masking.
*
* In addition to basic queuing support, this class contains
* fields described elsewhere to control execution. It turns out
* to work better memory-layout-wise to include them in this class
* rather than a separate class.
*
* Performance on most platforms is very sensitive to placement of * Performance on most platforms is very sensitive to placement of
* instances of both WorkQueues and their arrays -- we absolutely * instances of both WorkQueues and their arrays -- we absolutely
* do not want multiple WorkQueue instances or multiple queue * do not want multiple WorkQueue instances or multiple queue
* arrays sharing cache lines. (It would be best for queue objects * arrays sharing cache lines. The @Contended annotation alerts
* and their arrays to share, but there is nothing available to * JVMs to try to keep instances apart.
* help arrange that). The @Contended annotation alerts JVMs to
* try to keep instances apart.
*/ */
@sun.misc.Contended @sun.misc.Contended
static final class WorkQueue { static final class WorkQueue {
/** /**
* Capacity of work-stealing queue array upon initialization. * Capacity of work-stealing queue array upon initialization.
* Must be a power of two; at least 4, but should be larger to * Must be a power of two; at least 4, but should be larger to
...@@ -679,13 +797,13 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -679,13 +797,13 @@ public class ForkJoinPool extends AbstractExecutorService {
*/ */
static final int MAXIMUM_QUEUE_CAPACITY = 1 << 26; // 64M static final int MAXIMUM_QUEUE_CAPACITY = 1 << 26; // 64M
volatile int eventCount; // encoded inactivation count; < 0 if inactive // Instance fields
int nextWait; // encoded record of next event waiter volatile int scanState; // versioned, <0: inactive; odd:scanning
int stackPred; // pool stack (ctl) predecessor
int nsteals; // number of steals int nsteals; // number of steals
int hint; // steal index hint int hint; // randomization and stealer index hint
short poolIndex; // index of this queue in pool int config; // pool index and mode
final short mode; // 0: lifo, > 0: fifo, < 0: shared volatile int qlock; // 1: locked, < 0: terminate; else 0
volatile int qlock; // 1: locked, -1: terminate; else 0
volatile int base; // index of next slot for poll volatile int base; // index of next slot for poll
int top; // index of next slot for push int top; // index of next slot for push
ForkJoinTask<?>[] array; // the elements (initially unallocated) ForkJoinTask<?>[] array; // the elements (initially unallocated)
...@@ -693,18 +811,22 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -693,18 +811,22 @@ public class ForkJoinPool extends AbstractExecutorService {
final ForkJoinWorkerThread owner; // owning thread or null if shared final ForkJoinWorkerThread owner; // owning thread or null if shared
volatile Thread parker; // == owner during call to park; else null volatile Thread parker; // == owner during call to park; else null
volatile ForkJoinTask<?> currentJoin; // task being joined in awaitJoin volatile ForkJoinTask<?> currentJoin; // task being joined in awaitJoin
ForkJoinTask<?> currentSteal; // current non-local task being executed volatile ForkJoinTask<?> currentSteal; // mainly used by helpStealer
WorkQueue(ForkJoinPool pool, ForkJoinWorkerThread owner, int mode, WorkQueue(ForkJoinPool pool, ForkJoinWorkerThread owner) {
int seed) {
this.pool = pool; this.pool = pool;
this.owner = owner; this.owner = owner;
this.mode = (short)mode;
this.hint = seed; // store initial seed for runWorker
// Place indices in the center of array (that is not yet allocated) // Place indices in the center of array (that is not yet allocated)
base = top = INITIAL_QUEUE_CAPACITY >>> 1; base = top = INITIAL_QUEUE_CAPACITY >>> 1;
} }
/**
* Returns an exportable index (used by ForkJoinWorkerThread).
*/
final int getPoolIndex() {
return (config & 0xffff) >>> 1; // ignore odd/even tag bit
}
/** /**
* Returns the approximate number of tasks in the queue. * Returns the approximate number of tasks in the queue.
*/ */
...@@ -719,12 +841,10 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -719,12 +841,10 @@ public class ForkJoinPool extends AbstractExecutorService {
* near-empty queue has at least one unclaimed task. * near-empty queue has at least one unclaimed task.
*/ */
final boolean isEmpty() { final boolean isEmpty() {
ForkJoinTask<?>[] a; int m, s; ForkJoinTask<?>[] a; int n, m, s;
int n = base - (s = top); return ((n = base - (s = top)) >= 0 ||
return (n >= 0 || (n == -1 && // possibly one task
(n == -1 && ((a = array) == null || (m = a.length - 1) < 0 ||
((a = array) == null ||
(m = a.length - 1) < 0 ||
U.getObject U.getObject
(a, (long)((m & (s - 1)) << ASHIFT) + ABASE) == null))); (a, (long)((m & (s - 1)) << ASHIFT) + ABASE) == null)));
} }
...@@ -738,12 +858,15 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -738,12 +858,15 @@ public class ForkJoinPool extends AbstractExecutorService {
*/ */
final void push(ForkJoinTask<?> task) { final void push(ForkJoinTask<?> task) {
ForkJoinTask<?>[] a; ForkJoinPool p; ForkJoinTask<?>[] a; ForkJoinPool p;
int s = top, n; int b = base, s = top, n;
if ((a = array) != null) { // ignore if queue removed if ((a = array) != null) { // ignore if queue removed
int m = a.length - 1; int m = a.length - 1; // fenced write for task visibility
U.putOrderedObject(a, ((m & s) << ASHIFT) + ABASE, task); U.putOrderedObject(a, ((m & s) << ASHIFT) + ABASE, task);
if ((n = (top = s + 1) - base) <= 2) U.putOrderedInt(this, QTOP, s + 1);
(p = pool).signalWork(p.workQueues, this); if ((n = s - b) <= 1) {
if ((p = pool) != null)
p.signalWork(p.workQueues, this);
}
else if (n >= m) else if (n >= m)
growArray(); growArray();
} }
...@@ -764,7 +887,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -764,7 +887,7 @@ public class ForkJoinPool extends AbstractExecutorService {
if (oldA != null && (oldMask = oldA.length - 1) >= 0 && if (oldA != null && (oldMask = oldA.length - 1) >= 0 &&
(t = top) - (b = base) > 0) { (t = top) - (b = base) > 0) {
int mask = size - 1; int mask = size - 1;
do { do { // emulate poll from old array, push to new array
ForkJoinTask<?> x; ForkJoinTask<?> x;
int oldj = ((b & oldMask) << ASHIFT) + ABASE; int oldj = ((b & oldMask) << ASHIFT) + ABASE;
int j = ((b & mask) << ASHIFT) + ABASE; int j = ((b & mask) << ASHIFT) + ABASE;
...@@ -789,7 +912,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -789,7 +912,7 @@ public class ForkJoinPool extends AbstractExecutorService {
if ((t = (ForkJoinTask<?>)U.getObject(a, j)) == null) if ((t = (ForkJoinTask<?>)U.getObject(a, j)) == null)
break; break;
if (U.compareAndSwapObject(a, j, t, null)) { if (U.compareAndSwapObject(a, j, t, null)) {
top = s; U.putOrderedInt(this, QTOP, s);
return t; return t;
} }
} }
...@@ -800,7 +923,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -800,7 +923,7 @@ public class ForkJoinPool extends AbstractExecutorService {
/** /**
* Takes a task in FIFO order if b is base of queue and a task * Takes a task in FIFO order if b is base of queue and a task
* can be claimed without contention. Specialized versions * can be claimed without contention. Specialized versions
* appear in ForkJoinPool methods scan and tryHelpStealer. * appear in ForkJoinPool methods scan and helpStealer.
*/ */
final ForkJoinTask<?> pollAt(int b) { final ForkJoinTask<?> pollAt(int b) {
ForkJoinTask<?> t; ForkJoinTask<?>[] a; ForkJoinTask<?> t; ForkJoinTask<?>[] a;
...@@ -808,7 +931,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -808,7 +931,7 @@ public class ForkJoinPool extends AbstractExecutorService {
int j = (((a.length - 1) & b) << ASHIFT) + ABASE; int j = (((a.length - 1) & b) << ASHIFT) + ABASE;
if ((t = (ForkJoinTask<?>)U.getObjectVolatile(a, j)) != null && if ((t = (ForkJoinTask<?>)U.getObjectVolatile(a, j)) != null &&
base == b && U.compareAndSwapObject(a, j, t, null)) { base == b && U.compareAndSwapObject(a, j, t, null)) {
U.putOrderedInt(this, QBASE, b + 1); base = b + 1;
return t; return t;
} }
} }
...@@ -823,16 +946,15 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -823,16 +946,15 @@ public class ForkJoinPool extends AbstractExecutorService {
while ((b = base) - top < 0 && (a = array) != null) { while ((b = base) - top < 0 && (a = array) != null) {
int j = (((a.length - 1) & b) << ASHIFT) + ABASE; int j = (((a.length - 1) & b) << ASHIFT) + ABASE;
t = (ForkJoinTask<?>)U.getObjectVolatile(a, j); t = (ForkJoinTask<?>)U.getObjectVolatile(a, j);
if (t != null) { if (base == b) {
if (U.compareAndSwapObject(a, j, t, null)) { if (t != null) {
U.putOrderedInt(this, QBASE, b + 1); if (U.compareAndSwapObject(a, j, t, null)) {
return t; base = b + 1;
return t;
}
} }
} else if (b + 1 == top) // now empty
else if (base == b) {
if (b + 1 == top)
break; break;
Thread.yield(); // wait for lagging update (very rare)
} }
} }
return null; return null;
...@@ -842,7 +964,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -842,7 +964,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* Takes next task, if one exists, in order specified by mode. * Takes next task, if one exists, in order specified by mode.
*/ */
final ForkJoinTask<?> nextLocalTask() { final ForkJoinTask<?> nextLocalTask() {
return mode == 0 ? pop() : poll(); return (config & FIFO_QUEUE) == 0 ? pop() : poll();
} }
/** /**
...@@ -852,7 +974,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -852,7 +974,7 @@ public class ForkJoinPool extends AbstractExecutorService {
ForkJoinTask<?>[] a = array; int m; ForkJoinTask<?>[] a = array; int m;
if (a == null || (m = a.length - 1) < 0) if (a == null || (m = a.length - 1) < 0)
return null; return null;
int i = mode == 0 ? top - 1 : base; int i = (config & FIFO_QUEUE) == 0 ? top - 1 : base;
int j = ((i & m) << ASHIFT) + ABASE; int j = ((i & m) << ASHIFT) + ABASE;
return (ForkJoinTask<?>)U.getObjectVolatile(a, j); return (ForkJoinTask<?>)U.getObjectVolatile(a, j);
} }
...@@ -860,13 +982,13 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -860,13 +982,13 @@ public class ForkJoinPool extends AbstractExecutorService {
/** /**
* Pops the given task only if it is at the current top. * Pops the given task only if it is at the current top.
* (A shared version is available only via FJP.tryExternalUnpush) * (A shared version is available only via FJP.tryExternalUnpush)
*/ */
final boolean tryUnpush(ForkJoinTask<?> t) { final boolean tryUnpush(ForkJoinTask<?> t) {
ForkJoinTask<?>[] a; int s; ForkJoinTask<?>[] a; int s;
if ((a = array) != null && (s = top) != base && if ((a = array) != null && (s = top) != base &&
U.compareAndSwapObject U.compareAndSwapObject
(a, (((a.length - 1) & --s) << ASHIFT) + ABASE, t, null)) { (a, (((a.length - 1) & --s) << ASHIFT) + ABASE, t, null)) {
top = s; U.putOrderedInt(this, QTOP, s);
return true; return true;
} }
return false; return false;
...@@ -876,9 +998,16 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -876,9 +998,16 @@ public class ForkJoinPool extends AbstractExecutorService {
* Removes and cancels all known tasks, ignoring any exceptions. * Removes and cancels all known tasks, ignoring any exceptions.
*/ */
final void cancelAll() { final void cancelAll() {
ForkJoinTask.cancelIgnoringExceptions(currentJoin); ForkJoinTask<?> t;
ForkJoinTask.cancelIgnoringExceptions(currentSteal); if ((t = currentJoin) != null) {
for (ForkJoinTask<?> t; (t = poll()) != null; ) currentJoin = null;
ForkJoinTask.cancelIgnoringExceptions(t);
}
if ((t = currentSteal) != null) {
currentSteal = null;
ForkJoinTask.cancelIgnoringExceptions(t);
}
while ((t = poll()) != null)
ForkJoinTask.cancelIgnoringExceptions(t); ForkJoinTask.cancelIgnoringExceptions(t);
} }
...@@ -893,167 +1022,186 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -893,167 +1022,186 @@ public class ForkJoinPool extends AbstractExecutorService {
} }
/** /**
* Executes a top-level task and any local tasks remaining * Removes and executes all local tasks. If LIFO, invokes
* after execution. * pollAndExecAll. Otherwise implements a specialized pop loop
* to exec until empty.
*/ */
final void runTask(ForkJoinTask<?> task) { final void execLocalTasks() {
if ((currentSteal = task) != null) { int b = base, m, s;
ForkJoinWorkerThread thread; ForkJoinTask<?>[] a = array;
task.doExec(); if (b - (s = top - 1) <= 0 && a != null &&
ForkJoinTask<?>[] a = array; (m = a.length - 1) >= 0) {
int md = mode; if ((config & FIFO_QUEUE) == 0) {
++nsteals; for (ForkJoinTask<?> t;;) {
currentSteal = null; if ((t = (ForkJoinTask<?>)U.getAndSetObject
if (md != 0) (a, ((m & s) << ASHIFT) + ABASE, null)) == null)
pollAndExecAll(); break;
else if (a != null) { U.putOrderedInt(this, QTOP, s);
int s, m = a.length - 1;
ForkJoinTask<?> t;
while ((s = top - 1) - base >= 0 &&
(t = (ForkJoinTask<?>)U.getAndSetObject
(a, ((m & s) << ASHIFT) + ABASE, null)) != null) {
top = s;
t.doExec(); t.doExec();
if (base - (s = top - 1) > 0)
break;
} }
} }
if ((thread = owner) != null) // no need to do in finally clause else
pollAndExecAll();
}
}
/**
* Executes the given task and any remaining local tasks.
*/
final void runTask(ForkJoinTask<?> task) {
if (task != null) {
scanState &= ~SCANNING; // mark as busy
(currentSteal = task).doExec();
U.putOrderedObject(this, QCURRENTSTEAL, null); // release for GC
execLocalTasks();
ForkJoinWorkerThread thread = owner;
if (++nsteals < 0) // collect on overflow
transferStealCount(pool);
scanState |= SCANNING;
if (thread != null)
thread.afterTopLevelExec(); thread.afterTopLevelExec();
} }
} }
/** /**
* If present, removes from queue and executes the given task, * Adds steal count to pool stealCounter if it exists, and resets.
* or any other cancelled task. Returns (true) on any CAS
* or consistency check failure so caller can retry.
*
* @return false if no progress can be made, else true
*/ */
final boolean tryRemoveAndExec(ForkJoinTask<?> task) { final void transferStealCount(ForkJoinPool p) {
boolean stat; AtomicLong sc;
ForkJoinTask<?>[] a; int m, s, b, n; if (p != null && (sc = p.stealCounter) != null) {
if (task != null && (a = array) != null && (m = a.length - 1) >= 0 && int s = nsteals;
(n = (s = top) - (b = base)) > 0) { nsteals = 0; // if negative, correct for overflow
boolean removed = false, empty = true; sc.getAndAdd((long)(s < 0 ? Integer.MAX_VALUE : s));
stat = true;
for (ForkJoinTask<?> t;;) { // traverse from s to b
long j = ((--s & m) << ASHIFT) + ABASE;
t = (ForkJoinTask<?>)U.getObject(a, j);
if (t == null) // inconsistent length
break;
else if (t == task) {
if (s + 1 == top) { // pop
if (!U.compareAndSwapObject(a, j, task, null))
break;
top = s;
removed = true;
}
else if (base == b) // replace with proxy
removed = U.compareAndSwapObject(a, j, task,
new EmptyTask());
break;
}
else if (t.status >= 0)
empty = false;
else if (s + 1 == top) { // pop and throw away
if (U.compareAndSwapObject(a, j, t, null))
top = s;
break;
}
if (--n == 0) {
if (!empty && base == b)
stat = false;
break;
}
}
if (removed)
task.doExec();
} }
else
stat = false;
return stat;
} }
/** /**
* Tries to poll for and execute the given task or any other * If present, removes from queue and executes the given task,
* task in its CountedCompleter computation. * or any other cancelled task. Used only by awaitJoin.
*
* @return true if queue empty and task not known to be done
*/ */
final boolean pollAndExecCC(CountedCompleter<?> root) { final boolean tryRemoveAndExec(ForkJoinTask<?> task) {
ForkJoinTask<?>[] a; int b; Object o; CountedCompleter<?> t, r; ForkJoinTask<?>[] a; int m, s, b, n;
if ((b = base) - top < 0 && (a = array) != null) { if ((a = array) != null && (m = a.length - 1) >= 0 &&
long j = (((a.length - 1) & b) << ASHIFT) + ABASE; task != null) {
if ((o = U.getObjectVolatile(a, j)) == null) while ((n = (s = top) - (b = base)) > 0) {
return true; // retry for (ForkJoinTask<?> t;;) { // traverse from s to b
if (o instanceof CountedCompleter) { long j = ((--s & m) << ASHIFT) + ABASE;
for (t = (CountedCompleter<?>)o, r = t;;) { if ((t = (ForkJoinTask<?>)U.getObject(a, j)) == null)
if (r == root) { return s + 1 == top; // shorter than expected
if (base == b && else if (t == task) {
U.compareAndSwapObject(a, j, t, null)) { boolean removed = false;
U.putOrderedInt(this, QBASE, b + 1); if (s + 1 == top) { // pop
t.doExec(); if (U.compareAndSwapObject(a, j, task, null)) {
U.putOrderedInt(this, QTOP, s);
removed = true;
}
} }
return true; else if (base == b) // replace with proxy
removed = U.compareAndSwapObject(
a, j, task, new EmptyTask());
if (removed)
task.doExec();
break;
} }
else if ((r = r.completer) == null) else if (t.status < 0 && s + 1 == top) {
break; // not part of root computation if (U.compareAndSwapObject(a, j, t, null))
U.putOrderedInt(this, QTOP, s);
break; // was cancelled
}
if (--n == 0)
return false;
} }
if (task.status < 0)
return false;
} }
} }
return false; return true;
} }
/** /**
* Tries to pop and execute the given task or any other task * Pops task if in the same CC computation as the given task,
* in its CountedCompleter computation. * in either shared or owned mode. Used only by helpComplete.
*/ */
final boolean externalPopAndExecCC(CountedCompleter<?> root) { final CountedCompleter<?> popCC(CountedCompleter<?> task, int mode) {
ForkJoinTask<?>[] a; int s; Object o; CountedCompleter<?> t, r; int s; ForkJoinTask<?>[] a; Object o;
if (base - (s = top) < 0 && (a = array) != null) { if (base - (s = top) < 0 && (a = array) != null) {
long j = (((a.length - 1) & (s - 1)) << ASHIFT) + ABASE; long j = (((a.length - 1) & (s - 1)) << ASHIFT) + ABASE;
if ((o = U.getObject(a, j)) instanceof CountedCompleter) { if ((o = U.getObjectVolatile(a, j)) != null &&
for (t = (CountedCompleter<?>)o, r = t;;) { (o instanceof CountedCompleter)) {
if (r == root) { CountedCompleter<?> t = (CountedCompleter<?>)o;
if (U.compareAndSwapInt(this, QLOCK, 0, 1)) { for (CountedCompleter<?> r = t;;) {
if (top == s && array == a && if (r == task) {
U.compareAndSwapObject(a, j, t, null)) { if (mode < 0) { // must lock
top = s - 1; if (U.compareAndSwapInt(this, QLOCK, 0, 1)) {
qlock = 0; if (top == s && array == a &&
t.doExec(); U.compareAndSwapObject(a, j, t, null)) {
U.putOrderedInt(this, QTOP, s - 1);
U.putOrderedInt(this, QLOCK, 0);
return t;
}
U.compareAndSwapInt(this, QLOCK, 1, 0);
} }
else
qlock = 0;
} }
return true; else if (U.compareAndSwapObject(a, j, t, null)) {
U.putOrderedInt(this, QTOP, s - 1);
return t;
}
break;
} }
else if ((r = r.completer) == null) else if ((r = r.completer) == null) // try parent
break; break;
} }
} }
} }
return false; return null;
} }
/** /**
* Internal version * Steals and runs a task in the same CC computation as the
* given task if one exists and can be taken without
* contention. Otherwise returns a checksum/control value for
* use by method helpComplete.
*
* @return 1 if successful, 2 if retryable (lost to another
* stealer), -1 if non-empty but no matching task found, else
* the base index, forced negative.
*/ */
final boolean internalPopAndExecCC(CountedCompleter<?> root) { final int pollAndExecCC(CountedCompleter<?> task) {
ForkJoinTask<?>[] a; int s; Object o; CountedCompleter<?> t, r; int b, h; ForkJoinTask<?>[] a; Object o;
if (base - (s = top) < 0 && (a = array) != null) { if ((b = base) - top >= 0 || (a = array) == null)
long j = (((a.length - 1) & (s - 1)) << ASHIFT) + ABASE; h = b | Integer.MIN_VALUE; // to sense movement on re-poll
if ((o = U.getObject(a, j)) instanceof CountedCompleter) { else {
for (t = (CountedCompleter<?>)o, r = t;;) { long j = (((a.length - 1) & b) << ASHIFT) + ABASE;
if (r == root) { if ((o = U.getObjectVolatile(a, j)) == null)
if (U.compareAndSwapObject(a, j, t, null)) { h = 2; // retryable
top = s - 1; else if (!(o instanceof CountedCompleter))
h = -1; // unmatchable
else {
CountedCompleter<?> t = (CountedCompleter<?>)o;
for (CountedCompleter<?> r = t;;) {
if (r == task) {
if (base == b &&
U.compareAndSwapObject(a, j, t, null)) {
base = b + 1;
t.doExec(); t.doExec();
h = 1; // success
} }
return true; else
h = 2; // lost CAS
break;
} }
else if ((r = r.completer) == null) else if ((r = r.completer) == null) {
h = -1; // unmatched
break; break;
}
} }
} }
} }
return false; return h;
} }
/** /**
...@@ -1061,28 +1209,31 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1061,28 +1209,31 @@ public class ForkJoinPool extends AbstractExecutorService {
*/ */
final boolean isApparentlyUnblocked() { final boolean isApparentlyUnblocked() {
Thread wt; Thread.State s; Thread wt; Thread.State s;
return (eventCount >= 0 && return (scanState >= 0 &&
(wt = owner) != null && (wt = owner) != null &&
(s = wt.getState()) != Thread.State.BLOCKED && (s = wt.getState()) != Thread.State.BLOCKED &&
s != Thread.State.WAITING && s != Thread.State.WAITING &&
s != Thread.State.TIMED_WAITING); s != Thread.State.TIMED_WAITING);
} }
// Unsafe mechanics // Unsafe mechanics. Note that some are (and must be) the same as in FJP
private static final sun.misc.Unsafe U; private static final sun.misc.Unsafe U;
private static final long QBASE; private static final int ABASE;
private static final int ASHIFT;
private static final long QTOP;
private static final long QLOCK; private static final long QLOCK;
private static final int ABASE; private static final long QCURRENTSTEAL;
private static final int ASHIFT;
static { static {
try { try {
U = sun.misc.Unsafe.getUnsafe(); U = sun.misc.Unsafe.getUnsafe();
Class<?> k = WorkQueue.class; Class<?> wk = WorkQueue.class;
Class<?> ak = ForkJoinTask[].class; Class<?> ak = ForkJoinTask[].class;
QBASE = U.objectFieldOffset QTOP = U.objectFieldOffset
(k.getDeclaredField("base")); (wk.getDeclaredField("top"));
QLOCK = U.objectFieldOffset QLOCK = U.objectFieldOffset
(k.getDeclaredField("qlock")); (wk.getDeclaredField("qlock"));
QCURRENTSTEAL = U.objectFieldOffset
(wk.getDeclaredField("currentSteal"));
ABASE = U.arrayBaseOffset(ak); ABASE = U.arrayBaseOffset(ak);
int scale = U.arrayIndexScale(ak); int scale = U.arrayIndexScale(ak);
if ((scale & (scale - 1)) != 0) if ((scale & (scale - 1)) != 0)
...@@ -1125,6 +1276,11 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1125,6 +1276,11 @@ public class ForkJoinPool extends AbstractExecutorService {
*/ */
static final int commonParallelism; static final int commonParallelism;
/**
* Limit on spare thread construction in tryCompensate.
*/
private static int commonMaxSpares;
/** /**
* Sequence number for creating workerNamePrefix. * Sequence number for creating workerNamePrefix.
*/ */
...@@ -1138,7 +1294,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1138,7 +1294,7 @@ public class ForkJoinPool extends AbstractExecutorService {
return ++poolNumberSequence; return ++poolNumberSequence;
} }
// static constants // static configuration constants
/** /**
* Initial timeout value (in nanoseconds) for the thread * Initial timeout value (in nanoseconds) for the thread
...@@ -1148,27 +1304,32 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1148,27 +1304,32 @@ public class ForkJoinPool extends AbstractExecutorService {
* aggressive shrinkage during most transient stalls (long GCs * aggressive shrinkage during most transient stalls (long GCs
* etc). * etc).
*/ */
private static final long IDLE_TIMEOUT = 2000L * 1000L * 1000L; // 2sec private static final long IDLE_TIMEOUT = 2000L * 1000L * 1000L; // 2sec
/** /**
* Timeout value when there are more threads than parallelism level * Tolerance for idle timeouts, to cope with timer undershoots
*/ */
private static final long FAST_IDLE_TIMEOUT = 200L * 1000L * 1000L; private static final long TIMEOUT_SLOP = 20L * 1000L * 1000L; // 20ms
/** /**
* Tolerance for idle timeouts, to cope with timer undershoots * The initial value for commonMaxSpares during static
* initialization. The value is far in excess of normal
* requirements, but also far short of MAX_CAP and typical
* OS thread limits, so allows JVMs to catch misuse/abuse
* before running out of resources needed to do so.
*/ */
private static final long TIMEOUT_SLOP = 2000000L; private static final int DEFAULT_COMMON_MAX_SPARES = 256;
/** /**
* The maximum stolen->joining link depth allowed in method * Number of times to spin-wait before blocking. The spins (in
* tryHelpStealer. Must be a power of two. Depths for legitimate * awaitRunStateLock and awaitWork) currently use randomized
* chains are unbounded, but we use a fixed constant to avoid * spins. If/when MWAIT-like intrinsics becomes available, they
* (otherwise unchecked) cycles and to bound staleness of * may allow quieter spinning. The value of SPINS must be a power
* traversal parameters at the expense of sometimes blocking when * of two, at least 4. The current value causes spinning for a
* we could be helping. * small fraction of typical context-switch times, well worthwhile
* given the typical likelihoods that blocking is not necessary.
*/ */
private static final int MAX_HELP = 64; private static final int SPINS = 1 << 11;
/** /**
* Increment for seed generators. See class ThreadLocal for * Increment for seed generators. See class ThreadLocal for
...@@ -1177,209 +1338,212 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1177,209 +1338,212 @@ public class ForkJoinPool extends AbstractExecutorService {
private static final int SEED_INCREMENT = 0x9e3779b9; private static final int SEED_INCREMENT = 0x9e3779b9;
/* /*
* Bits and masks for control variables * Bits and masks for field ctl, packed with 4 16 bit subfields:
* * AC: Number of active running workers minus target parallelism
* Field ctl is a long packed with: * TC: Number of total workers minus target parallelism
* AC: Number of active running workers minus target parallelism (16 bits) * SS: version count and status of top waiting thread
* TC: Number of total workers minus target parallelism (16 bits) * ID: poolIndex of top of Treiber stack of waiters
* ST: true if pool is terminating (1 bit) *
* EC: the wait count of top waiting thread (15 bits) * When convenient, we can extract the lower 32 stack top bits
* ID: poolIndex of top of Treiber stack of waiters (16 bits) * (including version bits) as sp=(int)ctl. The offsets of counts
* * by the target parallelism and the positionings of fields makes
* When convenient, we can extract the upper 32 bits of counts and * it possible to perform the most common checks via sign tests of
* the lower 32 bits of queue state, u = (int)(ctl >>> 32) and e = * fields: When ac is negative, there are not enough active
* (int)ctl. The ec field is never accessed alone, but always * workers, when tc is negative, there are not enough total
* together with id and st. The offsets of counts by the target * workers. When sp is non-zero, there are waiting workers. To
* parallelism and the positionings of fields makes it possible to * deal with possibly negative fields, we use casts in and out of
* perform the most common checks via sign tests of fields: When * "short" and/or signed shifts to maintain signedness.
* ac is negative, there are not enough active workers, when tc is *
* negative, there are not enough total workers, and when e is * Because it occupies uppermost bits, we can add one active count
* negative, the pool is terminating. To deal with these possibly * using getAndAddLong of AC_UNIT, rather than CAS, when returning
* negative fields, we use casts in and out of "short" and/or * from a blocked join. Other updates entail multiple subfields
* signed shifts to maintain signedness. * and masking, requiring CAS.
* */
* When a thread is queued (inactivated), its eventCount field is
* set negative, which is the only way to tell if a worker is // Lower and upper word masks
* prevented from executing tasks, even though it must continue to private static final long SP_MASK = 0xffffffffL;
* scan for them to avoid queuing races. Note however that private static final long UC_MASK = ~SP_MASK;
* eventCount updates lag releases so usage requires care.
* // Active counts
* Field plock is an int packed with:
* SHUTDOWN: true if shutdown is enabled (1 bit)
* SEQ: a sequence lock, with PL_LOCK bit set if locked (30 bits)
* SIGNAL: set when threads may be waiting on the lock (1 bit)
*
* The sequence number enables simple consistency checks:
* Staleness of read-only operations on the workQueues array can
* be checked by comparing plock before vs after the reads.
*/
// bit positions/shifts for fields
private static final int AC_SHIFT = 48; private static final int AC_SHIFT = 48;
private static final long AC_UNIT = 0x0001L << AC_SHIFT;
private static final long AC_MASK = 0xffffL << AC_SHIFT;
// Total counts
private static final int TC_SHIFT = 32; private static final int TC_SHIFT = 32;
private static final int ST_SHIFT = 31; private static final long TC_UNIT = 0x0001L << TC_SHIFT;
private static final int EC_SHIFT = 16; private static final long TC_MASK = 0xffffL << TC_SHIFT;
private static final long ADD_WORKER = 0x0001L << (TC_SHIFT + 15); // sign
// bounds
private static final int SMASK = 0xffff; // short bits // runState bits: SHUTDOWN must be negative, others arbitrary powers of two
private static final int MAX_CAP = 0x7fff; // max #workers - 1 private static final int RSLOCK = 1;
private static final int EVENMASK = 0xfffe; // even short bits private static final int RSIGNAL = 1 << 1;
private static final int SQMASK = 0x007e; // max 64 (even) slots private static final int STARTED = 1 << 2;
private static final int SHORT_SIGN = 1 << 15; private static final int STOP = 1 << 29;
private static final int INT_SIGN = 1 << 31; private static final int TERMINATED = 1 << 30;
private static final int SHUTDOWN = 1 << 31;
// masks
private static final long STOP_BIT = 0x0001L << ST_SHIFT;
private static final long AC_MASK = ((long)SMASK) << AC_SHIFT;
private static final long TC_MASK = ((long)SMASK) << TC_SHIFT;
// units for incrementing and decrementing
private static final long TC_UNIT = 1L << TC_SHIFT;
private static final long AC_UNIT = 1L << AC_SHIFT;
// masks and units for dealing with u = (int)(ctl >>> 32)
private static final int UAC_SHIFT = AC_SHIFT - 32;
private static final int UTC_SHIFT = TC_SHIFT - 32;
private static final int UAC_MASK = SMASK << UAC_SHIFT;
private static final int UTC_MASK = SMASK << UTC_SHIFT;
private static final int UAC_UNIT = 1 << UAC_SHIFT;
private static final int UTC_UNIT = 1 << UTC_SHIFT;
// masks and units for dealing with e = (int)ctl
private static final int E_MASK = 0x7fffffff; // no STOP_BIT
private static final int E_SEQ = 1 << EC_SHIFT;
// plock bits
private static final int SHUTDOWN = 1 << 31;
private static final int PL_LOCK = 2;
private static final int PL_SIGNAL = 1;
private static final int PL_SPINS = 1 << 8;
// access mode for WorkQueue
static final int LIFO_QUEUE = 0;
static final int FIFO_QUEUE = 1;
static final int SHARED_QUEUE = -1;
// Instance fields // Instance fields
volatile long stealCount; // collects worker counts volatile long ctl; // main pool control
volatile long ctl; // main pool control volatile int runState; // lockable status
volatile int plock; // shutdown status and seqLock final int config; // parallelism, mode
volatile int indexSeed; // worker/submitter index seed int indexSeed; // to generate worker index
final short parallelism; // parallelism level volatile WorkQueue[] workQueues; // main registry
final short mode; // LIFO/FIFO
WorkQueue[] workQueues; // main registry
final ForkJoinWorkerThreadFactory factory; final ForkJoinWorkerThreadFactory factory;
final UncaughtExceptionHandler ueh; // per-worker UEH final UncaughtExceptionHandler ueh; // per-worker UEH
final String workerNamePrefix; // to create worker name string final String workerNamePrefix; // to create worker name string
volatile AtomicLong stealCounter; // also used as sync monitor
/** /**
* Acquires the plock lock to protect worker array and related * Acquires the runState lock; returns current (locked) runState.
* updates. This method is called only if an initial CAS on plock
* fails. This acts as a spinlock for normal cases, but falls back
* to builtin monitor to block when (rarely) needed. This would be
* a terrible idea for a highly contended lock, but works fine as
* a more conservative alternative to a pure spinlock.
*/ */
private int acquirePlock() { private int lockRunState() {
int spins = PL_SPINS, ps, nps; int rs;
for (;;) { return ((((rs = runState) & RSLOCK) != 0 ||
if (((ps = plock) & PL_LOCK) == 0 && !U.compareAndSwapInt(this, RUNSTATE, rs, rs |= RSLOCK)) ?
U.compareAndSwapInt(this, PLOCK, ps, nps = ps + PL_LOCK)) awaitRunStateLock() : rs);
return nps; }
else if (spins >= 0) {
if (ThreadLocalRandom.nextSecondarySeed() >= 0) /**
* Spins and/or blocks until runstate lock is available. See
* above for explanation.
*/
private int awaitRunStateLock() {
Object lock;
boolean wasInterrupted = false;
for (int spins = SPINS, r = 0, rs, ns;;) {
if (((rs = runState) & RSLOCK) == 0) {
if (U.compareAndSwapInt(this, RUNSTATE, rs, ns = rs | RSLOCK)) {
if (wasInterrupted) {
try {
Thread.currentThread().interrupt();
} catch (SecurityException ignore) {
}
}
return ns;
}
}
else if (r == 0)
r = ThreadLocalRandom.nextSecondarySeed();
else if (spins > 0) {
r ^= r << 6; r ^= r >>> 21; r ^= r << 7; // xorshift
if (r >= 0)
--spins; --spins;
} }
else if (U.compareAndSwapInt(this, PLOCK, ps, ps | PL_SIGNAL)) { else if ((rs & STARTED) == 0 || (lock = stealCounter) == null)
synchronized (this) { Thread.yield(); // initialization race
if ((plock & PL_SIGNAL) != 0) { else if (U.compareAndSwapInt(this, RUNSTATE, rs, rs | RSIGNAL)) {
synchronized (lock) {
if ((runState & RSIGNAL) != 0) {
try { try {
wait(); lock.wait();
} catch (InterruptedException ie) { } catch (InterruptedException ie) {
try { if (!(Thread.currentThread() instanceof
Thread.currentThread().interrupt(); ForkJoinWorkerThread))
} catch (SecurityException ignore) { wasInterrupted = true;
}
} }
} }
else else
notifyAll(); lock.notifyAll();
} }
} }
} }
} }
/** /**
* Unlocks and signals any thread waiting for plock. Called only * Unlocks and sets runState to newRunState.
* when CAS of seq value for unlock fails. *
* @param oldRunState a value returned from lockRunState
* @param newRunState the next value (must have lock bit clear).
*/ */
private void releasePlock(int ps) { private void unlockRunState(int oldRunState, int newRunState) {
plock = ps; if (!U.compareAndSwapInt(this, RUNSTATE, oldRunState, newRunState)) {
synchronized (this) { notifyAll(); } Object lock = stealCounter;
runState = newRunState; // clears RSIGNAL bit
if (lock != null)
synchronized (lock) { lock.notifyAll(); }
}
} }
// Creating, registering and deregistering workers
/** /**
* Tries to create and start one worker if fewer than target * Tries to construct and start one worker. Assumes that total
* parallelism level exist. Adjusts counts etc on failure. * count has already been incremented as a reservation. Invokes
* deregisterWorker on any failure.
*
* @return true if successful
*/ */
private void tryAddWorker() { private boolean createWorker() {
long c; int u, e; ForkJoinWorkerThreadFactory fac = factory;
while ((u = (int)((c = ctl) >>> 32)) < 0 && Throwable ex = null;
(u & SHORT_SIGN) != 0 && (e = (int)c) >= 0) { ForkJoinWorkerThread wt = null;
long nc = ((long)(((u + UTC_UNIT) & UTC_MASK) | try {
((u + UAC_UNIT) & UAC_MASK)) << 32) | (long)e; if (fac != null && (wt = fac.newThread(this)) != null) {
if (U.compareAndSwapLong(this, CTL, c, nc)) { wt.start();
ForkJoinWorkerThreadFactory fac; return true;
Throwable ex = null;
ForkJoinWorkerThread wt = null;
try {
if ((fac = factory) != null &&
(wt = fac.newThread(this)) != null) {
wt.start();
break;
}
} catch (Throwable rex) {
ex = rex;
}
deregisterWorker(wt, ex);
break;
} }
} catch (Throwable rex) {
ex = rex;
} }
deregisterWorker(wt, ex);
return false;
} }
// Registering and deregistering workers /**
* Tries to add one worker, incrementing ctl counts before doing
* so, relying on createWorker to back out on failure.
*
* @param c incoming ctl value, with total count negative and no
* idle workers. On CAS failure, c is refreshed and retried if
* this holds (otherwise, a new worker is not needed).
*/
private void tryAddWorker(long c) {
boolean add = false;
do {
long nc = ((AC_MASK & (c + AC_UNIT)) |
(TC_MASK & (c + TC_UNIT)));
if (ctl == c) {
int rs, stop; // check if terminating
if ((stop = (rs = lockRunState()) & STOP) == 0)
add = U.compareAndSwapLong(this, CTL, c, nc);
unlockRunState(rs, rs & ~RSLOCK);
if (stop != 0)
break;
if (add) {
createWorker();
break;
}
}
} while (((c = ctl) & ADD_WORKER) != 0L && (int)c == 0);
}
/** /**
* Callback from ForkJoinWorkerThread to establish and record its * Callback from ForkJoinWorkerThread constructor to establish and
* WorkQueue. To avoid scanning bias due to packing entries in * record its WorkQueue.
* front of the workQueues array, we treat the array as a simple
* power-of-two hash table using per-thread seed as hash,
* expanding as needed.
* *
* @param wt the worker thread * @param wt the worker thread
* @return the worker's queue * @return the worker's queue
*/ */
final WorkQueue registerWorker(ForkJoinWorkerThread wt) { final WorkQueue registerWorker(ForkJoinWorkerThread wt) {
UncaughtExceptionHandler handler; WorkQueue[] ws; int s, ps; UncaughtExceptionHandler handler;
wt.setDaemon(true); wt.setDaemon(true); // configure thread
if ((handler = ueh) != null) if ((handler = ueh) != null)
wt.setUncaughtExceptionHandler(handler); wt.setUncaughtExceptionHandler(handler);
do {} while (!U.compareAndSwapInt(this, INDEXSEED, s = indexSeed, WorkQueue w = new WorkQueue(this, wt);
s += SEED_INCREMENT) || int i = 0; // assign a pool index
s == 0); // skip 0 int mode = config & MODE_MASK;
WorkQueue w = new WorkQueue(this, wt, mode, s); int rs = lockRunState();
if (((ps = plock) & PL_LOCK) != 0 ||
!U.compareAndSwapInt(this, PLOCK, ps, ps += PL_LOCK))
ps = acquirePlock();
int nps = (ps & SHUTDOWN) | ((ps + PL_LOCK) & ~SHUTDOWN);
try { try {
if ((ws = workQueues) != null) { // skip if shutting down WorkQueue[] ws; int n; // skip if no array
int n = ws.length, m = n - 1; if ((ws = workQueues) != null && (n = ws.length) > 0) {
int r = (s << 1) | 1; // use odd-numbered indices int s = indexSeed += SEED_INCREMENT; // unlikely to collide
if (ws[r &= m] != null) { // collision int m = n - 1;
int probes = 0; // step by approx half size i = ((s << 1) | 1) & m; // odd-numbered indices
if (ws[i] != null) { // collision
int probes = 0; // step by approx half n
int step = (n <= 4) ? 2 : ((n >>> 1) & EVENMASK) + 2; int step = (n <= 4) ? 2 : ((n >>> 1) & EVENMASK) + 2;
while (ws[r = (r + step) & m] != null) { while (ws[i = (i + step) & m] != null) {
if (++probes >= n) { if (++probes >= n) {
workQueues = ws = Arrays.copyOf(ws, n <<= 1); workQueues = ws = Arrays.copyOf(ws, n <<= 1);
m = n - 1; m = n - 1;
...@@ -1387,15 +1551,15 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1387,15 +1551,15 @@ public class ForkJoinPool extends AbstractExecutorService {
} }
} }
} }
w.poolIndex = (short)r; w.hint = s; // use as random seed
w.eventCount = r; // volatile write orders w.config = i | mode;
ws[r] = w; w.scanState = i; // publication fence
ws[i] = w;
} }
} finally { } finally {
if (!U.compareAndSwapInt(this, PLOCK, ps, nps)) unlockRunState(rs, rs & ~RSLOCK);
releasePlock(nps);
} }
wt.setName(workerNamePrefix.concat(Integer.toString(w.poolIndex >>> 1))); wt.setName(workerNamePrefix.concat(Integer.toString(i >>> 1)));
return w; return w;
} }
...@@ -1411,384 +1575,322 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1411,384 +1575,322 @@ public class ForkJoinPool extends AbstractExecutorService {
final void deregisterWorker(ForkJoinWorkerThread wt, Throwable ex) { final void deregisterWorker(ForkJoinWorkerThread wt, Throwable ex) {
WorkQueue w = null; WorkQueue w = null;
if (wt != null && (w = wt.workQueue) != null) { if (wt != null && (w = wt.workQueue) != null) {
int ps; WorkQueue[] ws; // remove index from array
w.qlock = -1; // ensure set int idx = w.config & SMASK;
U.getAndAddLong(this, STEALCOUNT, w.nsteals); // collect steals int rs = lockRunState();
if (((ps = plock) & PL_LOCK) != 0 || if ((ws = workQueues) != null && ws.length > idx && ws[idx] == w)
!U.compareAndSwapInt(this, PLOCK, ps, ps += PL_LOCK)) ws[idx] = null;
ps = acquirePlock(); unlockRunState(rs, rs & ~RSLOCK);
int nps = (ps & SHUTDOWN) | ((ps + PL_LOCK) & ~SHUTDOWN); }
try { long c; // decrement counts
int idx = w.poolIndex;
WorkQueue[] ws = workQueues;
if (ws != null && idx >= 0 && idx < ws.length && ws[idx] == w)
ws[idx] = null;
} finally {
if (!U.compareAndSwapInt(this, PLOCK, ps, nps))
releasePlock(nps);
}
}
long c; // adjust ctl counts
do {} while (!U.compareAndSwapLong do {} while (!U.compareAndSwapLong
(this, CTL, c = ctl, (((c - AC_UNIT) & AC_MASK) | (this, CTL, c = ctl, ((AC_MASK & (c - AC_UNIT)) |
((c - TC_UNIT) & TC_MASK) | (TC_MASK & (c - TC_UNIT)) |
(c & ~(AC_MASK|TC_MASK))))); (SP_MASK & c))));
if (w != null) {
if (!tryTerminate(false, false) && w != null && w.array != null) { w.qlock = -1; // ensure set
w.cancelAll(); // cancel remaining tasks w.transferStealCount(this);
WorkQueue[] ws; WorkQueue v; Thread p; int u, i, e; w.cancelAll(); // cancel remaining tasks
while ((u = (int)((c = ctl) >>> 32)) < 0 && (e = (int)c) >= 0) { }
if (e > 0) { // activate or create replacement for (;;) { // possibly replace
if ((ws = workQueues) == null || WorkQueue[] ws; int m, sp;
(i = e & SMASK) >= ws.length || if (tryTerminate(false, false) || w == null || w.array == null ||
(v = ws[i]) == null) (runState & STOP) != 0 || (ws = workQueues) == null ||
break; (m = ws.length - 1) < 0) // already terminating
long nc = (((long)(v.nextWait & E_MASK)) | break;
((long)(u + UAC_UNIT) << 32)); if ((sp = (int)(c = ctl)) != 0) { // wake up replacement
if (v.eventCount != (e | INT_SIGN)) if (tryRelease(c, ws[sp & m], AC_UNIT))
break;
if (U.compareAndSwapLong(this, CTL, c, nc)) {
v.eventCount = (e + E_SEQ) & E_MASK;
if ((p = v.parker) != null)
U.unpark(p);
break;
}
}
else {
if ((short)u < 0)
tryAddWorker();
break; break;
}
} }
else if (ex != null && (c & ADD_WORKER) != 0L) {
tryAddWorker(c); // create replacement
break;
}
else // don't need replacement
break;
} }
if (ex == null) // help clean refs on way out if (ex == null) // help clean on way out
ForkJoinTask.helpExpungeStaleExceptions(); ForkJoinTask.helpExpungeStaleExceptions();
else // rethrow else // rethrow
ForkJoinTask.rethrow(ex); ForkJoinTask.rethrow(ex);
} }
// Submissions // Signalling
/**
* Unless shutting down, adds the given task to a submission queue
* at submitter's current queue index (modulo submission
* range). Only the most common path is directly handled in this
* method. All others are relayed to fullExternalPush.
*
* @param task the task. Caller must ensure non-null.
*/
final void externalPush(ForkJoinTask<?> task) {
WorkQueue q; int m, s, n, am; ForkJoinTask<?>[] a;
int r = ThreadLocalRandom.getProbe();
int ps = plock;
WorkQueue[] ws = workQueues;
if (ps > 0 && ws != null && (m = (ws.length - 1)) >= 0 &&
(q = ws[m & r & SQMASK]) != null && r != 0 &&
U.compareAndSwapInt(q, QLOCK, 0, 1)) { // lock
if ((a = q.array) != null &&
(am = a.length - 1) > (n = (s = q.top) - q.base)) {
int j = ((am & s) << ASHIFT) + ABASE;
U.putOrderedObject(a, j, task);
q.top = s + 1; // push on to deque
q.qlock = 0;
if (n <= 1)
signalWork(ws, q);
return;
}
q.qlock = 0;
}
fullExternalPush(task);
}
/**
* Full version of externalPush. This method is called, among
* other times, upon the first submission of the first task to the
* pool, so must perform secondary initialization. It also
* detects first submission by an external thread by looking up
* its ThreadLocal, and creates a new shared queue if the one at
* index if empty or contended. The plock lock body must be
* exception-free (so no try/finally) so we optimistically
* allocate new queues outside the lock and throw them away if
* (very rarely) not needed.
*
* Secondary initialization occurs when plock is zero, to create
* workQueue array and set plock to a valid value. This lock body
* must also be exception-free. Because the plock seq value can
* eventually wrap around zero, this method harmlessly fails to
* reinitialize if workQueues exists, while still advancing plock.
*/
private void fullExternalPush(ForkJoinTask<?> task) {
int r;
if ((r = ThreadLocalRandom.getProbe()) == 0) {
ThreadLocalRandom.localInit();
r = ThreadLocalRandom.getProbe();
}
for (;;) {
WorkQueue[] ws; WorkQueue q; int ps, m, k;
boolean move = false;
if ((ps = plock) < 0)
throw new RejectedExecutionException();
else if (ps == 0 || (ws = workQueues) == null ||
(m = ws.length - 1) < 0) { // initialize workQueues
int p = parallelism; // find power of two table size
int n = (p > 1) ? p - 1 : 1; // ensure at least 2 slots
n |= n >>> 1; n |= n >>> 2; n |= n >>> 4;
n |= n >>> 8; n |= n >>> 16; n = (n + 1) << 1;
WorkQueue[] nws = ((ws = workQueues) == null || ws.length == 0 ?
new WorkQueue[n] : null);
if (((ps = plock) & PL_LOCK) != 0 ||
!U.compareAndSwapInt(this, PLOCK, ps, ps += PL_LOCK))
ps = acquirePlock();
if (((ws = workQueues) == null || ws.length == 0) && nws != null)
workQueues = nws;
int nps = (ps & SHUTDOWN) | ((ps + PL_LOCK) & ~SHUTDOWN);
if (!U.compareAndSwapInt(this, PLOCK, ps, nps))
releasePlock(nps);
}
else if ((q = ws[k = r & m & SQMASK]) != null) {
if (q.qlock == 0 && U.compareAndSwapInt(q, QLOCK, 0, 1)) {
ForkJoinTask<?>[] a = q.array;
int s = q.top;
boolean submitted = false;
try { // locked version of push
if ((a != null && a.length > s + 1 - q.base) ||
(a = q.growArray()) != null) { // must presize
int j = (((a.length - 1) & s) << ASHIFT) + ABASE;
U.putOrderedObject(a, j, task);
q.top = s + 1;
submitted = true;
}
} finally {
q.qlock = 0; // unlock
}
if (submitted) {
signalWork(ws, q);
return;
}
}
move = true; // move on failure
}
else if (((ps = plock) & PL_LOCK) == 0) { // create new queue
q = new WorkQueue(this, null, SHARED_QUEUE, r);
q.poolIndex = (short)k;
if (((ps = plock) & PL_LOCK) != 0 ||
!U.compareAndSwapInt(this, PLOCK, ps, ps += PL_LOCK))
ps = acquirePlock();
if ((ws = workQueues) != null && k < ws.length && ws[k] == null)
ws[k] = q;
int nps = (ps & SHUTDOWN) | ((ps + PL_LOCK) & ~SHUTDOWN);
if (!U.compareAndSwapInt(this, PLOCK, ps, nps))
releasePlock(nps);
}
else
move = true; // move if busy
if (move)
r = ThreadLocalRandom.advanceProbe(r);
}
}
// Maintaining ctl counts
/**
* Increments active count; mainly called upon return from blocking.
*/
final void incrementActiveCount() {
long c;
do {} while (!U.compareAndSwapLong
(this, CTL, c = ctl, ((c & ~AC_MASK) |
((c & AC_MASK) + AC_UNIT))));
}
/** /**
* Tries to create or activate a worker if too few are active. * Tries to create or activate a worker if too few are active.
* *
* @param ws the worker array to use to find signallees * @param ws the worker array to use to find signallees
* @param q if non-null, the queue holding tasks to be processed * @param q a WorkQueue --if non-null, don't retry if now empty
*/ */
final void signalWork(WorkQueue[] ws, WorkQueue q) { final void signalWork(WorkQueue[] ws, WorkQueue q) {
for (;;) { long c; int sp, i; WorkQueue v; Thread p;
long c; int e, u, i; WorkQueue w; Thread p; while ((c = ctl) < 0L) { // too few active
if ((u = (int)((c = ctl) >>> 32)) >= 0) if ((sp = (int)c) == 0) { // no idle workers
break; if ((c & ADD_WORKER) != 0L) // too few workers
if ((e = (int)c) <= 0) { tryAddWorker(c);
if ((short)u < 0)
tryAddWorker();
break; break;
} }
if (ws == null || ws.length <= (i = e & SMASK) || if (ws == null) // unstarted/terminated
(w = ws[i]) == null) break;
if (ws.length <= (i = sp & SMASK)) // terminated
break; break;
long nc = (((long)(w.nextWait & E_MASK)) | if ((v = ws[i]) == null) // terminating
((long)(u + UAC_UNIT)) << 32); break;
int ne = (e + E_SEQ) & E_MASK; int vs = (sp + SS_SEQ) & ~INACTIVE; // next scanState
if (w.eventCount == (e | INT_SIGN) && int d = sp - v.scanState; // screen CAS
U.compareAndSwapLong(this, CTL, c, nc)) { long nc = (UC_MASK & (c + AC_UNIT)) | (SP_MASK & v.stackPred);
w.eventCount = ne; if (d == 0 && U.compareAndSwapLong(this, CTL, c, nc)) {
if ((p = w.parker) != null) v.scanState = vs; // activate v
if ((p = v.parker) != null)
U.unpark(p); U.unpark(p);
break; break;
} }
if (q != null && q.base >= q.top) if (q != null && q.base == q.top) // no more work
break; break;
} }
} }
/**
* Signals and releases worker v if it is top of idle worker
* stack. This performs a one-shot version of signalWork only if
* there is (apparently) at least one idle worker.
*
* @param c incoming ctl value
* @param v if non-null, a worker
* @param inc the increment to active count (zero when compensating)
* @return true if successful
*/
private boolean tryRelease(long c, WorkQueue v, long inc) {
int sp = (int)c, vs = (sp + SS_SEQ) & ~INACTIVE; Thread p;
if (v != null && v.scanState == sp) { // v is at top of stack
long nc = (UC_MASK & (c + inc)) | (SP_MASK & v.stackPred);
if (U.compareAndSwapLong(this, CTL, c, nc)) {
v.scanState = vs;
if ((p = v.parker) != null)
U.unpark(p);
return true;
}
}
return false;
}
// Scanning for tasks // Scanning for tasks
/** /**
* Top-level runloop for workers, called by ForkJoinWorkerThread.run. * Top-level runloop for workers, called by ForkJoinWorkerThread.run.
*/ */
final void runWorker(WorkQueue w) { final void runWorker(WorkQueue w) {
w.growArray(); // allocate queue w.growArray(); // allocate queue
for (int r = w.hint; scan(w, r) == 0; ) { int seed = w.hint; // initially holds randomization hint
int r = (seed == 0) ? 1 : seed; // avoid 0 for xorShift
for (ForkJoinTask<?> t;;) {
if ((t = scan(w, r)) != null)
w.runTask(t);
else if (!awaitWork(w, r))
break;
r ^= r << 13; r ^= r >>> 17; r ^= r << 5; // xorshift r ^= r << 13; r ^= r >>> 17; r ^= r << 5; // xorshift
} }
} }
/** /**
* Scans for and, if found, runs one task, else possibly * Scans for and tries to steal a top-level task. Scans start at a
* inactivates the worker. This method operates on single reads of * random location, randomly moving on apparent contention,
* volatile state and is designed to be re-invoked continuously, * otherwise continuing linearly until reaching two consecutive
* in part because it returns upon detecting inconsistencies, * empty passes over all queues with the same checksum (summing
* contention, or state changes that indicate possible success on * each base index of each queue, that moves on each steal), at
* re-invocation. * which point the worker tries to inactivate and then re-scans,
* * attempting to re-activate (itself or some other worker) if
* The scan searches for tasks across queues starting at a random * finding a task; otherwise returning null to await work. Scans
* index, checking each at least twice. The scan terminates upon * otherwise touch as little memory as possible, to reduce
* either finding a non-empty queue, or completing the sweep. If * disruption on other scanning threads.
* the worker is not inactivated, it takes and runs a task from
* this queue. Otherwise, if not activated, it tries to activate
* itself or some other worker by signalling. On failure to find a
* task, returns (for retry) if pool state may have changed during
* an empty scan, or tries to inactivate if active, else possibly
* blocks or terminates via method awaitWork.
* *
* @param w the worker (via its WorkQueue) * @param w the worker (via its WorkQueue)
* @param r a random seed * @param r a random seed
* @return worker qlock status if would have waited, else 0 * @return a task, or null if none found
*/ */
private final int scan(WorkQueue w, int r) { private ForkJoinTask<?> scan(WorkQueue w, int r) {
WorkQueue[] ws; int m; WorkQueue[] ws; int m;
long c = ctl; // for consistency check if ((ws = workQueues) != null && (m = ws.length - 1) > 0 && w != null) {
if ((ws = workQueues) != null && (m = ws.length - 1) >= 0 && w != null) { int ss = w.scanState; // initially non-negative
for (int j = m + m + 1, ec = w.eventCount;;) { for (int origin = r & m, k = origin, oldSum = 0, checkSum = 0;;) {
WorkQueue q; int b, e; ForkJoinTask<?>[] a; ForkJoinTask<?> t; WorkQueue q; ForkJoinTask<?>[] a; ForkJoinTask<?> t;
if ((q = ws[(r - j) & m]) != null && int b, n; long c;
(b = q.base) - q.top < 0 && (a = q.array) != null) { if ((q = ws[k]) != null) {
long i = (((a.length - 1) & b) << ASHIFT) + ABASE; if ((n = (b = q.base) - q.top) < 0 &&
if ((t = ((ForkJoinTask<?>) (a = q.array) != null) { // non-empty
U.getObjectVolatile(a, i))) != null) { long i = (((a.length - 1) & b) << ASHIFT) + ABASE;
if (ec < 0) if ((t = ((ForkJoinTask<?>)
helpRelease(c, ws, w, q, b); U.getObjectVolatile(a, i))) != null &&
else if (q.base == b && q.base == b) {
U.compareAndSwapObject(a, i, t, null)) { if (ss >= 0) {
U.putOrderedInt(q, QBASE, b + 1); if (U.compareAndSwapObject(a, i, t, null)) {
if ((b + 1) - q.top < 0) q.base = b + 1;
signalWork(ws, q); if (n < -1) // signal others
w.runTask(t); signalWork(ws, q);
return t;
}
}
else if (oldSum == 0 && // try to activate
w.scanState < 0)
tryRelease(c = ctl, ws[m & (int)c], AC_UNIT);
} }
if (ss < 0) // refresh
ss = w.scanState;
r ^= r << 1; r ^= r >>> 3; r ^= r << 10;
origin = k = r & m; // move and rescan
oldSum = checkSum = 0;
continue;
} }
break; checkSum += b;
} }
else if (--j < 0) { if ((k = (k + 1) & m) == origin) { // continue until stable
if ((ec | (e = (int)c)) < 0) // inactive or terminating if ((ss >= 0 || (ss == (ss = w.scanState))) &&
return awaitWork(w, c, ec); oldSum == (oldSum = checkSum)) {
else if (ctl == c) { // try to inactivate and enqueue if (ss < 0 || w.qlock < 0) // already inactive
long nc = (long)ec | ((c - AC_UNIT) & (AC_MASK|TC_MASK)); break;
w.nextWait = e; int ns = ss | INACTIVE; // try to inactivate
w.eventCount = ec | INT_SIGN; long nc = ((SP_MASK & ns) |
if (!U.compareAndSwapLong(this, CTL, c, nc)) (UC_MASK & ((c = ctl) - AC_UNIT)));
w.eventCount = ec; // back out w.stackPred = (int)c; // hold prev stack top
U.putInt(w, QSCANSTATE, ns);
if (U.compareAndSwapLong(this, CTL, c, nc))
ss = ns;
else
w.scanState = ss; // back out
} }
break; checkSum = 0;
} }
} }
} }
return 0; return null;
} }
/** /**
* A continuation of scan(), possibly blocking or terminating * Possibly blocks worker w waiting for a task to steal, or
* worker w. Returns without blocking if pool state has apparently * returns false if the worker should terminate. If inactivating
* changed since last invocation. Also, if inactivating w has * w has caused the pool to become quiescent, checks for pool
* caused the pool to become quiescent, checks for pool
* termination, and, so long as this is not the only worker, waits * termination, and, so long as this is not the only worker, waits
* for event for up to a given duration. On timeout, if ctl has * for up to a given duration. On timeout, if ctl has not
* not changed, terminates the worker, which will in turn wake up * changed, terminates the worker, which will in turn wake up
* another worker to possibly repeat this process. * another worker to possibly repeat this process.
* *
* @param w the calling worker * @param w the calling worker
* @param c the ctl value on entry to scan * @param r a random seed (for spins)
* @param ec the worker's eventCount on entry to scan * @return false if the worker should terminate
*/ */
private final int awaitWork(WorkQueue w, long c, int ec) { private boolean awaitWork(WorkQueue w, int r) {
int stat, ns; long parkTime, deadline; if (w == null || w.qlock < 0) // w is terminating
if ((stat = w.qlock) >= 0 && w.eventCount == ec && ctl == c && return false;
!Thread.interrupted()) { for (int pred = w.stackPred, spins = SPINS, ss;;) {
int e = (int)c; if ((ss = w.scanState) >= 0)
int u = (int)(c >>> 32); break;
int d = (u >> UAC_SHIFT) + parallelism; // active count else if (spins > 0) {
r ^= r << 6; r ^= r >>> 21; r ^= r << 7;
if (e < 0 || (d <= 0 && tryTerminate(false, false))) if (r >= 0 && --spins == 0) { // randomize spins
stat = w.qlock = -1; // pool is terminating WorkQueue v; WorkQueue[] ws; int s, j; AtomicLong sc;
else if ((ns = w.nsteals) != 0) { // collect steals and retry if (pred != 0 && (ws = workQueues) != null &&
w.nsteals = 0; (j = pred & SMASK) < ws.length &&
U.getAndAddLong(this, STEALCOUNT, (long)ns); (v = ws[j]) != null && // see if pred parking
(v.parker == null || v.scanState >= 0))
spins = SPINS; // continue spinning
}
} }
else { else if (w.qlock < 0) // recheck after spins
long pc = ((d > 0 || ec != (e | INT_SIGN)) ? 0L : return false;
((long)(w.nextWait & E_MASK)) | // ctl to restore else if (!Thread.interrupted()) {
((long)(u + UAC_UNIT)) << 32); long c, prevctl, parkTime, deadline;
if (pc != 0L) { // timed wait if last waiter int ac = (int)((c = ctl) >> AC_SHIFT) + (config & SMASK);
int dc = -(short)(c >>> TC_SHIFT); if ((ac <= 0 && tryTerminate(false, false)) ||
parkTime = (dc < 0 ? FAST_IDLE_TIMEOUT: (runState & STOP) != 0) // pool terminating
(dc + 1) * IDLE_TIMEOUT); return false;
if (ac <= 0 && ss == (int)c) { // is last waiter
prevctl = (UC_MASK & (c + AC_UNIT)) | (SP_MASK & pred);
int t = (short)(c >>> TC_SHIFT); // shrink excess spares
if (t > 2 && U.compareAndSwapLong(this, CTL, c, prevctl))
return false; // else use timed wait
parkTime = IDLE_TIMEOUT * ((t >= 0) ? 1 : 1 - t);
deadline = System.nanoTime() + parkTime - TIMEOUT_SLOP; deadline = System.nanoTime() + parkTime - TIMEOUT_SLOP;
} }
else else
parkTime = deadline = 0L; prevctl = parkTime = deadline = 0L;
if (w.eventCount == ec && ctl == c) { Thread wt = Thread.currentThread();
Thread wt = Thread.currentThread(); U.putObject(wt, PARKBLOCKER, this); // emulate LockSupport
U.putObject(wt, PARKBLOCKER, this); w.parker = wt;
w.parker = wt; // emulate LockSupport.park if (w.scanState < 0 && ctl == c) // recheck before park
if (w.eventCount == ec && ctl == c) U.park(false, parkTime);
U.park(false, parkTime); // must recheck before park U.putOrderedObject(w, QPARKER, null);
w.parker = null; U.putObject(wt, PARKBLOCKER, null);
U.putObject(wt, PARKBLOCKER, null); if (w.scanState >= 0)
if (parkTime != 0L && ctl == c && break;
deadline - System.nanoTime() <= 0L && if (parkTime != 0L && ctl == c &&
U.compareAndSwapLong(this, CTL, c, pc)) deadline - System.nanoTime() <= 0L &&
stat = w.qlock = -1; // shrink pool U.compareAndSwapLong(this, CTL, c, prevctl))
} return false; // shrink pool
} }
} }
return stat; return true;
} }
// Joining tasks
/** /**
* Possibly releases (signals) a worker. Called only from scan() * Tries to steal and run tasks within the target's computation.
* when a worker with apparently inactive status finds a non-empty * Uses a variant of the top-level algorithm, restricted to tasks
* queue. This requires revalidating all of the associated state * with the given task as ancestor: It prefers taking and running
* from caller. * eligible tasks popped from the worker's own queue (via
* popCC). Otherwise it scans others, randomly moving on
* contention or execution, deciding to give up based on a
* checksum (via return codes frob pollAndExecCC). The maxTasks
* argument supports external usages; internal calls use zero,
* allowing unbounded steps (external calls trap non-positive
* values).
*
* @param w caller
* @param maxTasks if non-zero, the maximum number of other tasks to run
* @return task status on exit
*/ */
private final void helpRelease(long c, WorkQueue[] ws, WorkQueue w, final int helpComplete(WorkQueue w, CountedCompleter<?> task,
WorkQueue q, int b) { int maxTasks) {
WorkQueue v; int e, i; Thread p; WorkQueue[] ws; int s = 0, m;
if (w != null && w.eventCount < 0 && (e = (int)c) > 0 && if ((ws = workQueues) != null && (m = ws.length - 1) >= 0 &&
ws != null && ws.length > (i = e & SMASK) && task != null && w != null) {
(v = ws[i]) != null && ctl == c) { int mode = w.config; // for popCC
long nc = (((long)(v.nextWait & E_MASK)) | int r = w.hint ^ w.top; // arbitrary seed for origin
((long)((int)(c >>> 32) + UAC_UNIT)) << 32); int origin = r & m; // first queue to scan
int ne = (e + E_SEQ) & E_MASK; int h = 1; // 1:ran, >1:contended, <0:hash
if (q != null && q.base == b && w.eventCount < 0 && for (int k = origin, oldSum = 0, checkSum = 0;;) {
v.eventCount == (e | INT_SIGN) && CountedCompleter<?> p; WorkQueue q;
U.compareAndSwapLong(this, CTL, c, nc)) { if ((s = task.status) < 0)
v.eventCount = ne; break;
if ((p = v.parker) != null) if (h == 1 && (p = w.popCC(task, mode)) != null) {
U.unpark(p); p.doExec(); // run local task
if (maxTasks != 0 && --maxTasks == 0)
break;
origin = k; // reset
oldSum = checkSum = 0;
}
else { // poll other queues
if ((q = ws[k]) == null)
h = 0;
else if ((h = q.pollAndExecCC(task)) < 0)
checkSum += h;
if (h > 0) {
if (h == 1 && maxTasks != 0 && --maxTasks == 0)
break;
r ^= r << 13; r ^= r >>> 17; r ^= r << 5; // xorshift
origin = k = r & m; // move and restart
oldSum = checkSum = 0;
}
else if ((k = (k + 1) & m) == origin) {
if (oldSum == (oldSum = checkSum))
break;
checkSum = 0;
}
}
} }
} }
return s;
} }
/** /**
...@@ -1799,268 +1901,167 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -1799,268 +1901,167 @@ public class ForkJoinPool extends AbstractExecutorService {
* execute tasks from. The first call to this method upon a * execute tasks from. The first call to this method upon a
* waiting join will often entail scanning/search, (which is OK * waiting join will often entail scanning/search, (which is OK
* because the joiner has nothing better to do), but this method * because the joiner has nothing better to do), but this method
* leaves hints in workers to speed up subsequent calls. The * leaves hints in workers to speed up subsequent calls.
* implementation is very branchy to cope with potential
* inconsistencies or loops encountering chains that are stale,
* unknown, or so long that they are likely cyclic.
* *
* @param joiner the joining worker * @param w caller
* @param task the task to join * @param task the task to join
* @return 0 if no progress can be made, negative if task */
* known complete, else positive private void helpStealer(WorkQueue w, ForkJoinTask<?> task) {
*/ WorkQueue[] ws = workQueues;
private int tryHelpStealer(WorkQueue joiner, ForkJoinTask<?> task) { int oldSum = 0, checkSum, m;
int stat = 0, steps = 0; // bound to avoid cycles if (ws != null && (m = ws.length - 1) >= 0 && w != null &&
if (task != null && joiner != null && task != null) {
joiner.base - joiner.top >= 0) { // hoist checks do { // restart point
restart: for (;;) { checkSum = 0; // for stability check
ForkJoinTask<?> subtask = task; // current target ForkJoinTask<?> subtask;
for (WorkQueue j = joiner, v;;) { // v is stealer of subtask WorkQueue j = w, v; // v is subtask stealer
WorkQueue[] ws; int m, s, h; descent: for (subtask = task; subtask.status >= 0; ) {
if ((s = task.status) < 0) { for (int h = j.hint | 1, k = 0, i; ; k += 2) {
stat = s; if (k > m) // can't find stealer
break restart; break descent;
} if ((v = ws[i = (h + k) & m]) != null) {
if ((ws = workQueues) == null || (m = ws.length - 1) <= 0) if (v.currentSteal == subtask) {
break restart; // shutting down j.hint = i;
if ((v = ws[h = (j.hint | 1) & m]) == null ||
v.currentSteal != subtask) {
for (int origin = h;;) { // find stealer
if (((h = (h + 2) & m) & 15) == 1 &&
(subtask.status < 0 || j.currentJoin != subtask))
continue restart; // occasional staleness check
if ((v = ws[h]) != null &&
v.currentSteal == subtask) {
j.hint = h; // save hint
break; break;
} }
if (h == origin) checkSum += v.base;
break restart; // cannot find stealer
} }
} }
for (;;) { // help stealer or descend to its stealer for (;;) { // help v or descend
ForkJoinTask<?>[] a; int b; ForkJoinTask<?>[] a; int b;
if (subtask.status < 0) // surround probes with checkSum += (b = v.base);
continue restart; // consistency checks ForkJoinTask<?> next = v.currentJoin;
if ((b = v.base) - v.top < 0 && (a = v.array) != null) { if (subtask.status < 0 || j.currentJoin != subtask ||
int i = (((a.length - 1) & b) << ASHIFT) + ABASE; v.currentSteal != subtask) // stale
ForkJoinTask<?> t = break descent;
(ForkJoinTask<?>)U.getObjectVolatile(a, i); if (b - v.top >= 0 || (a = v.array) == null) {
if (subtask.status < 0 || j.currentJoin != subtask || if ((subtask = next) == null)
v.currentSteal != subtask) break descent;
continue restart; // stale j = v;
stat = 1; // apparent progress break;
if (v.base == b) {
if (t == null)
break restart;
if (U.compareAndSwapObject(a, i, t, null)) {
U.putOrderedInt(v, QBASE, b + 1);
ForkJoinTask<?> ps = joiner.currentSteal;
int jt = joiner.top;
do {
joiner.currentSteal = t;
t.doExec(); // clear local tasks too
} while (task.status >= 0 &&
joiner.top != jt &&
(t = joiner.pop()) != null);
joiner.currentSteal = ps;
break restart;
}
}
} }
else { // empty -- try to descend int i = (((a.length - 1) & b) << ASHIFT) + ABASE;
ForkJoinTask<?> next = v.currentJoin; ForkJoinTask<?> t = ((ForkJoinTask<?>)
if (subtask.status < 0 || j.currentJoin != subtask || U.getObjectVolatile(a, i));
v.currentSteal != subtask) if (v.base == b) {
continue restart; // stale if (t == null) // stale
else if (next == null || ++steps == MAX_HELP) break descent;
break restart; // dead-end or maybe cyclic if (U.compareAndSwapObject(a, i, t, null)) {
else { v.base = b + 1;
subtask = next; ForkJoinTask<?> ps = w.currentSteal;
j = v; int top = w.top;
break; do {
U.putOrderedObject(w, QCURRENTSTEAL, t);
t.doExec(); // clear local tasks too
} while (task.status >= 0 &&
w.top != top &&
(t = w.pop()) != null);
U.putOrderedObject(w, QCURRENTSTEAL, ps);
if (w.base != w.top)
return; // can't further help
} }
} }
} }
} }
} } while (task.status >= 0 && oldSum != (oldSum = checkSum));
} }
return stat;
}
/**
* Analog of tryHelpStealer for CountedCompleters. Tries to steal
* and run tasks within the target's computation.
*
* @param task the task to join
* @param maxTasks the maximum number of other tasks to run
*/
final int helpComplete(WorkQueue joiner, CountedCompleter<?> task,
int maxTasks) {
WorkQueue[] ws; int m;
int s = 0;
if ((ws = workQueues) != null && (m = ws.length - 1) >= 0 &&
joiner != null && task != null) {
int j = joiner.poolIndex;
int scans = m + m + 1;
long c = 0L; // for stability check
for (int k = scans; ; j += 2) {
WorkQueue q;
if ((s = task.status) < 0)
break;
else if (joiner.internalPopAndExecCC(task)) {
if (--maxTasks <= 0) {
s = task.status;
break;
}
k = scans;
}
else if ((s = task.status) < 0)
break;
else if ((q = ws[j & m]) != null && q.pollAndExecCC(task)) {
if (--maxTasks <= 0) {
s = task.status;
break;
}
k = scans;
}
else if (--k < 0) {
if (c == (c = ctl))
break;
k = scans;
}
}
}
return s;
} }
/** /**
* Tries to decrement active count (sometimes implicitly) and * Tries to decrement active count (sometimes implicitly) and
* possibly release or create a compensating worker in preparation * possibly release or create a compensating worker in preparation
* for blocking. Fails on contention or termination. Otherwise, * for blocking. Returns false (retryable by caller), on
* adds a new thread if no idle workers are available and pool * contention, detected staleness, instability, or termination.
* may become starved. *
* * @param w caller
* @param c the assumed ctl value */
*/ private boolean tryCompensate(WorkQueue w) {
final boolean tryCompensate(long c) { boolean canBlock;
WorkQueue[] ws = workQueues; WorkQueue[] ws; long c; int m, pc, sp;
int pc = parallelism, e = (int)c, m, tc; if (w == null || w.qlock < 0 || // caller terminating
if (ws != null && (m = ws.length - 1) >= 0 && e >= 0 && ctl == c) { (ws = workQueues) == null || (m = ws.length - 1) <= 0 ||
WorkQueue w = ws[e & m]; (pc = config & SMASK) == 0) // parallelism disabled
if (e != 0 && w != null) { canBlock = false;
Thread p; else if ((sp = (int)(c = ctl)) != 0) // release idle worker
long nc = ((long)(w.nextWait & E_MASK) | canBlock = tryRelease(c, ws[sp & m], 0L);
(c & (AC_MASK|TC_MASK))); else {
int ne = (e + E_SEQ) & E_MASK; int ac = (int)(c >> AC_SHIFT) + pc;
if (w.eventCount == (e | INT_SIGN) && int tc = (short)(c >> TC_SHIFT) + pc;
U.compareAndSwapLong(this, CTL, c, nc)) { int nbusy = 0; // validate saturation
w.eventCount = ne; for (int i = 0; i <= m; ++i) { // two passes of odd indices
if ((p = w.parker) != null) WorkQueue v;
U.unpark(p); if ((v = ws[((i << 1) | 1) & m]) != null) {
return true; // replace with idle worker if ((v.scanState & SCANNING) != 0)
break;
++nbusy;
} }
} }
else if ((tc = (short)(c >>> TC_SHIFT)) >= 0 && if (nbusy != (tc << 1) || ctl != c)
(int)(c >> AC_SHIFT) + pc > 1) { canBlock = false; // unstable or stale
long nc = ((c - AC_UNIT) & AC_MASK) | (c & ~AC_MASK); else if (tc >= pc && ac > 1 && w.isEmpty()) {
if (U.compareAndSwapLong(this, CTL, c, nc)) long nc = ((AC_MASK & (c - AC_UNIT)) |
return true; // no compensation (~AC_MASK & c)); // uncompensated
canBlock = U.compareAndSwapLong(this, CTL, c, nc);
} }
else if (tc + pc < MAX_CAP) { else if (tc >= MAX_CAP ||
long nc = ((c + TC_UNIT) & TC_MASK) | (c & ~TC_MASK); (this == common && tc >= pc + commonMaxSpares))
if (U.compareAndSwapLong(this, CTL, c, nc)) { throw new RejectedExecutionException(
ForkJoinWorkerThreadFactory fac; "Thread limit exceeded replacing blocked worker");
Throwable ex = null; else { // similar to tryAddWorker
ForkJoinWorkerThread wt = null; boolean add = false; int rs; // CAS within lock
try { long nc = ((AC_MASK & c) |
if ((fac = factory) != null && (TC_MASK & (c + TC_UNIT)));
(wt = fac.newThread(this)) != null) { if (((rs = lockRunState()) & STOP) == 0)
wt.start(); add = U.compareAndSwapLong(this, CTL, c, nc);
return true; unlockRunState(rs, rs & ~RSLOCK);
} canBlock = add && createWorker(); // throws on exception
} catch (Throwable rex) {
ex = rex;
}
deregisterWorker(wt, ex); // clean up and return false
}
} }
} }
return false; return canBlock;
} }
/** /**
* Helps and/or blocks until the given task is done. * Helps and/or blocks until the given task is done or timeout.
* *
* @param joiner the joining worker * @param w caller
* @param task the task * @param task the task
* @param deadline for timed waits, if nonzero
* @return task status on exit * @return task status on exit
*/ */
final int awaitJoin(WorkQueue joiner, ForkJoinTask<?> task) { final int awaitJoin(WorkQueue w, ForkJoinTask<?> task, long deadline) {
int s = 0; int s = 0;
if (task != null && (s = task.status) >= 0 && joiner != null) { if (task != null && w != null) {
ForkJoinTask<?> prevJoin = joiner.currentJoin; ForkJoinTask<?> prevJoin = w.currentJoin;
joiner.currentJoin = task; U.putOrderedObject(w, QCURRENTJOIN, task);
do {} while (joiner.tryRemoveAndExec(task) && // process local tasks CountedCompleter<?> cc = (task instanceof CountedCompleter) ?
(s = task.status) >= 0); (CountedCompleter<?>)task : null;
if (s >= 0 && (task instanceof CountedCompleter)) for (;;) {
s = helpComplete(joiner, (CountedCompleter<?>)task, Integer.MAX_VALUE); if ((s = task.status) < 0)
long cc = 0; // for stability checks break;
while (s >= 0 && (s = task.status) >= 0) { if (cc != null)
if ((s = tryHelpStealer(joiner, task)) == 0 && helpComplete(w, cc, 0);
(s = task.status) >= 0) { else if (w.base == w.top || w.tryRemoveAndExec(task))
if (!tryCompensate(cc)) helpStealer(w, task);
cc = ctl; if ((s = task.status) < 0)
else { break;
if (task.trySetSignal() && (s = task.status) >= 0) { long ms, ns;
synchronized (task) { if (deadline == 0L)
if (task.status >= 0) { ms = 0L;
try { // see ForkJoinTask else if ((ns = deadline - System.nanoTime()) <= 0L)
task.wait(); // for explanation break;
} catch (InterruptedException ie) { else if ((ms = TimeUnit.NANOSECONDS.toMillis(ns)) <= 0L)
} ms = 1L;
} if (tryCompensate(w)) {
else task.internalWait(ms);
task.notifyAll(); U.getAndAddLong(this, CTL, AC_UNIT);
}
}
long c; // reactivate
do {} while (!U.compareAndSwapLong
(this, CTL, c = ctl,
((c & ~AC_MASK) |
((c & AC_MASK) + AC_UNIT))));
}
} }
} }
joiner.currentJoin = prevJoin; U.putOrderedObject(w, QCURRENTJOIN, prevJoin);
} }
return s; return s;
} }
/** // Specialized scanning
* Stripped-down variant of awaitJoin used by timed joins. Tries
* to help join only while there is continuous progress. (Caller
* will then enter a timed wait.)
*
* @param joiner the joining worker
* @param task the task
*/
final void helpJoinOnce(WorkQueue joiner, ForkJoinTask<?> task) {
int s;
if (joiner != null && task != null && (s = task.status) >= 0) {
ForkJoinTask<?> prevJoin = joiner.currentJoin;
joiner.currentJoin = task;
do {} while (joiner.tryRemoveAndExec(task) && // process local tasks
(s = task.status) >= 0);
if (s >= 0) {
if (task instanceof CountedCompleter)
helpComplete(joiner, (CountedCompleter<?>)task, Integer.MAX_VALUE);
do {} while (task.status >= 0 &&
tryHelpStealer(joiner, task) > 0);
}
joiner.currentJoin = prevJoin;
}
}
/** /**
* Returns a (probably) non-empty steal queue, if one is found * Returns a (probably) non-empty steal queue, if one is found
...@@ -2068,19 +2069,24 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2068,19 +2069,24 @@ public class ForkJoinPool extends AbstractExecutorService {
* caller if, by the time it tries to use the queue, it is empty. * caller if, by the time it tries to use the queue, it is empty.
*/ */
private WorkQueue findNonEmptyStealQueue() { private WorkQueue findNonEmptyStealQueue() {
WorkQueue[] ws; int m; // one-shot version of scan loop
int r = ThreadLocalRandom.nextSecondarySeed(); int r = ThreadLocalRandom.nextSecondarySeed();
for (;;) { if ((ws = workQueues) != null && (m = ws.length - 1) >= 0) {
int ps = plock, m; WorkQueue[] ws; WorkQueue q; for (int origin = r & m, k = origin, oldSum = 0, checkSum = 0;;) {
if ((ws = workQueues) != null && (m = ws.length - 1) >= 0) { WorkQueue q; int b;
for (int j = (m + 1) << 2; j >= 0; --j) { if ((q = ws[k]) != null) {
if ((q = ws[(((r - j) << 1) | 1) & m]) != null && if ((b = q.base) - q.top < 0)
q.base - q.top < 0)
return q; return q;
checkSum += b;
}
if ((k = (k + 1) & m) == origin) {
if (oldSum == (oldSum = checkSum))
break;
checkSum = 0;
} }
} }
if (plock == ps)
return null;
} }
return null;
} }
/** /**
...@@ -2090,35 +2096,34 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2090,35 +2096,34 @@ public class ForkJoinPool extends AbstractExecutorService {
* find tasks either. * find tasks either.
*/ */
final void helpQuiescePool(WorkQueue w) { final void helpQuiescePool(WorkQueue w) {
ForkJoinTask<?> ps = w.currentSteal; ForkJoinTask<?> ps = w.currentSteal; // save context
for (boolean active = true;;) { for (boolean active = true;;) {
long c; WorkQueue q; ForkJoinTask<?> t; int b; long c; WorkQueue q; ForkJoinTask<?> t; int b;
while ((t = w.nextLocalTask()) != null) w.execLocalTasks(); // run locals before each scan
t.doExec();
if ((q = findNonEmptyStealQueue()) != null) { if ((q = findNonEmptyStealQueue()) != null) {
if (!active) { // re-establish active count if (!active) { // re-establish active count
active = true; active = true;
do {} while (!U.compareAndSwapLong U.getAndAddLong(this, CTL, AC_UNIT);
(this, CTL, c = ctl, }
((c & ~AC_MASK) | if ((b = q.base) - q.top < 0 && (t = q.pollAt(b)) != null) {
((c & AC_MASK) + AC_UNIT)))); U.putOrderedObject(w, QCURRENTSTEAL, t);
t.doExec();
if (++w.nsteals < 0)
w.transferStealCount(this);
} }
if ((b = q.base) - q.top < 0 && (t = q.pollAt(b)) != null)
w.runTask(t);
} }
else if (active) { // decrement active count without queuing else if (active) { // decrement active count without queuing
long nc = ((c = ctl) & ~AC_MASK) | ((c & AC_MASK) - AC_UNIT); long nc = (AC_MASK & ((c = ctl) - AC_UNIT)) | (~AC_MASK & c);
if ((int)(nc >> AC_SHIFT) + parallelism == 0) if ((int)(nc >> AC_SHIFT) + (config & SMASK) <= 0)
break; // bypass decrement-then-increment break; // bypass decrement-then-increment
if (U.compareAndSwapLong(this, CTL, c, nc)) if (U.compareAndSwapLong(this, CTL, c, nc))
active = false; active = false;
} }
else if ((int)((c = ctl) >> AC_SHIFT) + parallelism <= 0 && else if ((int)((c = ctl) >> AC_SHIFT) + (config & SMASK) <= 0 &&
U.compareAndSwapLong U.compareAndSwapLong(this, CTL, c, c + AC_UNIT))
(this, CTL, c, ((c & ~AC_MASK) |
((c & AC_MASK) + AC_UNIT))))
break; break;
} }
U.putOrderedObject(w, QCURRENTSTEAL, ps);
} }
/** /**
...@@ -2141,7 +2146,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2141,7 +2146,7 @@ public class ForkJoinPool extends AbstractExecutorService {
/** /**
* Returns a cheap heuristic guide for task partitioning when * Returns a cheap heuristic guide for task partitioning when
* programmers, frameworks, tools, or languages have little or no * programmers, frameworks, tools, or languages have little or no
* idea about task granularity. In essence by offering this * idea about task granularity. In essence, by offering this
* method, we ask users only about tradeoffs in overhead vs * method, we ask users only about tradeoffs in overhead vs
* expected throughput and its variance, rather than how finely to * expected throughput and its variance, rather than how finely to
* partition tasks. * partition tasks.
...@@ -2179,15 +2184,12 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2179,15 +2184,12 @@ public class ForkJoinPool extends AbstractExecutorService {
* many of these by further considering the number of "idle" * many of these by further considering the number of "idle"
* threads, that are known to have zero queued tasks, so * threads, that are known to have zero queued tasks, so
* compensate by a factor of (#idle/#active) threads. * compensate by a factor of (#idle/#active) threads.
*
* Note: The approximation of #busy workers as #active workers is
* not very good under current signalling scheme, and should be
* improved.
*/ */
static int getSurplusQueuedTaskCount() { static int getSurplusQueuedTaskCount() {
Thread t; ForkJoinWorkerThread wt; ForkJoinPool pool; WorkQueue q; Thread t; ForkJoinWorkerThread wt; ForkJoinPool pool; WorkQueue q;
if (((t = Thread.currentThread()) instanceof ForkJoinWorkerThread)) { if (((t = Thread.currentThread()) instanceof ForkJoinWorkerThread)) {
int p = (pool = (wt = (ForkJoinWorkerThread)t).pool).parallelism; int p = (pool = (wt = (ForkJoinWorkerThread)t).pool).
config & SMASK;
int n = (q = wt.workQueue).top - q.base; int n = (q = wt.workQueue).top - q.base;
int a = (int)(pool.ctl >> AC_SHIFT) + p; int a = (int)(pool.ctl >> AC_SHIFT) + p;
return n - (a > (p >>>= 1) ? 0 : return n - (a > (p >>>= 1) ? 0 :
...@@ -2202,13 +2204,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2202,13 +2204,7 @@ public class ForkJoinPool extends AbstractExecutorService {
// Termination // Termination
/** /**
* Possibly initiates and/or completes termination. The caller * Possibly initiates and/or completes termination.
* triggering termination runs three passes through workQueues:
* (0) Setting termination status, followed by wakeups of queued
* workers; (1) cancelling all tasks; (2) interrupting lagging
* threads (likely in external tasks, but possibly also blocked in
* joins). Each pass repeats previous steps because of potential
* lagging thread creation.
* *
* @param now if true, unconditionally terminate, else only * @param now if true, unconditionally terminate, else only
* if no work and no active workers * if no work and no active workers
...@@ -2216,166 +2212,256 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2216,166 +2212,256 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return true if now terminating or terminated * @return true if now terminating or terminated
*/ */
private boolean tryTerminate(boolean now, boolean enable) { private boolean tryTerminate(boolean now, boolean enable) {
int ps; int rs;
if (this == common) // cannot shut down if (this == common) // cannot shut down
return false; return false;
if ((ps = plock) >= 0) { // enable by setting plock if ((rs = runState) >= 0) {
if (!enable) if (!enable)
return false; return false;
if ((ps & PL_LOCK) != 0 || rs = lockRunState(); // enter SHUTDOWN phase
!U.compareAndSwapInt(this, PLOCK, ps, ps += PL_LOCK)) unlockRunState(rs, (rs & ~RSLOCK) | SHUTDOWN);
ps = acquirePlock(); }
int nps = ((ps + PL_LOCK) & ~SHUTDOWN) | SHUTDOWN;
if (!U.compareAndSwapInt(this, PLOCK, ps, nps)) if ((rs & STOP) == 0) {
releasePlock(nps); if (!now) { // check quiescence
} for (long oldSum = 0L;;) { // repeat until stable
for (long c;;) { WorkQueue[] ws; WorkQueue w; int m, b; long c;
if (((c = ctl) & STOP_BIT) != 0) { // already terminating long checkSum = ctl;
if ((short)(c >>> TC_SHIFT) + parallelism <= 0) { if ((int)(checkSum >> AC_SHIFT) + (config & SMASK) > 0)
synchronized (this) { return false; // still active workers
notifyAll(); // signal when 0 workers if ((ws = workQueues) == null || (m = ws.length - 1) <= 0)
break; // check queues
for (int i = 0; i <= m; ++i) {
if ((w = ws[i]) != null) {
if ((b = w.base) != w.top || w.scanState >= 0 ||
w.currentSteal != null) {
tryRelease(c = ctl, ws[m & (int)c], AC_UNIT);
return false; // arrange for recheck
}
checkSum += b;
if ((i & 1) == 0)
w.qlock = -1; // try to disable external
}
} }
if (oldSum == (oldSum = checkSum))
break;
} }
return true;
} }
if (!now) { // check if idle & no tasks if ((runState & STOP) == 0) {
WorkQueue[] ws; WorkQueue w; rs = lockRunState(); // enter STOP phase
if ((int)(c >> AC_SHIFT) + parallelism > 0) unlockRunState(rs, (rs & ~RSLOCK) | STOP);
return false; }
if ((ws = workQueues) != null) { }
for (int i = 0; i < ws.length; ++i) {
if ((w = ws[i]) != null && int pass = 0; // 3 passes to help terminate
(!w.isEmpty() || for (long oldSum = 0L;;) { // or until done or stable
((i & 1) != 0 && w.eventCount >= 0))) { WorkQueue[] ws; WorkQueue w; ForkJoinWorkerThread wt; int m;
signalWork(ws, w); long checkSum = ctl;
return false; if ((short)(checkSum >>> TC_SHIFT) + (config & SMASK) <= 0 ||
} (ws = workQueues) == null || (m = ws.length - 1) <= 0) {
} if ((runState & TERMINATED) == 0) {
rs = lockRunState(); // done
unlockRunState(rs, (rs & ~RSLOCK) | TERMINATED);
synchronized (this) { notifyAll(); } // for awaitTermination
} }
break;
} }
if (U.compareAndSwapLong(this, CTL, c, c | STOP_BIT)) { for (int i = 0; i <= m; ++i) {
for (int pass = 0; pass < 3; ++pass) { if ((w = ws[i]) != null) {
WorkQueue[] ws; WorkQueue w; Thread wt; checkSum += w.base;
if ((ws = workQueues) != null) { w.qlock = -1; // try to disable
int n = ws.length; if (pass > 0) {
for (int i = 0; i < n; ++i) { w.cancelAll(); // clear queue
if ((w = ws[i]) != null) { if (pass > 1 && (wt = w.owner) != null) {
w.qlock = -1; if (!wt.isInterrupted()) {
if (pass > 0) { try { // unblock join
w.cancelAll(); wt.interrupt();
if (pass > 1 && (wt = w.owner) != null) { } catch (Throwable ignore) {
if (!wt.isInterrupted()) {
try {
wt.interrupt();
} catch (Throwable ignore) {
}
}
U.unpark(wt);
}
} }
} }
if (w.scanState < 0)
U.unpark(wt); // wake up
} }
// Wake up workers parked on event queue }
int i, e; long cc; Thread p; }
while ((e = (int)(cc = ctl) & E_MASK) != 0 && }
(i = e & SMASK) < n && i >= 0 && if (checkSum != oldSum) { // unstable
(w = ws[i]) != null) { oldSum = checkSum;
long nc = ((long)(w.nextWait & E_MASK) | pass = 0;
((cc + AC_UNIT) & AC_MASK) | }
(cc & (TC_MASK|STOP_BIT))); else if (pass > 3 && pass > m) // can't further help
if (w.eventCount == (e | INT_SIGN) && break;
U.compareAndSwapLong(this, CTL, cc, nc)) { else if (++pass > 1) { // try to dequeue
w.eventCount = (e + E_SEQ) & E_MASK; long c; int j = 0, sp; // bound attempts
w.qlock = -1; while (j++ <= m && (sp = (int)(c = ctl)) != 0)
if ((p = w.parker) != null) tryRelease(c, ws[sp & m], AC_UNIT);
U.unpark(p); }
} }
return true;
}
// External operations
/**
* Full version of externalPush, handling uncommon cases, as well
* as performing secondary initialization upon the first
* submission of the first task to the pool. It also detects
* first submission by an external thread and creates a new shared
* queue if the one at index if empty or contended.
*
* @param task the task. Caller must ensure non-null.
*/
private void externalSubmit(ForkJoinTask<?> task) {
int r; // initialize caller's probe
if ((r = ThreadLocalRandom.getProbe()) == 0) {
ThreadLocalRandom.localInit();
r = ThreadLocalRandom.getProbe();
}
for (;;) {
WorkQueue[] ws; WorkQueue q; int rs, m, k;
boolean move = false;
if ((rs = runState) < 0) {
tryTerminate(false, false); // help terminate
throw new RejectedExecutionException();
}
else if ((rs & STARTED) == 0 || // initialize
((ws = workQueues) == null || (m = ws.length - 1) < 0)) {
int ns = 0;
rs = lockRunState();
try {
if ((rs & STARTED) == 0) {
U.compareAndSwapObject(this, STEALCOUNTER, null,
new AtomicLong());
// create workQueues array with size a power of two
int p = config & SMASK; // ensure at least 2 slots
int n = (p > 1) ? p - 1 : 1;
n |= n >>> 1; n |= n >>> 2; n |= n >>> 4;
n |= n >>> 8; n |= n >>> 16; n = (n + 1) << 1;
workQueues = new WorkQueue[n];
ns = STARTED;
}
} finally {
unlockRunState(rs, (rs & ~RSLOCK) | ns);
}
}
else if ((q = ws[k = r & m & SQMASK]) != null) {
if (q.qlock == 0 && U.compareAndSwapInt(q, QLOCK, 0, 1)) {
ForkJoinTask<?>[] a = q.array;
int s = q.top;
boolean submitted = false; // initial submission or resizing
try { // locked version of push
if ((a != null && a.length > s + 1 - q.base) ||
(a = q.growArray()) != null) {
int j = (((a.length - 1) & s) << ASHIFT) + ABASE;
U.putOrderedObject(a, j, task);
U.putOrderedInt(q, QTOP, s + 1);
submitted = true;
} }
} finally {
U.compareAndSwapInt(q, QLOCK, 1, 0);
}
if (submitted) {
signalWork(ws, q);
return;
} }
} }
move = true; // move on failure
}
else if (((rs = runState) & RSLOCK) == 0) { // create new queue
q = new WorkQueue(this, null);
q.hint = r;
q.config = k | SHARED_QUEUE;
q.scanState = INACTIVE;
rs = lockRunState(); // publish index
if (rs > 0 && (ws = workQueues) != null &&
k < ws.length && ws[k] == null)
ws[k] = q; // else terminated
unlockRunState(rs, rs & ~RSLOCK);
} }
else
move = true; // move if busy
if (move)
r = ThreadLocalRandom.advanceProbe(r);
} }
} }
// external operations on common pool /**
* Tries to add the given task to a submission queue at
* submitter's current queue. Only the (vastly) most common path
* is directly handled in this method, while screening for need
* for externalSubmit.
*
* @param task the task. Caller must ensure non-null.
*/
final void externalPush(ForkJoinTask<?> task) {
WorkQueue[] ws; WorkQueue q; int m;
int r = ThreadLocalRandom.getProbe();
int rs = runState;
if ((ws = workQueues) != null && (m = (ws.length - 1)) >= 0 &&
(q = ws[m & r & SQMASK]) != null && r != 0 && rs > 0 &&
U.compareAndSwapInt(q, QLOCK, 0, 1)) {
ForkJoinTask<?>[] a; int am, n, s;
if ((a = q.array) != null &&
(am = a.length - 1) > (n = (s = q.top) - q.base)) {
int j = ((am & s) << ASHIFT) + ABASE;
U.putOrderedObject(a, j, task);
U.putOrderedInt(q, QTOP, s + 1);
U.putOrderedInt(q, QLOCK, 0);
if (n <= 1)
signalWork(ws, q);
return;
}
U.compareAndSwapInt(q, QLOCK, 1, 0);
}
externalSubmit(task);
}
/** /**
* Returns common pool queue for a thread that has submitted at * Returns common pool queue for an external thread.
* least one task.
*/ */
static WorkQueue commonSubmitterQueue() { static WorkQueue commonSubmitterQueue() {
ForkJoinPool p; WorkQueue[] ws; int m, z; ForkJoinPool p = common;
return ((z = ThreadLocalRandom.getProbe()) != 0 && int r = ThreadLocalRandom.getProbe();
(p = common) != null && WorkQueue[] ws; int m;
(ws = p.workQueues) != null && return (p != null && (ws = p.workQueues) != null &&
(m = ws.length - 1) >= 0) ? (m = ws.length - 1) >= 0) ?
ws[m & z & SQMASK] : null; ws[m & r & SQMASK] : null;
} }
/** /**
* Tries to pop the given task from submitter's queue in common pool. * Performs tryUnpush for an external submitter: Finds queue,
* locks if apparently non-empty, validates upon locking, and
* adjusts top. Each check can fail but rarely does.
*/ */
final boolean tryExternalUnpush(ForkJoinTask<?> task) { final boolean tryExternalUnpush(ForkJoinTask<?> task) {
WorkQueue joiner; ForkJoinTask<?>[] a; int m, s; WorkQueue[] ws; WorkQueue w; ForkJoinTask<?>[] a; int m, s;
WorkQueue[] ws = workQueues; int r = ThreadLocalRandom.getProbe();
int z = ThreadLocalRandom.getProbe(); if ((ws = workQueues) != null && (m = ws.length - 1) >= 0 &&
boolean popped = false; (w = ws[m & r & SQMASK]) != null &&
if (ws != null && (m = ws.length - 1) >= 0 && (a = w.array) != null && (s = w.top) != w.base) {
(joiner = ws[z & m & SQMASK]) != null &&
joiner.base != (s = joiner.top) &&
(a = joiner.array) != null) {
long j = (((a.length - 1) & (s - 1)) << ASHIFT) + ABASE; long j = (((a.length - 1) & (s - 1)) << ASHIFT) + ABASE;
if (U.getObject(a, j) == task && if (U.compareAndSwapInt(w, QLOCK, 0, 1)) {
U.compareAndSwapInt(joiner, QLOCK, 0, 1)) { if (w.top == s && w.array == a &&
if (joiner.top == s && joiner.array == a && U.getObject(a, j) == task &&
U.compareAndSwapObject(a, j, task, null)) { U.compareAndSwapObject(a, j, task, null)) {
joiner.top = s - 1; U.putOrderedInt(w, QTOP, s - 1);
popped = true; U.putOrderedInt(w, QLOCK, 0);
return true;
} }
joiner.qlock = 0; U.compareAndSwapInt(w, QLOCK, 1, 0);
} }
} }
return popped; return false;
} }
/**
* Performs helpComplete for an external submitter.
*/
final int externalHelpComplete(CountedCompleter<?> task, int maxTasks) { final int externalHelpComplete(CountedCompleter<?> task, int maxTasks) {
WorkQueue joiner; int m; WorkQueue[] ws; int n;
WorkQueue[] ws = workQueues; int r = ThreadLocalRandom.getProbe();
int j = ThreadLocalRandom.getProbe(); return ((ws = workQueues) == null || (n = ws.length) == 0) ? 0 :
int s = 0; helpComplete(ws[(n - 1) & r & SQMASK], task, maxTasks);
if (ws != null && (m = ws.length - 1) >= 0 &&
(joiner = ws[j & m & SQMASK]) != null && task != null) {
int scans = m + m + 1;
long c = 0L; // for stability check
j |= 1; // poll odd queues
for (int k = scans; ; j += 2) {
WorkQueue q;
if ((s = task.status) < 0)
break;
else if (joiner.externalPopAndExecCC(task)) {
if (--maxTasks <= 0) {
s = task.status;
break;
}
k = scans;
}
else if ((s = task.status) < 0)
break;
else if ((q = ws[j & m]) != null && q.pollAndExecCC(task)) {
if (--maxTasks <= 0) {
s = task.status;
break;
}
k = scans;
}
else if (--k < 0) {
if (c == (c = ctl))
break;
k = scans;
}
}
}
return s;
} }
// Exported methods // Exported methods
...@@ -2447,7 +2533,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2447,7 +2533,7 @@ public class ForkJoinPool extends AbstractExecutorService {
this(checkParallelism(parallelism), this(checkParallelism(parallelism),
checkFactory(factory), checkFactory(factory),
handler, handler,
(asyncMode ? FIFO_QUEUE : LIFO_QUEUE), asyncMode ? FIFO_QUEUE : LIFO_QUEUE,
"ForkJoinPool-" + nextPoolId() + "-worker-"); "ForkJoinPool-" + nextPoolId() + "-worker-");
checkPermission(); checkPermission();
} }
...@@ -2478,8 +2564,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2478,8 +2564,7 @@ public class ForkJoinPool extends AbstractExecutorService {
this.workerNamePrefix = workerNamePrefix; this.workerNamePrefix = workerNamePrefix;
this.factory = factory; this.factory = factory;
this.ueh = handler; this.ueh = handler;
this.mode = (short)mode; this.config = (parallelism & SMASK) | mode;
this.parallelism = (short)parallelism;
long np = (long)(-parallelism); // offset ctl counts long np = (long)(-parallelism); // offset ctl counts
this.ctl = ((np << AC_SHIFT) & AC_MASK) | ((np << TC_SHIFT) & TC_MASK); this.ctl = ((np << AC_SHIFT) & AC_MASK) | ((np << TC_SHIFT) & TC_MASK);
} }
...@@ -2624,7 +2709,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2624,7 +2709,7 @@ public class ForkJoinPool extends AbstractExecutorService {
// In previous versions of this class, this method constructed // In previous versions of this class, this method constructed
// a task to run ForkJoinTask.invokeAll, but now external // a task to run ForkJoinTask.invokeAll, but now external
// invocation of multiple tasks is at least as efficient. // invocation of multiple tasks is at least as efficient.
ArrayList<Future<T>> futures = new ArrayList<Future<T>>(tasks.size()); ArrayList<Future<T>> futures = new ArrayList<>(tasks.size());
boolean done = false; boolean done = false;
try { try {
...@@ -2670,7 +2755,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2670,7 +2755,7 @@ public class ForkJoinPool extends AbstractExecutorService {
*/ */
public int getParallelism() { public int getParallelism() {
int par; int par;
return ((par = parallelism) > 0) ? par : 1; return ((par = config & SMASK) > 0) ? par : 1;
} }
/** /**
...@@ -2692,7 +2777,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2692,7 +2777,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return the number of worker threads * @return the number of worker threads
*/ */
public int getPoolSize() { public int getPoolSize() {
return parallelism + (short)(ctl >>> TC_SHIFT); return (config & SMASK) + (short)(ctl >>> TC_SHIFT);
} }
/** /**
...@@ -2702,7 +2787,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2702,7 +2787,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return {@code true} if this pool uses async mode * @return {@code true} if this pool uses async mode
*/ */
public boolean getAsyncMode() { public boolean getAsyncMode() {
return mode == FIFO_QUEUE; return (config & FIFO_QUEUE) != 0;
} }
/** /**
...@@ -2733,7 +2818,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2733,7 +2818,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return the number of active threads * @return the number of active threads
*/ */
public int getActiveThreadCount() { public int getActiveThreadCount() {
int r = parallelism + (int)(ctl >> AC_SHIFT); int r = (config & SMASK) + (int)(ctl >> AC_SHIFT);
return (r <= 0) ? 0 : r; // suppress momentarily negative values return (r <= 0) ? 0 : r; // suppress momentarily negative values
} }
...@@ -2749,7 +2834,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2749,7 +2834,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return {@code true} if all threads are currently idle * @return {@code true} if all threads are currently idle
*/ */
public boolean isQuiescent() { public boolean isQuiescent() {
return parallelism + (int)(ctl >> AC_SHIFT) <= 0; return (config & SMASK) + (int)(ctl >> AC_SHIFT) <= 0;
} }
/** /**
...@@ -2764,7 +2849,8 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2764,7 +2849,8 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return the number of steals * @return the number of steals
*/ */
public long getStealCount() { public long getStealCount() {
long count = stealCount; AtomicLong sc = stealCounter;
long count = (sc == null) ? 0L : sc.get();
WorkQueue[] ws; WorkQueue w; WorkQueue[] ws; WorkQueue w;
if ((ws = workQueues) != null) { if ((ws = workQueues) != null) {
for (int i = 1; i < ws.length; i += 2) { for (int i = 1; i < ws.length; i += 2) {
...@@ -2894,7 +2980,8 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2894,7 +2980,8 @@ public class ForkJoinPool extends AbstractExecutorService {
public String toString() { public String toString() {
// Use a single pass through workQueues to collect counts // Use a single pass through workQueues to collect counts
long qt = 0L, qs = 0L; int rc = 0; long qt = 0L, qs = 0L; int rc = 0;
long st = stealCount; AtomicLong sc = stealCounter;
long st = (sc == null) ? 0L : sc.get();
long c = ctl; long c = ctl;
WorkQueue[] ws; WorkQueue w; WorkQueue[] ws; WorkQueue w;
if ((ws = workQueues) != null) { if ((ws = workQueues) != null) {
...@@ -2912,16 +2999,16 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2912,16 +2999,16 @@ public class ForkJoinPool extends AbstractExecutorService {
} }
} }
} }
int pc = parallelism; int pc = (config & SMASK);
int tc = pc + (short)(c >>> TC_SHIFT); int tc = pc + (short)(c >>> TC_SHIFT);
int ac = pc + (int)(c >> AC_SHIFT); int ac = pc + (int)(c >> AC_SHIFT);
if (ac < 0) // ignore transient negative if (ac < 0) // ignore transient negative
ac = 0; ac = 0;
String level; int rs = runState;
if ((c & STOP_BIT) != 0) String level = ((rs & TERMINATED) != 0 ? "Terminated" :
level = (tc == 0) ? "Terminated" : "Terminating"; (rs & STOP) != 0 ? "Terminating" :
else (rs & SHUTDOWN) != 0 ? "Shutting down" :
level = plock < 0 ? "Shutting down" : "Running"; "Running");
return super.toString() + return super.toString() +
"[" + level + "[" + level +
", parallelism = " + pc + ", parallelism = " + pc +
...@@ -2983,9 +3070,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -2983,9 +3070,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return {@code true} if all tasks have completed following shut down * @return {@code true} if all tasks have completed following shut down
*/ */
public boolean isTerminated() { public boolean isTerminated() {
long c = ctl; return (runState & TERMINATED) != 0;
return ((c & STOP_BIT) != 0L &&
(short)(c >>> TC_SHIFT) + parallelism <= 0);
} }
/** /**
...@@ -3002,9 +3087,8 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3002,9 +3087,8 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return {@code true} if terminating but not yet terminated * @return {@code true} if terminating but not yet terminated
*/ */
public boolean isTerminating() { public boolean isTerminating() {
long c = ctl; int rs = runState;
return ((c & STOP_BIT) != 0L && return (rs & STOP) != 0 && (rs & TERMINATED) == 0;
(short)(c >>> TC_SHIFT) + parallelism > 0);
} }
/** /**
...@@ -3013,7 +3097,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3013,7 +3097,7 @@ public class ForkJoinPool extends AbstractExecutorService {
* @return {@code true} if this pool has been shut down * @return {@code true} if this pool has been shut down
*/ */
public boolean isShutdown() { public boolean isShutdown() {
return plock < 0; return (runState & SHUTDOWN) != 0;
} }
/** /**
...@@ -3090,8 +3174,9 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3090,8 +3174,9 @@ public class ForkJoinPool extends AbstractExecutorService {
} }
found = false; found = false;
for (int j = (m + 1) << 2; j >= 0; --j) { for (int j = (m + 1) << 2; j >= 0; --j) {
ForkJoinTask<?> t; WorkQueue q; int b; ForkJoinTask<?> t; WorkQueue q; int b, k;
if ((q = ws[r++ & m]) != null && (b = q.base) - q.top < 0) { if ((k = r++ & m) <= m && k >= 0 && (q = ws[k]) != null &&
(b = q.base) - q.top < 0) {
found = true; found = true;
if ((t = q.pollAt(b)) != null) if ((t = q.pollAt(b)) != null)
t.doExec(); t.doExec();
...@@ -3115,8 +3200,8 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3115,8 +3200,8 @@ public class ForkJoinPool extends AbstractExecutorService {
* in {@link ForkJoinPool}s. * in {@link ForkJoinPool}s.
* *
* <p>A {@code ManagedBlocker} provides two methods. Method * <p>A {@code ManagedBlocker} provides two methods. Method
* {@code isReleasable} must return {@code true} if blocking is * {@link #isReleasable} must return {@code true} if blocking is
* not necessary. Method {@code block} blocks the current thread * not necessary. Method {@link #block} blocks the current thread
* if necessary (perhaps internally invoking {@code isReleasable} * if necessary (perhaps internally invoking {@code isReleasable}
* before actually blocking). These actions are performed by any * before actually blocking). These actions are performed by any
* thread invoking {@link ForkJoinPool#managedBlock(ManagedBlocker)}. * thread invoking {@link ForkJoinPool#managedBlock(ManagedBlocker)}.
...@@ -3185,37 +3270,46 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3185,37 +3270,46 @@ public class ForkJoinPool extends AbstractExecutorService {
} }
/** /**
* Blocks in accord with the given blocker. If the current thread * Runs the given possibly blocking task. When {@linkplain
* is a {@link ForkJoinWorkerThread}, this method possibly * ForkJoinTask#inForkJoinPool() running in a ForkJoinPool}, this
* arranges for a spare thread to be activated if necessary to * method possibly arranges for a spare thread to be activated if
* ensure sufficient parallelism while the current thread is blocked. * necessary to ensure sufficient parallelism while the current
* thread is blocked in {@link ManagedBlocker#block blocker.block()}.
*
* <p>This method repeatedly calls {@code blocker.isReleasable()} and
* {@code blocker.block()} until either method returns {@code true}.
* Every call to {@code blocker.block()} is preceded by a call to
* {@code blocker.isReleasable()} that returned {@code false}.
* *
* <p>If the caller is not a {@link ForkJoinTask}, this method is * <p>If not running in a ForkJoinPool, this method is
* behaviorally equivalent to * behaviorally equivalent to
* <pre> {@code * <pre> {@code
* while (!blocker.isReleasable()) * while (!blocker.isReleasable())
* if (blocker.block()) * if (blocker.block())
* return; * break;}</pre>
* }</pre>
* *
* If the caller is a {@code ForkJoinTask}, then the pool may * If running in a ForkJoinPool, the pool may first be expanded to
* first be expanded to ensure parallelism, and later adjusted. * ensure sufficient parallelism available during the call to
* {@code blocker.block()}.
* *
* @param blocker the blocker * @param blocker the blocker task
* @throws InterruptedException if blocker.block did so * @throws InterruptedException if {@code blocker.block()} did so
*/ */
public static void managedBlock(ManagedBlocker blocker) public static void managedBlock(ManagedBlocker blocker)
throws InterruptedException { throws InterruptedException {
ForkJoinPool p;
ForkJoinWorkerThread wt;
Thread t = Thread.currentThread(); Thread t = Thread.currentThread();
if (t instanceof ForkJoinWorkerThread) { if ((t instanceof ForkJoinWorkerThread) &&
ForkJoinPool p = ((ForkJoinWorkerThread)t).pool; (p = (wt = (ForkJoinWorkerThread)t).pool) != null) {
WorkQueue w = wt.workQueue;
while (!blocker.isReleasable()) { while (!blocker.isReleasable()) {
if (p.tryCompensate(p.ctl)) { if (p.tryCompensate(w)) {
try { try {
do {} while (!blocker.isReleasable() && do {} while (!blocker.isReleasable() &&
!blocker.block()); !blocker.block());
} finally { } finally {
p.incrementActiveCount(); U.getAndAddLong(p, CTL, AC_UNIT);
} }
break; break;
} }
...@@ -3241,15 +3335,18 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3241,15 +3335,18 @@ public class ForkJoinPool extends AbstractExecutorService {
// Unsafe mechanics // Unsafe mechanics
private static final sun.misc.Unsafe U; private static final sun.misc.Unsafe U;
private static final int ABASE;
private static final int ASHIFT;
private static final long CTL; private static final long CTL;
private static final long RUNSTATE;
private static final long STEALCOUNTER;
private static final long PARKBLOCKER; private static final long PARKBLOCKER;
private static final int ABASE; private static final long QTOP;
private static final int ASHIFT;
private static final long STEALCOUNT;
private static final long PLOCK;
private static final long INDEXSEED;
private static final long QBASE;
private static final long QLOCK; private static final long QLOCK;
private static final long QSCANSTATE;
private static final long QPARKER;
private static final long QCURRENTSTEAL;
private static final long QCURRENTJOIN;
static { static {
// initialize field offsets for CAS etc // initialize field offsets for CAS etc
...@@ -3258,20 +3355,26 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3258,20 +3355,26 @@ public class ForkJoinPool extends AbstractExecutorService {
Class<?> k = ForkJoinPool.class; Class<?> k = ForkJoinPool.class;
CTL = U.objectFieldOffset CTL = U.objectFieldOffset
(k.getDeclaredField("ctl")); (k.getDeclaredField("ctl"));
STEALCOUNT = U.objectFieldOffset RUNSTATE = U.objectFieldOffset
(k.getDeclaredField("stealCount")); (k.getDeclaredField("runState"));
PLOCK = U.objectFieldOffset STEALCOUNTER = U.objectFieldOffset
(k.getDeclaredField("plock")); (k.getDeclaredField("stealCounter"));
INDEXSEED = U.objectFieldOffset
(k.getDeclaredField("indexSeed"));
Class<?> tk = Thread.class; Class<?> tk = Thread.class;
PARKBLOCKER = U.objectFieldOffset PARKBLOCKER = U.objectFieldOffset
(tk.getDeclaredField("parkBlocker")); (tk.getDeclaredField("parkBlocker"));
Class<?> wk = WorkQueue.class; Class<?> wk = WorkQueue.class;
QBASE = U.objectFieldOffset QTOP = U.objectFieldOffset
(wk.getDeclaredField("base")); (wk.getDeclaredField("top"));
QLOCK = U.objectFieldOffset QLOCK = U.objectFieldOffset
(wk.getDeclaredField("qlock")); (wk.getDeclaredField("qlock"));
QSCANSTATE = U.objectFieldOffset
(wk.getDeclaredField("scanState"));
QPARKER = U.objectFieldOffset
(wk.getDeclaredField("parker"));
QCURRENTSTEAL = U.objectFieldOffset
(wk.getDeclaredField("currentSteal"));
QCURRENTJOIN = U.objectFieldOffset
(wk.getDeclaredField("currentJoin"));
Class<?> ak = ForkJoinTask[].class; Class<?> ak = ForkJoinTask[].class;
ABASE = U.arrayBaseOffset(ak); ABASE = U.arrayBaseOffset(ak);
int scale = U.arrayIndexScale(ak); int scale = U.arrayIndexScale(ak);
...@@ -3282,6 +3385,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3282,6 +3385,7 @@ public class ForkJoinPool extends AbstractExecutorService {
throw new Error(e); throw new Error(e);
} }
commonMaxSpares = DEFAULT_COMMON_MAX_SPARES;
defaultForkJoinWorkerThreadFactory = defaultForkJoinWorkerThreadFactory =
new DefaultForkJoinWorkerThreadFactory(); new DefaultForkJoinWorkerThreadFactory();
modifyThreadPermission = new RuntimePermission("modifyThread"); modifyThreadPermission = new RuntimePermission("modifyThread");
...@@ -3289,7 +3393,7 @@ public class ForkJoinPool extends AbstractExecutorService { ...@@ -3289,7 +3393,7 @@ public class ForkJoinPool extends AbstractExecutorService {
common = java.security.AccessController.doPrivileged common = java.security.AccessController.doPrivileged
(new java.security.PrivilegedAction<ForkJoinPool>() { (new java.security.PrivilegedAction<ForkJoinPool>() {
public ForkJoinPool run() { return makeCommonPool(); }}); public ForkJoinPool run() { return makeCommonPool(); }});
int par = common.parallelism; // report 1 even if threads disabled int par = common.config & SMASK; // report 1 even if threads disabled
commonParallelism = par > 0 ? par : 1; commonParallelism = par > 0 ? par : 1;
} }
......
...@@ -297,15 +297,22 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -297,15 +297,22 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
} }
/** /**
* Tries to set SIGNAL status unless already completed. Used by * If not done, sets SIGNAL status and performs Object.wait(timeout).
* ForkJoinPool. Other variants are directly incorporated into * This task may or may not be done on exit. Ignores interrupts.
* externalAwaitDone etc.
* *
* @return true if successful * @param timeout using Object.wait conventions.
*/ */
final boolean trySetSignal() { final void internalWait(long timeout) {
int s = status; int s;
return s >= 0 && U.compareAndSwapInt(this, STATUS, s, s | SIGNAL); if ((s = status) >= 0 && // force completer to issue notify
U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) {
synchronized (this) {
if (status >= 0)
try { wait(timeout); } catch (InterruptedException ie) { }
else
notifyAll();
}
}
} }
/** /**
...@@ -313,35 +320,29 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -313,35 +320,29 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
* @return status upon completion * @return status upon completion
*/ */
private int externalAwaitDone() { private int externalAwaitDone() {
int s; int s = ((this instanceof CountedCompleter) ? // try helping
ForkJoinPool cp = ForkJoinPool.common; ForkJoinPool.common.externalHelpComplete(
if ((s = status) >= 0) { (CountedCompleter<?>)this, 0) :
if (cp != null) { ForkJoinPool.common.tryExternalUnpush(this) ? doExec() : 0);
if (this instanceof CountedCompleter) if (s >= 0 && (s = status) >= 0) {
s = cp.externalHelpComplete((CountedCompleter<?>)this, Integer.MAX_VALUE); boolean interrupted = false;
else if (cp.tryExternalUnpush(this)) do {
s = doExec(); if (U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) {
} synchronized (this) {
if (s >= 0 && (s = status) >= 0) { if (status >= 0) {
boolean interrupted = false; try {
do { wait(0L);
if (U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) { } catch (InterruptedException ie) {
synchronized (this) { interrupted = true;
if (status >= 0) {
try {
wait();
} catch (InterruptedException ie) {
interrupted = true;
}
} }
else
notifyAll();
} }
else
notifyAll();
} }
} while ((s = status) >= 0); }
if (interrupted) } while ((s = status) >= 0);
Thread.currentThread().interrupt(); if (interrupted)
} Thread.currentThread().interrupt();
} }
return s; return s;
} }
...@@ -351,22 +352,22 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -351,22 +352,22 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
*/ */
private int externalInterruptibleAwaitDone() throws InterruptedException { private int externalInterruptibleAwaitDone() throws InterruptedException {
int s; int s;
ForkJoinPool cp = ForkJoinPool.common;
if (Thread.interrupted()) if (Thread.interrupted())
throw new InterruptedException(); throw new InterruptedException();
if ((s = status) >= 0 && cp != null) { if ((s = status) >= 0 &&
if (this instanceof CountedCompleter) (s = ((this instanceof CountedCompleter) ?
cp.externalHelpComplete((CountedCompleter<?>)this, Integer.MAX_VALUE); ForkJoinPool.common.externalHelpComplete(
else if (cp.tryExternalUnpush(this)) (CountedCompleter<?>)this, 0) :
doExec(); ForkJoinPool.common.tryExternalUnpush(this) ? doExec() :
} 0)) >= 0) {
while ((s = status) >= 0) { while ((s = status) >= 0) {
if (U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) { if (U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) {
synchronized (this) { synchronized (this) {
if (status >= 0) if (status >= 0)
wait(); wait(0L);
else else
notifyAll(); notifyAll();
}
} }
} }
} }
...@@ -386,7 +387,7 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -386,7 +387,7 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
((t = Thread.currentThread()) instanceof ForkJoinWorkerThread) ? ((t = Thread.currentThread()) instanceof ForkJoinWorkerThread) ?
(w = (wt = (ForkJoinWorkerThread)t).workQueue). (w = (wt = (ForkJoinWorkerThread)t).workQueue).
tryUnpush(this) && (s = doExec()) < 0 ? s : tryUnpush(this) && (s = doExec()) < 0 ? s :
wt.pool.awaitJoin(w, this) : wt.pool.awaitJoin(w, this, 0L) :
externalAwaitDone(); externalAwaitDone();
} }
...@@ -399,7 +400,8 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -399,7 +400,8 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
int s; Thread t; ForkJoinWorkerThread wt; int s; Thread t; ForkJoinWorkerThread wt;
return (s = doExec()) < 0 ? s : return (s = doExec()) < 0 ? s :
((t = Thread.currentThread()) instanceof ForkJoinWorkerThread) ? ((t = Thread.currentThread()) instanceof ForkJoinWorkerThread) ?
(wt = (ForkJoinWorkerThread)t).pool.awaitJoin(wt.workQueue, this) : (wt = (ForkJoinWorkerThread)t).pool.
awaitJoin(wt.workQueue, this, 0L) :
externalAwaitDone(); externalAwaitDone();
} }
...@@ -577,7 +579,7 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -577,7 +579,7 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
Throwable ex; Throwable ex;
if (e == null || (ex = e.ex) == null) if (e == null || (ex = e.ex) == null)
return null; return null;
if (false && e.thrower != Thread.currentThread().getId()) { if (e.thrower != Thread.currentThread().getId()) {
Class<? extends Throwable> ec = ex.getClass(); Class<? extends Throwable> ec = ex.getClass();
try { try {
Constructor<?> noArgCtor = null; Constructor<?> noArgCtor = null;
...@@ -587,13 +589,17 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -587,13 +589,17 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
Class<?>[] ps = c.getParameterTypes(); Class<?>[] ps = c.getParameterTypes();
if (ps.length == 0) if (ps.length == 0)
noArgCtor = c; noArgCtor = c;
else if (ps.length == 1 && ps[0] == Throwable.class) else if (ps.length == 1 && ps[0] == Throwable.class) {
return (Throwable)(c.newInstance(ex)); Throwable wx = (Throwable)c.newInstance(ex);
return (wx == null) ? ex : wx;
}
} }
if (noArgCtor != null) { if (noArgCtor != null) {
Throwable wx = (Throwable)(noArgCtor.newInstance()); Throwable wx = (Throwable)(noArgCtor.newInstance());
wx.initCause(ex); if (wx != null) {
return wx; wx.initCause(ex);
return wx;
}
} }
} catch (Exception ignore) { } catch (Exception ignore) {
} }
...@@ -1017,67 +1023,40 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable { ...@@ -1017,67 +1023,40 @@ public abstract class ForkJoinTask<V> implements Future<V>, Serializable {
*/ */
public final V get(long timeout, TimeUnit unit) public final V get(long timeout, TimeUnit unit)
throws InterruptedException, ExecutionException, TimeoutException { throws InterruptedException, ExecutionException, TimeoutException {
int s;
long nanos = unit.toNanos(timeout);
if (Thread.interrupted()) if (Thread.interrupted())
throw new InterruptedException(); throw new InterruptedException();
// Messy in part because we measure in nanosecs, but wait in millisecs if ((s = status) >= 0 && nanos > 0L) {
int s; long ms; long d = System.nanoTime() + nanos;
long ns = unit.toNanos(timeout); long deadline = (d == 0L) ? 1L : d; // avoid 0
ForkJoinPool cp;
if ((s = status) >= 0 && ns > 0L) {
long deadline = System.nanoTime() + ns;
ForkJoinPool p = null;
ForkJoinPool.WorkQueue w = null;
Thread t = Thread.currentThread(); Thread t = Thread.currentThread();
if (t instanceof ForkJoinWorkerThread) { if (t instanceof ForkJoinWorkerThread) {
ForkJoinWorkerThread wt = (ForkJoinWorkerThread)t; ForkJoinWorkerThread wt = (ForkJoinWorkerThread)t;
p = wt.pool; s = wt.pool.awaitJoin(wt.workQueue, this, deadline);
w = wt.workQueue;
p.helpJoinOnce(w, this); // no retries on failure
}
else if ((cp = ForkJoinPool.common) != null) {
if (this instanceof CountedCompleter)
cp.externalHelpComplete((CountedCompleter<?>)this, Integer.MAX_VALUE);
else if (cp.tryExternalUnpush(this))
doExec();
} }
boolean canBlock = false; else if ((s = ((this instanceof CountedCompleter) ?
boolean interrupted = false; ForkJoinPool.common.externalHelpComplete(
try { (CountedCompleter<?>)this, 0) :
while ((s = status) >= 0) { ForkJoinPool.common.tryExternalUnpush(this) ?
if (w != null && w.qlock < 0) doExec() : 0)) >= 0) {
cancelIgnoringExceptions(this); long ns, ms; // measure in nanosecs, but wait in millisecs
else if (!canBlock) { while ((s = status) >= 0 &&
if (p == null || p.tryCompensate(p.ctl)) (ns = deadline - System.nanoTime()) > 0L) {
canBlock = true; if ((ms = TimeUnit.NANOSECONDS.toMillis(ns)) > 0L &&
} U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) {
else { synchronized (this) {
if ((ms = TimeUnit.NANOSECONDS.toMillis(ns)) > 0L && if (status >= 0)
U.compareAndSwapInt(this, STATUS, s, s | SIGNAL)) { wait(ms); // OK to throw InterruptedException
synchronized (this) { else
if (status >= 0) { notifyAll();
try {
wait(ms);
} catch (InterruptedException ie) {
if (p == null)
interrupted = true;
}
}
else
notifyAll();
}
} }
if ((s = status) < 0 || interrupted ||
(ns = deadline - System.nanoTime()) <= 0L)
break;
} }
} }
} finally {
if (p != null && canBlock)
p.incrementActiveCount();
} }
if (interrupted)
throw new InterruptedException();
} }
if (s >= 0)
s = status;
if ((s &= DONE_MASK) != NORMAL) { if ((s &= DONE_MASK) != NORMAL) {
Throwable ex; Throwable ex;
if (s == CANCELLED) if (s == CANCELLED)
......
...@@ -66,7 +66,7 @@ public class ForkJoinWorkerThread extends Thread { ...@@ -66,7 +66,7 @@ public class ForkJoinWorkerThread extends Thread {
* owning thread. * owning thread.
* *
* Support for (non-public) subclass InnocuousForkJoinWorkerThread * Support for (non-public) subclass InnocuousForkJoinWorkerThread
* requires that we break quite a lot of encapulation (via Unsafe) * requires that we break quite a lot of encapsulation (via Unsafe)
* both here and in the subclass to access and set Thread fields. * both here and in the subclass to access and set Thread fields.
*/ */
...@@ -118,7 +118,7 @@ public class ForkJoinWorkerThread extends Thread { ...@@ -118,7 +118,7 @@ public class ForkJoinWorkerThread extends Thread {
* @return the index number * @return the index number
*/ */
public int getPoolIndex() { public int getPoolIndex() {
return workQueue.poolIndex >>> 1; // ignore odd/even tag bit return workQueue.getPoolIndex();
} }
/** /**
...@@ -171,7 +171,7 @@ public class ForkJoinWorkerThread extends Thread { ...@@ -171,7 +171,7 @@ public class ForkJoinWorkerThread extends Thread {
} }
/** /**
* Erases ThreadLocals by nulling out Thread maps * Erases ThreadLocals by nulling out Thread maps.
*/ */
final void eraseThreadLocals() { final void eraseThreadLocals() {
U.putObject(this, THREADLOCALS, null); U.putObject(this, THREADLOCALS, null);
...@@ -246,8 +246,8 @@ public class ForkJoinWorkerThread extends Thread { ...@@ -246,8 +246,8 @@ public class ForkJoinWorkerThread extends Thread {
/** /**
* Returns a new group with the system ThreadGroup (the * Returns a new group with the system ThreadGroup (the
* topmost, parentless group) as parent. Uses Unsafe to * topmost, parent-less group) as parent. Uses Unsafe to
* traverse Thread group and ThreadGroup parent fields. * traverse Thread.group and ThreadGroup.parent fields.
*/ */
private static ThreadGroup createThreadGroup() { private static ThreadGroup createThreadGroup() {
try { try {
...@@ -274,4 +274,3 @@ public class ForkJoinWorkerThread extends Thread { ...@@ -274,4 +274,3 @@ public class ForkJoinWorkerThread extends Thread {
} }
} }
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册