*
* Userspace RCU header - deferred execution
*
- * Copyright (c) 2009 Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
+ * Copyright (c) 2009 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
* Copyright (c) 2009 Paul E. McKenney, IBM Corporation.
*
* LGPL-compatible code should include this header with :
#include <stdlib.h>
#include <pthread.h>
+#ifdef __cplusplus
+extern "C" {
+#endif
+
/*
+ * 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.
*/
-#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 */
+extern void defer_rcu(void (*fct)(void *p), void *p);
/*
- * library wrappers to be used by non-LGPL compatible source code.
+ * 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);
-
-#endif /* !_LGPL_SOURCE */
-
-#define call_rcu rcu_defer_queue
-#define rcu_reclaim_queue(p) rcu_defer_queue(free, p)
+#define call_rcu __error_call_rcu_not_implemented_please_use_defer_rcu
/*
* Thread registration for reclamation.
extern void rcu_defer_barrier(void);
extern void rcu_defer_barrier_thread(void);
+#ifdef __cplusplus
+}
+#endif
+
#endif /* _URCU_BATCH_H */