urcu-defer: generate linker error if call_rcu() is used

[urcu.git] / urcu-defer.h

diff --git a/urcu-defer.h b/urcu-defer.h
index 75b600568bc7a2df852cb246e1a300732c6989b8..00f18ff47af3177c205006139fbc00850d12b446 100644 (file)
--- a/urcu-defer.h
+++ b/urcu-defer.h
@@ -33,6 +33,9 @@
 #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
@@ -43,10 +46,15 @@
  * primitive need to call synchronize_rcu() if the thread queue is full.
  */
 
-#define defer_rcu(fct, p)      defer_rcu_ratelimit(fct, p, NULL)
+extern void defer_rcu(void (*fct)(void *p), void *p);
 
-extern void defer_rcu_ratelimit(void (*fct)(void *p), void *p,
-                               int (*rl)(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.
+ */
+
+#define call_rcu       __error_call_rcu_not_implemented_please_use_defer_rcu
 
 /*
  * Thread registration for reclamation.