X-Git-Url: http://git.liburcu.org/?p=urcu.git;a=blobdiff_plain;f=urcu-defer.h;h=00f18ff47af3177c205006139fbc00850d12b446;hp=ac2f53b1728c63c4359ab9cc3cc601a63b57cb53;hb=1ed9b67726a52a0f4189cc1b58ca0141f7b1614f;hpb=2c22932bff02d0124579d70c67695ce2a439006a

diff --git a/urcu-defer.h b/urcu-defer.h
index ac2f53b..00f18ff 100644
--- a/urcu-defer.h
+++ b/urcu-defer.h
@@ -33,17 +33,28 @@
 #include <pthread.h>
 
 /*
+ * Note: the defer_rcu() API is currently EXPERIMENTAL. It may change in the
+ * future.
+ * 
  * Important !
  *
  * 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 defer_rcu() within a RCU read-side critical section, because this
+ * primitive need to call synchronize_rcu() if the thread queue is full.
  */
 
-#define call_rcu		rcu_defer_queue
-#define rcu_reclaim_queue(p)	rcu_defer_queue(free, p)
+extern void defer_rcu(void (*fct)(void *p), void *p);
+
+/*
+ * call_rcu will eventually be implemented with an API similar to the Linux
+ * kernel call_rcu(), which will allow its use within RCU read-side C.S.
+ * Generate an error if used for now.
+ */
 
-extern void rcu_defer_queue(void (*fct)(void *p), void *p);
+#define call_rcu	__error_call_rcu_not_implemented_please_use_defer_rcu
 
 /*
  * Thread registration for reclamation.