> > + new = tail | (val & _Q_LOCKED_MASK); > > + > > + old = atomic_cmpxchg(&lock->val, val, new); > > + if (old == val) > > + break; > > + > > + val = old; > > + } > > + > > + /* > > + * we won the trylock; forget about queueing. > > + */ > > + if (new == _Q_LOCKED_VAL) > > + goto release; > > + > > + /* > > + * if there was a previous node; link it and wait. > > + */ > > + if (old & ~_Q_LOCKED_MASK) { > > + prev = decode_tail(old); > > + ACCESS_ONCE(prev->next) = node; > > + > > + arch_mcs_spin_lock_contended(&node->locked);
Could you add a comment here: /* We are spinning forever until the previous node updates locked - which it does once the it has updated lock->val with our tail number. */ > > + } > > + > > + /* > > + * we're at the head of the waitqueue, wait for the owner to go away. > > + * > > + * *,x -> *,0 > > + */ > > + while ((val = atomic_read(&lock->val)) & _Q_LOCKED_MASK) > > + cpu_relax(); > > + > > + /* > > + * claim the lock: > > + * > > + * n,0 -> 0,1 : lock, uncontended > > + * *,0 -> *,1 : lock, contended > > + */ > > + for (;;) { > > + new = _Q_LOCKED_VAL; > > + if (val != tail) > > + new |= val; > ..snip.. > > Could you help a bit in explaining it in English please? After looking at the assembler code I finally figured out how we can get here. And the 'contended' part threw me off. Somehow I imagined there are two more more CPUs stampeding here and trying to update the lock->val. But in reality the other CPUs are stuck in the arch_mcs_spin_lock_contended spinning on their local value. Perhaps you could add this comment. /* Once queue_spin_unlock is called (which _subtracts_ _Q_LOCKED_VAL from the lock->val and still preserving the tail data), the winner gets to claim the ticket. Since we still need the other CPUs to continue and preserve the strict ordering in which they setup node->next, we: 1) update lock->val to the tail value (so tail CPU and its index) with _Q_LOCKED_VAL. 2). Once we are done, we poke the other CPU (the one that linked to us) by writting to node->locked (below) so they can make progress and loop on lock->val changing from _Q_LOCKED_MASK to zero). */ -- To unsubscribe from this list: send the line "unsubscribe kvm" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html