Spurious wakeup
 | This article's factual accuracy is disputed. (May 2018) |
 | This article has an unclear citation style. (September 2009) |
Spurious wakeup describes a complication in the use of condition variables as provided by certain multithreading APIs such as POSIX Threads and the Windows API.
Even after a condition variable appears to have been signaled from a waiting thread's point of view, the condition that was awaited may still be false. One of the reasons for this is a spurious wakeup; that is, a thread might be awoken from its waiting state even though no thread signaled the condition variable. For correctness it is necessary, then, to verify that the condition is indeed true after the thread has finished waiting. Because spurious wakeup can happen repeatedly, this is achieved by waiting inside a loop that terminates when the condition is true, for example:
/* In any waiting thread: */
while (!buf->full)
wait(&buf->cond, &buf->lock);
/* In any other thread: */
if (buf->n >= buf->size) {
buf->full = 1;
signal(&buf->cond);
}
In this example it is known that another thread will set buf->full (the actual condition awaited) before signaling buf->cond (the means of synchronizing the two threads). The waiting thread will always verify the truth of the actual condition upon returning from wait, ensuring correct behaviour if spurious wakeup occurs.
According to David R. Butenhof's Programming with POSIX Threads ISBN 0-201-63392-2:
- "This means that when you wait on a condition variable, the wait may (occasionally) return when no thread specifically broadcast or signaled that condition variable. Spurious wakeups may sound strange, but on some multiprocessor systems, making condition wakeup completely predictable might substantially slow all condition variable operations. The race conditions that cause spurious wakeups should be considered rare."
External links
- pthread_cond_wait at the Wayback Machine (archived August 22, 2004)
- Eric Crahen (2003-07-16). "ZThreads: Condition Class Reference".
A Condition is not subject to spurious wakeup.
- Vladimir Prus (2005-07-06). "Spurious wakeups".
- "pthread_cond_timedwait, pthread_cond_wait - wait on a condition". Single UNIX Specification. The Open Group. 2013.
- "SleepConditionVariableCS function". MSDN. 2016-07-15.
- Raymond Chen (2018-02-01). "Spurious wake-ups in Win32 condition variables".
Condition(Java Platform SE)