vppinfra: bihash improvements
[vpp.git] / src / vppinfra / bihash_vec8_8.h
1 /*
2  * Copyright (c) 2017 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 #undef BIHASH_TYPE
16 #undef BIHASH_KVP_PER_PAGE
17 #undef BIHASH_32_64_SVM
18 #undef BIHASH_ENABLE_STATS
19 #undef BIHASH_KVP_AT_BUCKET_LEVEL
20 #undef BIHASH_LAZY_INSTANTIATE
21 #undef BIHASH_BUCKET_PREFETCH_CACHE_LINES
22
23 #define BIHASH_TYPE _vec8_8
24 #define BIHASH_KVP_PER_PAGE 4
25 #define BIHASH_KVP_AT_BUCKET_LEVEL 0
26 #define BIHASH_LAZY_INSTANTIATE 1
27 #define BIHASH_BUCKET_PREFETCH_CACHE_LINES 1
28
29 #ifndef __included_bihash_vec8_8_h__
30 #define __included_bihash_vec8_8_h__
31
32 #include <vppinfra/heap.h>
33 #include <vppinfra/format.h>
34 #include <vppinfra/pool.h>
35 #include <vppinfra/xxhash.h>
36 #include <vppinfra/crc32.h>
37
38 /** 8 octet key, 8 octet key value pair */
39 typedef struct
40 {
41   u64 key;                      /**< the key */
42   u64 value;                    /**< the value */
43 } clib_bihash_kv_vec8_8_t;
44
45 /** Decide if a clib_bihash_kv_vec8_8_t instance is free
46     @param v- pointer to the (key,value) pair
47 */
48 static inline int
49 clib_bihash_is_free_vec8_8 (clib_bihash_kv_vec8_8_t * v)
50 {
51   if (v->key == ~0ULL && v->value == ~0ULL)
52     return 1;
53   return 0;
54 }
55
56 /** Hash a clib_bihash_kv_vec8_8_t instance
57     @param v - pointer to the (key,value) pair, hash the key (only)
58 */
59 static inline u64
60 clib_bihash_hash_vec8_8 (clib_bihash_kv_vec8_8_t * v)
61 {
62   u8 *keyp = (u8 *) (v->key);
63   /* Note: to torture-test linear scan, make this fn return a constant */
64 #ifdef clib_crc32c_uses_intrinsics
65   return clib_crc32c (keyp, vec_len (keyp));
66 #else
67   {
68     int i, j;
69     u64 sum = 0;
70
71     for (i = 0, j = 0; i < vec_len (keyp); i++)
72       {
73         sum ^= keyp[i] << (j * 8);
74         j++;
75         if (j == 4)
76           j = 0;
77       }
78
79     return clib_xxhash (sum);
80   }
81 #endif
82 }
83
84 /** Format a clib_bihash_kv_vec8_8_t instance
85     @param s - u8 * vector under construction
86     @param args (vararg) - the (key,value) pair to format
87     @return s - the u8 * vector under construction
88 */
89 static inline u8 *
90 format_bihash_kvp_vec8_8 (u8 * s, va_list * args)
91 {
92   clib_bihash_kv_vec8_8_t *v = va_arg (*args, clib_bihash_kv_vec8_8_t *);
93
94   s = format (s, "key %U value %llu",
95               format_hex_bytes, v->key, vec_len ((u8 *) (v->key)), v->value);
96   return s;
97 }
98
99 /** Compare two clib_bihash_kv_vec8_8_t instances
100     @param a - first key
101     @param b - second key
102 */
103 static inline int
104 clib_bihash_key_compare_vec8_8 (u64 a_arg, u64 b_arg)
105 {
106   u8 *a = (u8 *) a_arg;
107   u8 *b = (u8 *) b_arg;
108
109   if (a_arg == ~0ULL || b_arg == ~0ULL)
110     return 0;
111
112   if (vec_len (a) != vec_len (b))
113     return 0;
114
115   return memcmp (a, b, vec_len (a)) == 0;
116 }
117
118 #undef __included_bihash_template_h__
119 #include <vppinfra/bihash_template.h>
120
121 #endif /* __included_bihash_vec8_8_h__ */
122
123 /*
124  * fd.io coding-style-patch-verification: ON
125  *
126  * Local Variables:
127  * eval: (c-set-style "gnu")
128  * End:
129  */