X-Git-Url: http://git.liburcu.org/?p=urcu.git;a=blobdiff_plain;f=urcu-defer.h;h=00f18ff47af3177c205006139fbc00850d12b446;hp=456b8b7ff9bcbc635731cca576a609dc6de8c289;hb=1ed9b67726a52a0f4189cc1b58ca0141f7b1614f;hpb=786ee85b1676d2a1865b2db7120c45bafdf954d6 diff --git a/urcu-defer.h b/urcu-defer.h index 456b8b7..00f18ff 100644 --- a/urcu-defer.h +++ b/urcu-defer.h @@ -33,33 +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 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 - -/* - * 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 *p); - -#endif /* !_LGPL_SOURCE */ +#define call_rcu __error_call_rcu_not_implemented_please_use_defer_rcu /* * Thread registration for reclamation.