From cc558521e7bc8767bc78c93436cd4af3c6c84edd Mon Sep 17 00:00:00 2001 From: Mathieu Desnoyers Date: Thu, 15 Sep 2011 10:04:30 -0400 Subject: [PATCH] Document QSBR interaction with mutexes Signed-off-by: Mathieu Desnoyers --- README | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README b/README index 1e76f2d..e3800fa 100644 --- a/README +++ b/README @@ -187,6 +187,15 @@ Interaction with mutexes mutex in its dependency chain) should not be acquired from within a RCU read-side critical section. + This is especially important to understand in the context of the + QSBR flavor: a registered reader thread being "online" by + default should be considered as within a RCU read-side critical + section unless explicitly put "offline". Therefore, if + synchronize_rcu() is called with a mutex held, this mutex, as + well as any mutex which has this mutex in its dependency chain + should only be taken when the RCU reader thread is "offline" + (this can be performed by calling rcu_thread_offline()). + Usage of DEBUG_RCU DEBUG_RCU is used to add internal debugging self-checks to the -- 2.34.1