hash: fix return of bulk lookup
[dpdk.git] / lib / librte_hash / rte_cuckoo_hash.c
index 9a48934..7e6c139 100644 (file)
@@ -1,5 +1,6 @@
 /* SPDX-License-Identifier: BSD-3-Clause
  * Copyright(c) 2010-2016 Intel Corporation
+ * Copyright(c) 2018 Arm Limited
  */
 
 #include <string.h>
@@ -12,7 +13,6 @@
 #include <rte_common.h>
 #include <rte_memory.h>         /* for definition of RTE_CACHE_LINE_SIZE */
 #include <rte_log.h>
-#include <rte_memcpy.h>
 #include <rte_prefetch.h>
 #include <rte_branch_prediction.h>
 #include <rte_malloc.h>
@@ -26,7 +26,6 @@
 #include <rte_spinlock.h>
 #include <rte_ring.h>
 #include <rte_compat.h>
-#include <rte_pause.h>
 
 #include "rte_hash.h"
 #include "rte_cuckoo_hash.h"
@@ -136,9 +135,13 @@ rte_hash_create(const struct rte_hash_parameters *params)
        char ext_ring_name[RTE_RING_NAMESIZE];
        unsigned num_key_slots;
        unsigned i;
-       unsigned int hw_trans_mem_support = 0, multi_writer_support = 0;
+       unsigned int hw_trans_mem_support = 0, use_local_cache = 0;
        unsigned int ext_table_support = 0;
        unsigned int readwrite_concur_support = 0;
+       unsigned int writer_takes_lock = 0;
+       unsigned int no_free_on_del = 0;
+       uint32_t *tbl_chng_cnt = NULL;
+       unsigned int readwrite_concur_lf_support = 0;
 
        rte_hash_function default_hash_func = (rte_hash_function)rte_jhash;
 
@@ -158,23 +161,52 @@ rte_hash_create(const struct rte_hash_parameters *params)
                return NULL;
        }
 
+       /* Validate correct usage of extra options */
+       if ((params->extra_flag & RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY) &&
+           (params->extra_flag & RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY_LF)) {
+               rte_errno = EINVAL;
+               RTE_LOG(ERR, HASH, "rte_hash_create: choose rw concurrency or "
+                       "rw concurrency lock free\n");
+               return NULL;
+       }
+
+       if ((params->extra_flag & RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY_LF) &&
+           (params->extra_flag & RTE_HASH_EXTRA_FLAGS_EXT_TABLE)) {
+               rte_errno = EINVAL;
+               RTE_LOG(ERR, HASH, "rte_hash_create: extendable bucket "
+                       "feature not supported with rw concurrency "
+                       "lock free\n");
+               return NULL;
+       }
+
        /* Check extra flags field to check extra options. */
        if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_TRANS_MEM_SUPPORT)
                hw_trans_mem_support = 1;
 
-       if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_MULTI_WRITER_ADD)
-               multi_writer_support = 1;
+       if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_MULTI_WRITER_ADD) {
+               use_local_cache = 1;
+               writer_takes_lock = 1;
+       }
 
        if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY) {
                readwrite_concur_support = 1;
-               multi_writer_support = 1;
+               writer_takes_lock = 1;
        }
 
        if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_EXT_TABLE)
                ext_table_support = 1;
 
+       if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_NO_FREE_ON_DEL)
+               no_free_on_del = 1;
+
+       if (params->extra_flag & RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY_LF) {
+               readwrite_concur_lf_support = 1;
+               /* Enable not freeing internal memory/index on delete */
+               no_free_on_del = 1;
+       }
+
        /* Store all keys and leave the first entry as a dummy entry for lookup_bulk */
-       if (multi_writer_support)
+       if (use_local_cache)
                /*
                 * Increase number of slots by total number of indices
                 * that can be stored in the lcore caches
@@ -272,7 +304,9 @@ rte_hash_create(const struct rte_hash_parameters *params)
                        rte_ring_sp_enqueue(r_ext, (void *)((uintptr_t) i));
        }
 
-       const uint32_t key_entry_size = sizeof(struct rte_hash_key) + params->key_len;
+       const uint32_t key_entry_size =
+               RTE_ALIGN(sizeof(struct rte_hash_key) + params->key_len,
+                         KEY_ALIGNMENT);
        const uint64_t key_tbl_size = (uint64_t) key_entry_size * num_key_slots;
 
        k = rte_zmalloc_socket(NULL, key_tbl_size,
@@ -283,6 +317,14 @@ rte_hash_create(const struct rte_hash_parameters *params)
                goto err_unlock;
        }
 
+       tbl_chng_cnt = rte_zmalloc_socket(NULL, sizeof(uint32_t),
+                       RTE_CACHE_LINE_SIZE, params->socket_id);
+
+       if (tbl_chng_cnt == NULL) {
+               RTE_LOG(ERR, HASH, "memory allocation failed\n");
+               goto err_unlock;
+       }
+
 /*
  * If x86 architecture is used, select appropriate compare function,
  * which may use x86 intrinsics, otherwise use memcmp
@@ -322,7 +364,7 @@ rte_hash_create(const struct rte_hash_parameters *params)
        h->cmp_jump_table_idx = KEY_OTHER_BYTES;
 #endif
 
-       if (multi_writer_support) {
+       if (use_local_cache) {
                h->local_free_slots = rte_zmalloc_socket(NULL,
                                sizeof(struct lcore_cache) * RTE_MAX_LCORE,
                                RTE_CACHE_LINE_SIZE, params->socket_id);
@@ -351,10 +393,15 @@ rte_hash_create(const struct rte_hash_parameters *params)
                default_hash_func : params->hash_func;
        h->key_store = k;
        h->free_slots = r;
+       h->tbl_chng_cnt = tbl_chng_cnt;
+       *h->tbl_chng_cnt = 0;
        h->hw_trans_mem_support = hw_trans_mem_support;
-       h->multi_writer_support = multi_writer_support;
+       h->use_local_cache = use_local_cache;
        h->readwrite_concur_support = readwrite_concur_support;
        h->ext_table_support = ext_table_support;
+       h->writer_takes_lock = writer_takes_lock;
+       h->no_free_on_del = no_free_on_del;
+       h->readwrite_concur_lf_support = readwrite_concur_lf_support;
 
 #if defined(RTE_ARCH_X86)
        if (rte_cpu_get_flag_enabled(RTE_CPUFLAG_SSE2))
@@ -363,10 +410,11 @@ rte_hash_create(const struct rte_hash_parameters *params)
 #endif
                h->sig_cmp_fn = RTE_HASH_COMPARE_SCALAR;
 
-       /* Turn on multi-writer only with explicit flag from user and TM
-        * support.
+       /* Writer threads need to take the lock when:
+        * 1) RTE_HASH_EXTRA_FLAGS_RW_CONCURRENCY is enabled OR
+        * 2) RTE_HASH_EXTRA_FLAGS_MULTI_WRITER_ADD is enabled
         */
