Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

doc: Add broken-timing possibility to stallwarn.rst

Currently, stallwarn.rst does not mention the fact that timer bugs can
result in false-positive RCU CPU stall warnings. This commit therefore
adds this to the list.

Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Signed-off-by: Boqun Feng <boqun.feng@gmail.com>

authored by

Paul E. McKenney and committed by
Boqun Feng
bea1d19f 2014c95a

+7
+7
Documentation/RCU/stallwarn.rst
··· 96 96 the ``rcu_.*timer wakeup didn't happen for`` console-log message, 97 97 which will include additional debugging information. 98 98 99 + - A timer issue causes time to appear to jump forward, so that RCU 100 + believes that the RCU CPU stall-warning timeout has been exceeded 101 + when in fact much less time has passed. This could be due to 102 + timer hardware bugs, timer driver bugs, or even corruption of 103 + the "jiffies" global variable. These sorts of timer hardware 104 + and driver bugs are not uncommon when testing new hardware. 105 + 99 106 - A low-level kernel issue that either fails to invoke one of the 100 107 variants of rcu_eqs_enter(true), rcu_eqs_exit(true), ct_idle_enter(), 101 108 ct_idle_exit(), ct_irq_enter(), or ct_irq_exit() on the one