• Peter Zijlstra's avatar
    sched/wake_q: Document wake_q_add() · e6018c0f
    Peter Zijlstra authored
    The only guarantee provided by wake_q_add() is that a wakeup will
    happen after it, it does _NOT_ guarantee the wakeup will be delayed
    until the matching wake_up_q().
    
    If wake_q_add() fails the cmpxchg() a concurrent wakeup is pending and
    that can happen at any time after the cmpxchg(). This means we should
    not rely on the wakeup happening at wake_q_up(), but should be ready
    for wake_q_add() to issue the wakeup.
    
    The delay; if provided (most likely); should only result in more efficient
    behaviour.
    Reported-by: default avatarYongji Xie <elohimes@gmail.com>
    Signed-off-by: default avatarPeter Zijlstra (Intel) <peterz@infradead.org>
    Cc: Davidlohr Bueso <dave@stgolabs.net>
    Cc: Linus Torvalds <torvalds@linux-foundation.org>
    Cc: Peter Zijlstra <peterz@infradead.org>
    Cc: Thomas Gleixner <tglx@linutronix.de>
    Cc: Waiman Long <longman@redhat.com>
    Cc: Will Deacon <will.deacon@arm.com>
    Signed-off-by: default avatarIngo Molnar <mingo@kernel.org>
    e6018c0f
core.c 173 KB