list_del_rcu

Langue: en

Version: June 2009 (debian - 07/07/09)

Section: 9 (Appels noyau Linux)

NAME

list_del_rcu - deletes entry from list without re-initialization

SYNOPSIS

void list_del_rcu(struct list_head * entry);

ARGUMENTS

entry

the element to delete from the list.

NOTE

list_empty on entry does not return true after this, the entry is in an undefined state. It is useful for RCU based lockfree traversal.

In particular, it means that we can not poison the forward pointers that may still be used for walking the list.

The caller must take whatever precautions are necessary (such as holding appropriate locks) to avoid racing with another list-mutation primitive, such as list_del_rcu or list_add_rcu, running on this same list. However, it is perfectly legal to run concurrently with the _rcu list-traversal primitives, such as list_for_each_entry_rcu.

Note that the caller is not permitted to immediately free the newly deleted entry. Instead, either synchronize_rcu or call_rcu must be used to defer freeing until an RCU grace period has elapsed.