tree 53e017b2608442cb919595ad0cb6ed3a0108bbbf
parent 57bf1451ac79640c5a0a4f31284c43539fac2903
author Paul E. McKenney <[EMAIL PROTECTED]> Fri, 26 Aug 2005 06:08:37 -0700
committer David S. Miller <[EMAIL PROTECTED]> Tue, 30 Aug 2005 06:11:00 -0700
[LIST]: Add docbook header comments for hlist_add_{before,after}_rcu()
Signed-off-by: David S. Miller <[EMAIL PROTECTED]>
include/linux/list.h | 30 ++++++++++++++++++++++++++++++
1 files changed, 30 insertions(+)
diff --git a/include/linux/list.h b/include/linux/list.h
--- a/include/linux/list.h
+++ b/include/linux/list.h
@@ -634,6 +634,21 @@ static inline void hlist_add_after(struc
next->next->pprev = &next->next;
}
+/**
+ * hlist_add_before_rcu - adds the specified element to the specified hlist
+ * before the specified node while permitting racing traversals.
+ * @n: the new element to add to the hash list.
+ * @next: the existing element to add the new element before.
+ *
+ * The caller must take whatever precautions are necessary
+ * (such as holding appropriate locks) to avoid racing
+ * with another list-mutation primitive, such as hlist_add_head_rcu()
+ * or hlist_del_rcu(), running on this same list.
+ * However, it is perfectly legal to run concurrently with
+ * the _rcu list-traversal primitives, such as
+ * hlist_for_each_rcu(), used to prevent memory-consistency
+ * problems on Alpha CPUs.
+ */
static inline void hlist_add_before_rcu(struct hlist_node *n,
struct hlist_node *next)
{
@@ -644,6 +659,21 @@ static inline void hlist_add_before_rcu(
*(n->pprev) = n;
}
+/**
+ * hlist_add_after_rcu - adds the specified element to the specified hlist
+ * after the specified node while permitting racing traversals.
+ * @prev: the existing element to add the new element after.
+ * @n: the new element to add to the hash list.
+ *
+ * The caller must take whatever precautions are necessary
+ * (such as holding appropriate locks) to avoid racing
+ * with another list-mutation primitive, such as hlist_add_head_rcu()
+ * or hlist_del_rcu(), running on this same list.
+ * However, it is perfectly legal to run concurrently with
+ * the _rcu list-traversal primitives, such as
+ * hlist_for_each_rcu(), used to prevent memory-consistency
+ * problems on Alpha CPUs.
+ */
static inline void hlist_add_after_rcu(struct hlist_node *prev,
struct hlist_node *n)
{
-
To unsubscribe from this list: send the line "unsubscribe git-commits-head" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at http://vger.kernel.org/majordomo-info.html
