Document that destroy puts thread online with QSBR.
Document that resize puts thread online with QSBR, and that it should
not be called with RCU read-side lock held.
Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
* Threads calling this API need to be registered RCU read-side threads.
* cds_lfht_destroy should *not* be called from a RCU read-side critical
* section.
* Threads calling this API need to be registered RCU read-side threads.
* cds_lfht_destroy should *not* be called from a RCU read-side critical
* section.
+ * In userspace RCU 0.7.x, for QSBR RCU flavor, cds_lfht_destroy() has a
+ * side-effect: it puts the caller thread in "online" state. This will
+ * be fixed in userspace RCU 0.8.x.
*/
int cds_lfht_destroy(struct cds_lfht *ht, pthread_attr_t **attr);
*/
int cds_lfht_destroy(struct cds_lfht *ht, pthread_attr_t **attr);
*
* Threads calling this API need to be registered RCU read-side threads.
* This function does not (necessarily) issue memory barriers.
*
* Threads calling this API need to be registered RCU read-side threads.
* This function does not (necessarily) issue memory barriers.
+ * cds_lfht_resize should *not* be called from a RCU read-side critical
+ * section.
+ * In userspace RCU 0.7.x, for QSBR RCU flavor, cds_lfht_resize() has a
+ * side-effect: it puts the caller thread in "online" state. This will
+ * be fixed in userspace RCU 0.8.x.
*/
void cds_lfht_resize(struct cds_lfht *ht, unsigned long new_size);
*/
void cds_lfht_resize(struct cds_lfht *ht, unsigned long new_size);