X-Git-Url: http://git.liburcu.org/?p=urcu.git;a=blobdiff_plain;f=urcu-defer.h;h=00f18ff47af3177c205006139fbc00850d12b446;hp=e32156c010fdeae325c54b28ee17bb1e72d8d3ec;hb=1ed9b67726a52a0f4189cc1b58ca0141f7b1614f;hpb=8a13058c6fb398132fbe05253d1ac55f4cf4cbd1 diff --git a/urcu-defer.h b/urcu-defer.h index e32156c..00f18ff 100644 --- a/urcu-defer.h +++ b/urcu-defer.h @@ -33,21 +33,28 @@ #include /* + * 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 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. + * *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); -extern void rcu_defer_queue(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. + */ + +#define call_rcu __error_call_rcu_not_implemented_please_use_defer_rcu /* * Thread registration for reclamation.