-       if (h->multi_writer_support) {
+       if (h->writer_takes_lock) {
                h->readwrite_lock = rte_malloc(NULL, sizeof(rte_rwlock_t),
                                                RTE_CACHE_LINE_SIZE);
                if (h->readwrite_lock == NULL)
@@ -394,6 +442,7 @@ err:
        rte_free(buckets);
        rte_free(buckets_ext);
        rte_free(k);
+       rte_free(tbl_chng_cnt);
        return NULL;
 }
 
@@ -425,15 +474,16 @@ rte_hash_free(struct rte_hash *h)
 
        rte_rwlock_write_unlock(RTE_EAL_TAILQ_RWLOCK);
 
-       if (h->multi_writer_support) {
+       if (h->use_local_cache)
                rte_free(h->local_free_slots);
+       if (h->writer_takes_lock)
                rte_free(h->readwrite_lock);
-       }
        rte_ring_free(h->free_slots);
        rte_ring_free(h->free_ext_bkts);
        rte_free(h->key_store);
        rte_free(h->buckets);
        rte_free(h->buckets_ext);
+       rte_free(h->tbl_chng_cnt);
        rte_free(h);
        rte_free(te);
 }
@@ -454,7 +504,7 @@ rte_hash_count(const struct rte_hash *h)
        if (h == NULL)
                return -EINVAL;
 
-       if (h->multi_writer_support) {
+       if (h->use_local_cache) {
                tot_ring_cnt = h->entries + (RTE_MAX_LCORE - 1) *
                                        (LCORE_CACHE_SIZE - 1);
                for (i = 0; i < RTE_MAX_LCORE; i++)
@@ -473,9 +523,9 @@ rte_hash_count(const struct rte_hash *h)
 static inline void
 __hash_rw_writer_lock(const struct rte_hash *h)
 {
-       if (h->multi_writer_support && h->hw_trans_mem_support)
+       if (h->writer_takes_lock && h->hw_trans_mem_support)
                rte_rwlock_write_lock_tm(h->readwrite_lock);
-       else if (h->multi_writer_support)
+       else if (h->writer_takes_lock)
                rte_rwlock_write_lock(h->readwrite_lock);
 }
 
@@ -491,9 +541,9 @@ __hash_rw_reader_lock(const struct rte_hash *h)
 static inline void
 __hash_rw_writer_unlock(const struct rte_hash *h)
 {
-       if (h->multi_writer_support && h->hw_trans_mem_support)
+       if (h->writer_takes_lock && h->hw_trans_mem_support)
                rte_rwlock_write_unlock_tm(h->readwrite_lock);
-       else if (h->multi_writer_support)
+       else if (h->writer_takes_lock)
                rte_rwlock_write_unlock(h->readwrite_lock);
 }
 
@@ -518,21 +568,22 @@ rte_hash_reset(struct rte_hash *h)
        __hash_rw_writer_lock(h);
        memset(h->buckets, 0, h->num_buckets * sizeof(struct rte_hash_bucket));
        memset(h->key_store, 0, h->key_entry_size * (h->entries + 1));
+       *h->tbl_chng_cnt = 0;
 
        /* clear the free ring */
        while (rte_ring_dequeue(h->free_slots, &ptr) == 0)
-               rte_pause();
+               continue;
 
        /* clear free extendable bucket ring and memory */
        if (h->ext_table_support) {
                memset(h->buckets_ext, 0, h->num_buckets *
                                                sizeof(struct rte_hash_bucket));
                while (rte_ring_dequeue(h->free_ext_bkts, &ptr) == 0)
-                       rte_pause();
+                       continue;
        }
 
        /* Repopulate the free slots ring. Entry zero is reserved for key misses */
-       if (h->multi_writer_support)
+       if (h->use_local_cache)
                tot_ring_cnt = h->entries + (RTE_MAX_LCORE - 1) *
                                        (LCORE_CACHE_SIZE - 1);
        else
@@ -548,7 +599,7 @@ rte_hash_reset(struct rte_hash *h)
                                                (void *)((uintptr_t) i));
        }
 
