Document call_rcu() usage

[urcu.git] / urcu-defer.h

diff --git a/urcu-defer.h b/urcu-defer.h
index 3e04c00fddb09d1cdd8465945eba4acbe385967a..e32156c010fdeae325c54b28ee17bb1e72d8d3ec 100644 (file)
--- a/urcu-defer.h
+++ b/urcu-defer.h
@@ -38,32 +38,17 @@
  * Each thread queuing memory reclamation must be registered with
  * rcu_defer_register_thread(). rcu_defer_unregister_thread() should be
  * called before the thread exits.
+ *
+ * *NEVER* use call_rcu()/rcu_defer_queue() within a RCU read-side critical
+ * section, because this primitive need to call synchronize_rcu() if the thread
+ * queue is full.
  */
 
-#ifdef _LGPL_SOURCE
-
-#include <urcu-defer-static.h>
-
-/*
- * Mappings for static use of the userspace RCU library.
- * Should only be used in LGPL-compatible code.
- */
-
-#define rcu_defer_queue        _rcu_defer_queue
-
-#else /* !_LGPL_SOURCE */
-
-/*
- * library wrappers to be used by non-LGPL compatible source code.
- */
-
-extern void rcu_defer_queue(void (*fct)(void *p), void *p);
-
-#endif /* !_LGPL_SOURCE */
-
 #define call_rcu               rcu_defer_queue
 #define rcu_reclaim_queue(p)   rcu_defer_queue(free, p)
 
+extern void rcu_defer_queue(void (*fct)(void *p), void *p);
+
 /*
  * Thread registration for reclamation.
  */