rculfhash test: add options

[urcu.git] / urcu / rculfhash.h

diff --git a/urcu/rculfhash.h b/urcu/rculfhash.h
index e650acdf83c91e9357beab3d224136cbf8ca3c92..6bb1ccf619b381e59f0f8d5098b643e569626233 100644 (file)
--- a/urcu/rculfhash.h
+++ b/urcu/rculfhash.h
@@ -5,12 +5,13 @@
 #include <urcu-call-rcu.h>
 
 struct rcu_ht_node {
+       /* cache-hot for iteration */
        struct rcu_ht_node *next;
-       void *key;
-       size_t key_len;
-       unsigned long hash;
        unsigned long reverse_hash;
+       void *key;
+       unsigned int key_len;
        unsigned int dummy;
+       /* cache-cold for iteration */
        struct rcu_head head;
 };
 
@@ -57,8 +58,13 @@ struct rcu_ht_node *ht_lookup(struct rcu_ht *ht, void *key, size_t key_len);
 /* Call with rcu_read_lock held. */
 void ht_add(struct rcu_ht *ht, struct rcu_ht_node *node);
 
-/* Call with rcu_read_lock held. */
-int ht_add_unique(struct rcu_ht *ht, struct rcu_ht_node *node);
+/*
+ * Call with rcu_read_lock held.
+ * Returns the node added upon success.
+ * Returns the unique node already present upon failure. If ht_add_unique fails,
+ * the node passed as parameter should be freed by the caller.
+ */
+struct rcu_ht_node *ht_add_unique(struct rcu_ht *ht, struct rcu_ht_node *node);
 
 /* Call with rcu_read_lock held. */
 int ht_remove(struct rcu_ht *ht, struct rcu_ht_node *node);