-       if (h->multi_writer_support) {
+       if (h->use_local_cache) {
                /* Reset local caches per lcore */
                for (i = 0; i < RTE_MAX_LCORE; i++)
                        h->local_free_slots[i].len = 0;
@@ -566,14 +617,16 @@ enqueue_slot_back(const struct rte_hash *h,
                struct lcore_cache *cached_free_slots,
                void *slot_id)
 {
-       if (h->multi_writer_support) {
+       if (h->use_local_cache) {
                cached_free_slots->objs[cached_free_slots->len] = slot_id;
                cached_free_slots->len++;
        } else
                rte_ring_sp_enqueue(h->free_slots, slot_id);
 }
 
-/* Search a key from bucket and update its data */
+/* Search a key from bucket and update its data.
+ * Writer holds the lock before calling this.
+ */
 static inline int32_t
 search_and_update(const struct rte_hash *h, void *data, const void *key,
        struct rte_hash_bucket *bkt, uint16_t sig)
@@ -586,8 +639,13 @@ search_and_update(const struct rte_hash *h, void *data, const void *key,
                        k = (struct rte_hash_key *) ((char *)keys +
                                        bkt->key_idx[i] * h->key_entry_size);
                        if (rte_hash_cmp_eq(key, k->key, h) == 0) {
-                               /* Update data */
-                               k->pdata = data;
+                               /* 'pdata' acts as the synchronization point
+                                * when an existing hash entry is updated.
+                                * Key is not updated in this case.
+                                */
+                               __atomic_store_n(&k->pdata,
+                                       data,
+                                       __ATOMIC_RELEASE);
                                /*
                                 * Return index where key is stored,
                                 * subtracting the first dummy index
@@ -643,7 +701,15 @@ rte_hash_cuckoo_insert_mw(const struct rte_hash *h,
                /* Check if slot is available */
                if (likely(prim_bkt->key_idx[i] == EMPTY_SLOT)) {
                        prim_bkt->sig_current[i] = sig;
-                       prim_bkt->key_idx[i] = new_idx;
+                       /* Key can be of arbitrary length, so it is
+                        * not possible to store it atomically.
+                        * Hence the new key element's memory stores
+                        * (key as well as data) should be complete
+                        * before it is referenced.
+                        */
+                       __atomic_store_n(&prim_bkt->key_idx[i],
+                                        new_idx,
+                                        __ATOMIC_RELEASE);
                        break;
                }
        }
@@ -716,27 +782,66 @@ rte_hash_cuckoo_move_insert_mw(const struct rte_hash *h,
                if (unlikely(&h->buckets[prev_alt_bkt_idx]
                                != curr_bkt)) {
                        /* revert it to empty, otherwise duplicated keys */
-                       curr_bkt->key_idx[curr_slot] = EMPTY_SLOT;
+                       __atomic_store_n(&curr_bkt->key_idx[curr_slot],
+                               EMPTY_SLOT,
+                               __ATOMIC_RELEASE);
                        __hash_rw_writer_unlock(h);
                        return -1;
                }
 
+               if (h->readwrite_concur_lf_support) {
+                       /* Inform the previous move. The current move need
+                        * not be informed now as the current bucket entry
+                        * is present in both primary and secondary.
+                        * Since there is one writer, load acquires on
+                        * tbl_chng_cnt are not required.
+                        */
+                       __atomic_store_n(h->tbl_chng_cnt,
+                                        *h->tbl_chng_cnt + 1,
+                                        __ATOMIC_RELEASE);
+                       /* The stores to sig_alt and sig_current should not
+                        * move above the store to tbl_chng_cnt.
+                        */
+                       __atomic_thread_fence(__ATOMIC_RELEASE);
+               }
+
                /* Need to swap current/alt sig to allow later
                 * Cuckoo insert to move elements back to its
                 * primary bucket if available
                 */
                curr_bkt->sig_current[curr_slot] =
                        prev_bkt->sig_current[prev_slot];
-               curr_bkt->key_idx[curr_slot] =
-                       prev_bkt->key_idx[prev_slot];
+               /* Release the updated bucket entry */
+               __atomic_store_n(&curr_bkt->key_idx[curr_slot],
+                       prev_bkt->key_idx[prev_slot],
+                       __ATOMIC_RELEASE);
 
                curr_slot = prev_slot;
                curr_node = prev_node;
                curr_bkt = curr_node->bkt;
        }
 
+       if (h->readwrite_concur_lf_support) {
+               /* Inform the previous move. The current move need
+                * not be informed now as the current bucket entry
+                * is present in both primary and secondary.
+                * Since there is one writer, load acquires on
+                * tbl_chng_cnt are not required.
+                */
+               __atomic_store_n(h->tbl_chng_cnt,
+                                *h->tbl_chng_cnt + 1,
+                                __ATOMIC_RELEASE);
+               /* The stores to sig_alt and sig_current should not
+                * move above the store to tbl_chng_cnt.
+                */
+               __atomic_thread_fence(__ATOMIC_RELEASE);
+       }
+
        curr_bkt->sig_current[curr_slot] = sig;
-       curr_bkt->key_idx[curr_slot] = new_idx;
+       /* Release the new bucket entry */
+       __atomic_store_n(&curr_bkt->key_idx[curr_slot],
+                        new_idx,
+                        __ATOMIC_RELEASE);
 
        __hash_rw_writer_unlock(h);
 
@@ -848,7 +953,7 @@ __rte_hash_add_key_with_hash(const struct rte_hash *h, const void *key,
        __hash_rw_writer_unlock(h);
 
        /* Did not find a match, so get a new slot for storing the new key */
-       if (h->multi_writer_support) {
+       if (h->use_local_cache) {
                lcore_id = rte_lcore_id();
                cached_free_slots = &h->local_free_slots[lcore_id];
                /* Try to get a free slot from the local cache */
@@ -876,9 +981,16 @@ __rte_hash_add_key_with_hash(const struct rte_hash *h, const void *key,
        new_k = RTE_PTR_ADD(keys, (uintptr_t)slot_id * h->key_entry_size);
        new_idx = (uint32_t)((uintptr_t) slot_id);
        /* Copy key */
-       rte_memcpy(new_k->key, key, h->key_len);
-       new_k->pdata = data;
-
+       memcpy(new_k->key, key, h->key_len);
+       /* Key can be of arbitrary length, so it is not possible to store
+        * it atomically. Hence the new key element's memory stores
+        * (key as well as data) should be complete before it is referenced.
+        * 'pdata' acts as the synchronization point when an existing hash
+        * entry is updated.
+        */
+       __atomic_store_n(&new_k->pdata,
+               data,
+               __ATOMIC_RELEASE);
 
        /* Find an empty slot and insert */
        ret = rte_hash_cuckoo_insert_mw(h, prim_bkt, sec_bkt, key, data,
@@ -1016,10 +1128,11 @@ rte_hash_add_key_data(const struct rte_hash *h, const void *key, void *data)
                return ret;
 }
 
-/* Search one bucket to find the match key */
+/* Search one bucket to find the match key - uses rw lock */
 static inline int32_t
-search_one_bucket(const struct rte_hash *h, const void *key, uint16_t sig,
-                       void **data, const struct rte_hash_bucket *bkt)
+search_one_bucket_l(const struct rte_hash *h, const void *key,
+               uint16_t sig, void **data,
+               const struct rte_hash_bucket *bkt)
 {
        int i;
        struct rte_hash_key *k, *keys = h->key_store;
@@ -1029,6 +1142,7 @@ search_one_bucket(const struct rte_hash *h, const void *key, uint16_t sig,
                                bkt->key_idx[i] != EMPTY_SLOT) {
                        k = (struct rte_hash_key *) ((char *)keys +
                                        bkt->key_idx[i] * h->key_entry_size);
+
                        if (rte_hash_cmp_eq(key, k->key, h) == 0) {
                                if (data != NULL)
                                        *data = k->pdata;
@@ -1043,9 +1157,42 @@ search_one_bucket(const struct rte_hash *h, const void *key, uint16_t sig,
        return -1;
 }
 
+/* Search one bucket to find the match key */
 static inline int32_t
-__rte_hash_lookup_with_hash(const struct rte_hash *h, const void *key,
-                                       hash_sig_t sig, void **data)
+search_one_bucket_lf(const struct rte_hash *h, const void *key, uint16_t sig,
+                       void **data, const struct rte_hash_bucket *bkt)
+{
+       int i;
+       uint32_t key_idx;
+       void *pdata;
+       struct rte_hash_key *k, *keys = h->key_store;
+
+       for (i = 0; i < RTE_HASH_BUCKET_ENTRIES; i++) {
+               key_idx = __atomic_load_n(&bkt->key_idx[i],
+                                         __ATOMIC_ACQUIRE);
+               if (bkt->sig_current[i] == sig && key_idx != EMPTY_SLOT) {
+                       k = (struct rte_hash_key *) ((char *)keys +
+                                       key_idx * h->key_entry_size);
+                       pdata = __atomic_load_n(&k->pdata,
+                                       __ATOMIC_ACQUIRE);
+
+                       if (rte_hash_cmp_eq(key, k->key, h) == 0) {
+                               if (data != NULL)
+                                       *data = pdata;
+                               /*
+                                * Return index where key is stored,
+                                * subtracting the first dummy index
+                                */
+                               return key_idx - 1;
+                       }
+               }
+       }
+       return -1;
+}
+
+static inline int32_t
+__rte_hash_lookup_with_hash_l(const struct rte_hash *h, const void *key,
+                               hash_sig_t sig, void **data)
 {
        uint32_t prim_bucket_idx, sec_bucket_idx;
        struct rte_hash_bucket *bkt, *cur_bkt;
@@ -1055,12 +1202,13 @@ __rte_hash_lookup_with_hash(const struct rte_hash *h, const void *key,
        short_sig = get_short_sig(sig);
        prim_bucket_idx = get_prim_bucket_index(h, sig);
        sec_bucket_idx = get_alt_bucket_index(h, prim_bucket_idx, short_sig);
+
        bkt = &h->buckets[prim_bucket_idx];
 
        __hash_rw_reader_lock(h);
 
        /* Check if key is in primary location */
-       ret = search_one_bucket(h, key, short_sig, data, bkt);
+       ret = search_one_bucket_l(h, key, short_sig, data, bkt);
        if (ret != -1) {
                __hash_rw_reader_unlock(h);
                return ret;
@@ -1070,16 +1218,90 @@ __rte_hash_lookup_with_hash(const struct rte_hash *h, const void *key,
 
        /* Check if key is in secondary location */
        FOR_EACH_BUCKET(cur_bkt, bkt) {
-               ret = search_one_bucket(h, key, short_sig, data, cur_bkt);
+               ret = search_one_bucket_l(h, key, short_sig,
+                                       data, cur_bkt);
                if (ret != -1) {
                        __hash_rw_reader_unlock(h);
                        return ret;
                }
        }
+
        __hash_rw_reader_unlock(h);
+
+       return -ENOENT;
+}
+
+static inline int32_t
+__rte_hash_lookup_with_hash_lf(const struct rte_hash *h, const void *key,
+                                       hash_sig_t sig, void **data)
+{
+       uint32_t prim_bucket_idx, sec_bucket_idx;
+       struct rte_hash_bucket *bkt, *cur_bkt;
+       uint32_t cnt_b, cnt_a;
+       int ret;
+       uint16_t short_sig;
+
+       short_sig = get_short_sig(sig);
+       prim_bucket_idx = get_prim_bucket_index(h, sig);
+       sec_bucket_idx = get_alt_bucket_index(h, prim_bucket_idx, short_sig);
+
+       do {
+               /* Load the table change counter before the lookup
+                * starts. Acquire semantics will make sure that
+                * loads in search_one_bucket are not hoisted.
+                */
+               cnt_b = __atomic_load_n(h->tbl_chng_cnt,
+                               __ATOMIC_ACQUIRE);
+
+               /* Check if key is in primary location */
+               bkt = &h->buckets[prim_bucket_idx];
+               ret = search_one_bucket_lf(h, key, short_sig, data, bkt);
+               if (ret != -1) {
+                       __hash_rw_reader_unlock(h);
+                       return ret;
+               }
+               /* Calculate secondary hash */
+               bkt = &h->buckets[sec_bucket_idx];
+
+               /* Check if key is in secondary location */
+               FOR_EACH_BUCKET(cur_bkt, bkt) {
+                       ret = search_one_bucket_lf(h, key, short_sig,
+                                               data, cur_bkt);
+                       if (ret != -1) {
+                               __hash_rw_reader_unlock(h);
+                               return ret;
+                       }
+               }
+
+               /* The loads of sig_current in search_one_bucket
+                * should not move below the load from tbl_chng_cnt.
+                */
+               __atomic_thread_fence(__ATOMIC_ACQUIRE);
+               /* Re-read the table change counter to check if the
+                * table has changed during search. If yes, re-do
+                * the search.
+                * This load should not get hoisted. The load
+                * acquires on cnt_b, key index in primary bucket
+                * and key index in secondary bucket will make sure
+                * that it does not get hoisted.
+                */
+               cnt_a = __atomic_load_n(h->tbl_chng_cnt,
+                                       __ATOMIC_ACQUIRE);
+       } while (cnt_b != cnt_a);
+
        return -ENOENT;
 }
 
+static inline int32_t
+__rte_hash_lookup_with_hash(const struct rte_hash *h, const void *key,
+                                       hash_sig_t sig, void **data)
+{
+       if (h->readwrite_concur_lf_support)
+               return __rte_hash_lookup_with_hash_lf(h, key, sig, data);
+       else
+               return __rte_hash_lookup_with_hash_l(h, key, sig, data);
+}
+
 int32_t
 rte_hash_lookup_with_hash(const struct rte_hash *h,
                        const void *key, hash_sig_t sig)
@@ -1116,8 +1338,7 @@ remove_entry(const struct rte_hash *h, struct rte_hash_bucket *bkt, unsigned i)
        unsigned lcore_id, n_slots;
        struct lcore_cache *cached_free_slots;
 
-       bkt->sig_current[i] = NULL_SIGNATURE;
-       if (h->multi_writer_support) {
+       if (h->use_local_cache) {
                lcore_id = rte_lcore_id();
                cached_free_slots = &h->local_free_slots[lcore_id];
                /* Cache full, need to free it. */
@@ -1162,31 +1383,43 @@ __rte_hash_compact_ll(struct rte_hash_bucket *cur_bkt, int pos) {
        }
 }
 
-/* Search one bucket and remove the matched key */
+/* Search one bucket and remove the matched key.
+ * Writer is expected to hold the lock while calling this
+ * function.
+ */
 static inline int32_t
 search_and_remove(const struct rte_hash *h, const void *key,
                        struct rte_hash_bucket *bkt, uint16_t sig, int *pos)
 {
        struct rte_hash_key *k, *keys = h->key_store;
        unsigned int i;
-       int32_t ret;
+       uint32_t key_idx;
 
        /* Check if key is in bucket */
        for (i = 0; i < RTE_HASH_BUCKET_ENTRIES; i++) {
-               if (bkt->sig_current[i] == sig &&
-                               bkt->key_idx[i] != EMPTY_SLOT) {
+               key_idx = __atomic_load_n(&bkt->key_idx[i],
+                                         __ATOMIC_ACQUIRE);
+               if (bkt->sig_current[i] == sig && key_idx != EMPTY_SLOT) {
                        k = (struct rte_hash_key *) ((char *)keys +
-                                       bkt->key_idx[i] * h->key_entry_size);
+                                       key_idx * h->key_entry_size);
                        if (rte_hash_cmp_eq(key, k->key, h) == 0) {
-                               remove_entry(h, bkt, i);
+                               bkt->sig_current[i] = NULL_SIGNATURE;
+                               /* Free the key store index if
+                                * no_free_on_del is disabled.
+                                */
+                               if (!h->no_free_on_del)
+                                       remove_entry(h, bkt, i);
+
+                               __atomic_store_n(&bkt->key_idx[i],
+                                                EMPTY_SLOT,
+                                                __ATOMIC_RELEASE);
 
-                               /* Return index where key is stored,
+                               *pos = i;
+                               /*
+                                * Return index where key is stored,
                                 * subtracting the first dummy index
                                 */
-                               ret = bkt->key_idx[i] - 1;
-                               bkt->key_idx[i] = EMPTY_SLOT;
-                               *pos = i;
-                               return ret;
+                               return key_idx - 1;
                        }
                }
        }
@@ -1296,6 +1529,43 @@ rte_hash_get_key_with_position(const struct rte_hash *h, const int32_t position,
        return 0;
 }
 
+int __rte_experimental
+rte_hash_free_key_with_position(const struct rte_hash *h,
+                               const int32_t position)
+{
+       RETURN_IF_TRUE(((h == NULL) || (position == EMPTY_SLOT)), -EINVAL);
+
+       unsigned int lcore_id, n_slots;
+       struct lcore_cache *cached_free_slots;
+       const int32_t total_entries = h->num_buckets * RTE_HASH_BUCKET_ENTRIES;
+
+       /* Out of bounds */
+       if (position >= total_entries)
+               return -EINVAL;
+
+       if (h->use_local_cache) {
+               lcore_id = rte_lcore_id();
+               cached_free_slots = &h->local_free_slots[lcore_id];
+               /* Cache full, need to free it. */
+               if (cached_free_slots->len == LCORE_CACHE_SIZE) {
+                       /* Need to enqueue the free slots in global ring. */
+                       n_slots = rte_ring_mp_enqueue_burst(h->free_slots,
+                                               cached_free_slots->objs,
+                                               LCORE_CACHE_SIZE, NULL);
+                       cached_free_slots->len -= n_slots;
+               }
+               /* Put index of new free slot in cache. */
+               cached_free_slots->objs[cached_free_slots->len] =
+                                       (void *)((uintptr_t)position);
+               cached_free_slots->len++;
+       } else {
+               rte_ring_sp_enqueue(h->free_slots,
+                               (void *)((uintptr_t)position));
+       }
+
+       return 0;
+}
+
 static inline void
 compare_signatures(uint32_t *prim_hash_matches, uint32_t *sec_hash_matches,
                        const struct rte_hash_bucket *prim_bkt,
@@ -1333,7 +1603,7 @@ compare_signatures(uint32_t *prim_hash_matches, uint32_t *sec_hash_matches,
 
 #define PREFETCH_OFFSET 4
 static inline void
-__rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
+__rte_hash_lookup_bulk_l(const struct rte_hash *h, const void **keys,
                        int32_t num_keys, int32_t *positions,
                        uint64_t *hit_mask, void *data[])
 {
@@ -1390,16 +1660,19 @@ __rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
        }
 
        __hash_rw_reader_lock(h);
+
        /* Compare signatures and prefetch key slot of first hit */
        for (i = 0; i < num_keys; i++) {
                compare_signatures(&prim_hitmask[i], &sec_hitmask[i],
-                               primary_bkt[i], secondary_bkt[i],
-                               sig[i], h->sig_cmp_fn);
+                       primary_bkt[i], secondary_bkt[i],
+                       sig[i], h->sig_cmp_fn);
 
                if (prim_hitmask[i]) {
                        uint32_t first_hit =
-                                       __builtin_ctzl(prim_hitmask[i]) >> 1;
-                       uint32_t key_idx = primary_bkt[i]->key_idx[first_hit];
+                                       __builtin_ctzl(prim_hitmask[i])
+                                       >> 1;
+                       uint32_t key_idx =
+                               primary_bkt[i]->key_idx[first_hit];
                        const struct rte_hash_key *key_slot =
                                (const struct rte_hash_key *)(
                                (const char *)h->key_store +
@@ -1410,8 +1683,10 @@ __rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
 
                if (sec_hitmask[i]) {
                        uint32_t first_hit =
-                                       __builtin_ctzl(sec_hitmask[i]) >> 1;
-                       uint32_t key_idx = secondary_bkt[i]->key_idx[first_hit];
+                                       __builtin_ctzl(sec_hitmask[i])
+                                       >> 1;
+                       uint32_t key_idx =
+                               secondary_bkt[i]->key_idx[first_hit];
                        const struct rte_hash_key *key_slot =
                                (const struct rte_hash_key *)(
                                (const char *)h->key_store +
@@ -1425,18 +1700,22 @@ __rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
                positions[i] = -ENOENT;
                while (prim_hitmask[i]) {
                        uint32_t hit_index =
-                                       __builtin_ctzl(prim_hitmask[i]) >> 1;
-
-                       uint32_t key_idx = primary_bkt[i]->key_idx[hit_index];
+                                       __builtin_ctzl(prim_hitmask[i])
+                                       >> 1;
+                       uint32_t key_idx =
+                               primary_bkt[i]->key_idx[hit_index];
                        const struct rte_hash_key *key_slot =
                                (const struct rte_hash_key *)(
                                (const char *)h->key_store +
                                key_idx * h->key_entry_size);
+
                        /*
                         * If key index is 0, do not compare key,
                         * as it is checking the dummy slot
                         */
-                       if (!!key_idx & !rte_hash_cmp_eq(key_slot->key, keys[i], h)) {
+                       if (!!key_idx &
+                               !rte_hash_cmp_eq(
+                                       key_slot->key, keys[i], h)) {
                                if (data != NULL)
                                        data[i] = key_slot->pdata;
 
@@ -1449,19 +1728,23 @@ __rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
 
                while (sec_hitmask[i]) {
                        uint32_t hit_index =
-                                       __builtin_ctzl(sec_hitmask[i]) >> 1;
-
-                       uint32_t key_idx = secondary_bkt[i]->key_idx[hit_index];
+                                       __builtin_ctzl(sec_hitmask[i])
+                                       >> 1;
+                       uint32_t key_idx =
+                               secondary_bkt[i]->key_idx[hit_index];
                        const struct rte_hash_key *key_slot =
                                (const struct rte_hash_key *)(
                                (const char *)h->key_store +
                                key_idx * h->key_entry_size);
+
                        /*
                         * If key index is 0, do not compare key,
                         * as it is checking the dummy slot
                         */
 
-                       if (!!key_idx & !rte_hash_cmp_eq(key_slot->key, keys[i], h)) {
+                       if (!!key_idx &
+                               !rte_hash_cmp_eq(
+                                       key_slot->key, keys[i], h)) {
                                if (data != NULL)
                                        data[i] = key_slot->pdata;
 
@@ -1471,7 +1754,6 @@ __rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
                        }
                        sec_hitmask[i] &= ~(3ULL << (hit_index << 1));
                }
-
 next_key:
                continue;
        }
@@ -1491,10 +1773,10 @@ next_key:
                next_bkt = secondary_bkt[i]->next;
                FOR_EACH_BUCKET(cur_bkt, next_bkt) {
                        if (data != NULL)
-                               ret = search_one_bucket(h, keys[i],
+                               ret = search_one_bucket_l(h, keys[i],
                                                sig[i], &data[i], cur_bkt);
                        else
-                               ret = search_one_bucket(h, keys[i],
+                               ret = search_one_bucket_l(h, keys[i],
                                                sig[i], NULL, cur_bkt);
                        if (ret != -1) {
                                positions[i] = ret;
@@ -1510,6 +1792,243 @@ next_key:
                *hit_mask = hits;
 }
 
+static inline void
+__rte_hash_lookup_bulk_lf(const struct rte_hash *h, const void **keys,
+                       int32_t num_keys, int32_t *positions,
+                       uint64_t *hit_mask, void *data[])
+{
+       uint64_t hits = 0;
+       int32_t i;
+       int32_t ret;
+       uint32_t prim_hash[RTE_HASH_LOOKUP_BULK_MAX];
+       uint32_t prim_index[RTE_HASH_LOOKUP_BULK_MAX];
+       uint32_t sec_index[RTE_HASH_LOOKUP_BULK_MAX];
+       uint16_t sig[RTE_HASH_LOOKUP_BULK_MAX];
+       const struct rte_hash_bucket *primary_bkt[RTE_HASH_LOOKUP_BULK_MAX];
+       const struct rte_hash_bucket *secondary_bkt[RTE_HASH_LOOKUP_BULK_MAX];
+       uint32_t prim_hitmask[RTE_HASH_LOOKUP_BULK_MAX] = {0};
+       uint32_t sec_hitmask[RTE_HASH_LOOKUP_BULK_MAX] = {0};
+       struct rte_hash_bucket *cur_bkt, *next_bkt;
+       void *pdata[RTE_HASH_LOOKUP_BULK_MAX];
+       uint32_t cnt_b, cnt_a;
+
+       /* Prefetch first keys */
+       for (i = 0; i < PREFETCH_OFFSET && i < num_keys; i++)
+               rte_prefetch0(keys[i]);
+
+       /*
+        * Prefetch rest of the keys, calculate primary and
+        * secondary bucket and prefetch them
+        */
+       for (i = 0; i < (num_keys - PREFETCH_OFFSET); i++) {
+               rte_prefetch0(keys[i + PREFETCH_OFFSET]);
+
+               prim_hash[i] = rte_hash_hash(h, keys[i]);
+
+               sig[i] = get_short_sig(prim_hash[i]);
+               prim_index[i] = get_prim_bucket_index(h, prim_hash[i]);
+               sec_index[i] = get_alt_bucket_index(h, prim_index[i], sig[i]);
+
+               primary_bkt[i] = &h->buckets[prim_index[i]];
+               secondary_bkt[i] = &h->buckets[sec_index[i]];
+
+               rte_prefetch0(primary_bkt[i]);
+               rte_prefetch0(secondary_bkt[i]);
+       }
+
+       /* Calculate and prefetch rest of the buckets */
+       for (; i < num_keys; i++) {
+               prim_hash[i] = rte_hash_hash(h, keys[i]);
+
+               sig[i] = get_short_sig(prim_hash[i]);
+               prim_index[i] = get_prim_bucket_index(h, prim_hash[i]);
+               sec_index[i] = get_alt_bucket_index(h, prim_index[i], sig[i]);
+
+               primary_bkt[i] = &h->buckets[prim_index[i]];
+               secondary_bkt[i] = &h->buckets[sec_index[i]];
+
+               rte_prefetch0(primary_bkt[i]);
+               rte_prefetch0(secondary_bkt[i]);
+       }
+
+       do {
+               /* Load the table change counter before the lookup
+                * starts. Acquire semantics will make sure that
+                * loads in compare_signatures are not hoisted.
+                */
+               cnt_b = __atomic_load_n(h->tbl_chng_cnt,
+                                       __ATOMIC_ACQUIRE);
+
+               /* Compare signatures and prefetch key slot of first hit */
+               for (i = 0; i < num_keys; i++) {
+                       compare_signatures(&prim_hitmask[i], &sec_hitmask[i],
+                               primary_bkt[i], secondary_bkt[i],
+                               sig[i], h->sig_cmp_fn);
+
+                       if (prim_hitmask[i]) {
+                               uint32_t first_hit =
+                                               __builtin_ctzl(prim_hitmask[i])
+                                               >> 1;
+                               uint32_t key_idx =
+                                       primary_bkt[i]->key_idx[first_hit];
+                               const struct rte_hash_key *key_slot =
+                                       (const struct rte_hash_key *)(
+                                       (const char *)h->key_store +
+                                       key_idx * h->key_entry_size);
+                               rte_prefetch0(key_slot);
+                               continue;
+                       }
+
+                       if (sec_hitmask[i]) {
+                               uint32_t first_hit =
+                                               __builtin_ctzl(sec_hitmask[i])
+                                               >> 1;
+                               uint32_t key_idx =
+                                       secondary_bkt[i]->key_idx[first_hit];
+                               const struct rte_hash_key *key_slot =
+                                       (const struct rte_hash_key *)(
+                                       (const char *)h->key_store +
+                                       key_idx * h->key_entry_size);
+                               rte_prefetch0(key_slot);
+                       }
+               }
+
+               /* Compare keys, first hits in primary first */
+               for (i = 0; i < num_keys; i++) {
+                       positions[i] = -ENOENT;
+                       while (prim_hitmask[i]) {
+                               uint32_t hit_index =
+                                               __builtin_ctzl(prim_hitmask[i])
+                                               >> 1;
+                               uint32_t key_idx =
+                               __atomic_load_n(
+                                       &primary_bkt[i]->key_idx[hit_index],
+                                       __ATOMIC_ACQUIRE);
+                               const struct rte_hash_key *key_slot =
+                                       (const struct rte_hash_key *)(
+                                       (const char *)h->key_store +
+                                       key_idx * h->key_entry_size);
+
+                               if (key_idx != EMPTY_SLOT)
+                                       pdata[i] = __atomic_load_n(
+                                                       &key_slot->pdata,
+                                                       __ATOMIC_ACQUIRE);
+                               /*
+                                * If key index is 0, do not compare key,
+                                * as it is checking the dummy slot
+                                */
+                               if (!!key_idx &
+                                       !rte_hash_cmp_eq(
+                                               key_slot->key, keys[i], h)) {
+                                       if (data != NULL)
+                                               data[i] = pdata[i];
+
+                                       hits |= 1ULL << i;
+                                       positions[i] = key_idx - 1;
+                                       goto next_key;
+                               }
+                               prim_hitmask[i] &= ~(3ULL << (hit_index << 1));
+                       }
+
+                       while (sec_hitmask[i]) {
+                               uint32_t hit_index =
+                                               __builtin_ctzl(sec_hitmask[i])
+                                               >> 1;
+                               uint32_t key_idx =
+                               __atomic_load_n(
+                                       &secondary_bkt[i]->key_idx[hit_index],
+                                       __ATOMIC_ACQUIRE);
+                               const struct rte_hash_key *key_slot =
+                                       (const struct rte_hash_key *)(
+                                       (const char *)h->key_store +
+                                       key_idx * h->key_entry_size);
+
+                               if (key_idx != EMPTY_SLOT)
+                                       pdata[i] = __atomic_load_n(
+                                                       &key_slot->pdata,
+                                                       __ATOMIC_ACQUIRE);
+                               /*
+                                * If key index is 0, do not compare key,
+                                * as it is checking the dummy slot
+                                */
+
+                               if (!!key_idx &
+                                       !rte_hash_cmp_eq(
+                                               key_slot->key, keys[i], h)) {
+                                       if (data != NULL)
+                                               data[i] = pdata[i];
+
+                                       hits |= 1ULL << i;
+                                       positions[i] = key_idx - 1;
+                                       goto next_key;
+                               }
+                               sec_hitmask[i] &= ~(3ULL << (hit_index << 1));
+                       }
+next_key:
+                       continue;
+               }
+
+               /* The loads of sig_current in compare_signatures
+                * should not move below the load from tbl_chng_cnt.
+                */
+               __atomic_thread_fence(__ATOMIC_ACQUIRE);
+               /* Re-read the table change counter to check if the
+                * table has changed during search. If yes, re-do
+                * the search.
+                * This load should not get hoisted. The load
+                * acquires on cnt_b, primary key index and secondary
+                * key index will make sure that it does not get
+                * hoisted.
+                */
+               cnt_a = __atomic_load_n(h->tbl_chng_cnt,
+                                       __ATOMIC_ACQUIRE);
+       } while (cnt_b != cnt_a);
+
+       /* all found, do not need to go through ext bkt */
+       if ((hits == ((1ULL << num_keys) - 1)) || !h->ext_table_support) {
+               if (hit_mask != NULL)
+                       *hit_mask = hits;
+               __hash_rw_reader_unlock(h);
+               return;
+       }
+
+       /* need to check ext buckets for match */
+       for (i = 0; i < num_keys; i++) {
+               if ((hits & (1ULL << i)) != 0)
+                       continue;
+               next_bkt = secondary_bkt[i]->next;
+               FOR_EACH_BUCKET(cur_bkt, next_bkt) {
+                       if (data != NULL)
+                               ret = search_one_bucket_lf(h, keys[i],
+                                               sig[i], &data[i], cur_bkt);
+                       else
+                               ret = search_one_bucket_lf(h, keys[i],
+                                               sig[i], NULL, cur_bkt);
+                       if (ret != -1) {
+                               positions[i] = ret;
+                               hits |= 1ULL << i;
+                               break;
+                       }
+               }
+       }
+
+       if (hit_mask != NULL)
+               *hit_mask = hits;
+}
+
+static inline void
+__rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
+                       int32_t num_keys, int32_t *positions,
+                       uint64_t *hit_mask, void *data[])
+{
+       if (h->readwrite_concur_lf_support)
+               __rte_hash_lookup_bulk_lf(h, keys, num_keys, positions,
+                                         hit_mask, data);
+       else
+               __rte_hash_lookup_bulk_l(h, keys, num_keys, positions,
+                                        hit_mask, data);
+}
+
 int
 rte_hash_lookup_bulk(const struct rte_hash *h, const void **keys,
                      uint32_t num_keys, int32_t *positions)
@@ -1559,7 +2078,8 @@ rte_hash_iterate(const struct rte_hash *h, const void **key, void **data, uint32
        idx = *next % RTE_HASH_BUCKET_ENTRIES;
 
        /* If current position is empty, go to the next one */
-       while ((position = h->buckets[bucket_idx].key_idx[idx]) == EMPTY_SLOT) {
+       while ((position = __atomic_load_n(&h->buckets[bucket_idx].key_idx[idx],
+                                       __ATOMIC_ACQUIRE)) == EMPTY_SLOT) {
                (*next)++;
                /* End of table */
                if (*next == total_entries_main)