[urcu.git] / include / urcu / rcuhlist.h

// SPDX-FileCopyrightText: 2002 Free Software Foundation, Inc.
// SPDX-FileCopyrightText: 2009 Pierre-Marc Fournier
// SPDX-FileCopyrightText: 2010 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
//
// SPDX-License-Identifier: LGPL-2.1-or-later

/*
 * (originally part of the GNU C Library)
 * Contributed by Ulrich Drepper <drepper@redhat.com>, 2002.
 */

#ifndef _URCU_RCUHLIST_H
#define _URCU_RCUHLIST_H

#include <urcu/hlist.h>
#include <urcu/arch.h>
#include <urcu-pointer.h>

/* Add new element at the head of the list. */
static inline
void cds_hlist_add_head_rcu(struct cds_hlist_node *newp,
		struct cds_hlist_head *head)
{
	newp->next = head->next;
	newp->prev = (struct cds_hlist_node *)head;
	if (head->next)
		head->next->prev = newp;
	rcu_assign_pointer(head->next, newp);
}

/* Remove element from list. */
static inline
void cds_hlist_del_rcu(struct cds_hlist_node *elem)
{
	if (elem->next)
		elem->next->prev = elem->prev;
	CMM_STORE_SHARED(elem->prev->next, elem->next);
}

/*
 * Iterate through elements of the list.
 * This must be done while rcu_read_lock() is held.
 */
#define cds_hlist_for_each_rcu(pos, head) \
	for (pos = rcu_dereference((head)->next); (pos) != NULL; \
		pos = rcu_dereference((pos)->next))

/*
 * cds_hlist_for_each_entry_rcu takes 4 arguments, while the Linux
 * kernel API only takes 3.
 * We implement cds_hlist_for_each_entry_rcu_2() to follow the Linux
 * kernel APIs.
 */
#define cds_hlist_for_each_entry_rcu(entry, pos, head, member) \
	for (pos = rcu_dereference((head)->next), \
			entry = cds_hlist_entry(pos, __typeof__(*(entry)), member); \
		(pos) != NULL; \
		pos = rcu_dereference((pos)->next), \
			entry = cds_hlist_entry(pos, __typeof__(*(entry)), member))

#define cds_hlist_for_each_entry_rcu_2(entry, head, member) \
	for (entry = cds_hlist_entry_safe(rcu_dereference((head)->next), \
			__typeof__(*(entry)), member); \
		(entry) != NULL; \
		entry = cds_hlist_entry_safe(rcu_dereference((entry)->member.next), \
			__typeof__(*(entry)), member))

#endif	/* _URCU_RCUHLIST_H */
Commit	Line	Data
d3d3857f MJ	1	// SPDX-FileCopyrightText: 2002 Free Software Foundation, Inc.
	2	// SPDX-FileCopyrightText: 2009 Pierre-Marc Fournier
	3	// SPDX-FileCopyrightText: 2010 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
	4	//
	5	// SPDX-License-Identifier: LGPL-2.1-or-later
	6
a00718e7	7	/*
a00718e7 MD	8	* (originally part of the GNU C Library)
a00718e7 MD	9	* Contributed by Ulrich Drepper <drepper@redhat.com>, 2002.
a00718e7	10	*/
5db941e8 MD	11
	12	#ifndef _URCU_RCUHLIST_H
	13	#define _URCU_RCUHLIST_H
	14
	15	#include <urcu/hlist.h>
	16	#include <urcu/arch.h>
	17	#include <urcu-pointer.h>
	18
6734fec1 MD	19	/* Add new element at the head of the list. */
	20	static inline
	21	void cds_hlist_add_head_rcu(struct cds_hlist_node *newp,
	22	struct cds_hlist_head *head)
5db941e8 MD	23	{
5db941e8 MD	24	newp->next = head->next;
16aa9ee8	25	newp->prev = (struct cds_hlist_node *)head;
5db941e8 MD	26	if (head->next)
5db941e8 MD	27	head->next->prev = newp;
90bdf188	28	rcu_assign_pointer(head->next, newp);
5db941e8 MD	29	}
	30
	31	/* Remove element from list. */
6734fec1 MD	32	static inline
6734fec1 MD	33	void cds_hlist_del_rcu(struct cds_hlist_node *elem)
5db941e8 MD	34	{
	35	if (elem->next)
	36	elem->next->prev = elem->prev;
90bdf188	37	CMM_STORE_SHARED(elem->prev->next, elem->next);
5db941e8 MD	38	}
5db941e8 MD	39
6734fec1 MD	40	/*
6734fec1 MD	41	* Iterate through elements of the list.
5db941e8 MD	42	* This must be done while rcu_read_lock() is held.
5db941e8 MD	43	*/
d7a0f2fe	44	#define cds_hlist_for_each_rcu(pos, head) \
2b6f565a MD	45	for (pos = rcu_dereference((head)->next); (pos) != NULL; \
2b6f565a MD	46	pos = rcu_dereference((pos)->next))
d7a0f2fe MD	47
	48	/*
	49	* cds_hlist_for_each_entry_rcu takes 4 arguments, while the Linux
	50	* kernel API only takes 3.
	51	* We implement cds_hlist_for_each_entry_rcu_2() to follow the Linux
	52	* kernel APIs.
	53	*/
6734fec1 MD	54	#define cds_hlist_for_each_entry_rcu(entry, pos, head, member) \
6734fec1 MD	55	for (pos = rcu_dereference((head)->next), \
2b6f565a MD	56	entry = cds_hlist_entry(pos, __typeof__(*(entry)), member); \
	57	(pos) != NULL; \
	58	pos = rcu_dereference((pos)->next), \
	59	entry = cds_hlist_entry(pos, __typeof__(*(entry)), member))
5db941e8	60
d7a0f2fe	61	#define cds_hlist_for_each_entry_rcu_2(entry, head, member) \
a0b5ef68	62	for (entry = cds_hlist_entry_safe(rcu_dereference((head)->next), \
2b6f565a MD	63	__typeof__(*(entry)), member); \
	64	(entry) != NULL; \
	65	entry = cds_hlist_entry_safe(rcu_dereference((entry)->member.next), \
	66	__typeof__(*(entry)), member))
d7a0f2fe	67
5db941e8	68	#endif /* _URCU_RCUHLIST_H */