1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun * Bloom filter support
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * Portions of this code are copyright (c) 2021 Cypress Semiconductor Corporation
5*4882a593Smuzhiyun *
6*4882a593Smuzhiyun * Copyright (C) 1999-2017, Broadcom Corporation
7*4882a593Smuzhiyun *
8*4882a593Smuzhiyun * Unless you and Broadcom execute a separate written software license
9*4882a593Smuzhiyun * agreement governing use of this software, this software is licensed to you
10*4882a593Smuzhiyun * under the terms of the GNU General Public License version 2 (the "GPL"),
11*4882a593Smuzhiyun * available at http://www.broadcom.com/licenses/GPLv2.php, with the
12*4882a593Smuzhiyun * following added to such license:
13*4882a593Smuzhiyun *
14*4882a593Smuzhiyun * As a special exception, the copyright holders of this software give you
15*4882a593Smuzhiyun * permission to link this software with independent modules, and to copy and
16*4882a593Smuzhiyun * distribute the resulting executable under terms of your choice, provided that
17*4882a593Smuzhiyun * you also meet, for each linked independent module, the terms and conditions of
18*4882a593Smuzhiyun * the license of that module. An independent module is a module which is not
19*4882a593Smuzhiyun * derived from this software. The special exception does not apply to any
20*4882a593Smuzhiyun * modifications of the software.
21*4882a593Smuzhiyun *
22*4882a593Smuzhiyun * Notwithstanding the above, under no circumstances may you combine this
23*4882a593Smuzhiyun * software in any way with any other Broadcom software provided under a license
24*4882a593Smuzhiyun * other than the GPL, without Broadcom's express prior written consent.
25*4882a593Smuzhiyun *
26*4882a593Smuzhiyun *
27*4882a593Smuzhiyun * <<Broadcom-WL-IPTag/Open:>>
28*4882a593Smuzhiyun *
29*4882a593Smuzhiyun * $Id$
30*4882a593Smuzhiyun */
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun #include <typedefs.h>
33*4882a593Smuzhiyun #include <bcmdefs.h>
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun #include <stdarg.h>
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun #ifdef BCMDRIVER
38*4882a593Smuzhiyun #include <osl.h>
39*4882a593Smuzhiyun #include <bcmutils.h>
40*4882a593Smuzhiyun #else /* !BCMDRIVER */
41*4882a593Smuzhiyun #include <stdio.h>
42*4882a593Smuzhiyun #include <string.h>
43*4882a593Smuzhiyun #ifndef ASSERT
44*4882a593Smuzhiyun #define ASSERT(exp)
45*4882a593Smuzhiyun #endif // endif
46*4882a593Smuzhiyun #endif /* !BCMDRIVER */
47*4882a593Smuzhiyun #include <bcmutils.h>
48*4882a593Smuzhiyun
49*4882a593Smuzhiyun #include <bcmbloom.h>
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun #define BLOOM_BIT_LEN(_x) ((_x) << 3)
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun struct bcm_bloom_filter {
54*4882a593Smuzhiyun void *cb_ctx;
55*4882a593Smuzhiyun uint max_hash;
56*4882a593Smuzhiyun bcm_bloom_hash_t *hash; /* array of hash functions */
57*4882a593Smuzhiyun uint filter_size; /* in bytes */
58*4882a593Smuzhiyun uint8 *filter; /* can be NULL for validate only */
59*4882a593Smuzhiyun };
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun /* public interface */
62*4882a593Smuzhiyun int
bcm_bloom_create(bcm_bloom_alloc_t alloc_cb,bcm_bloom_free_t free_cb,void * cb_ctx,uint max_hash,uint filter_size,bcm_bloom_filter_t ** bloom)63*4882a593Smuzhiyun bcm_bloom_create(bcm_bloom_alloc_t alloc_cb,
64*4882a593Smuzhiyun bcm_bloom_free_t free_cb, void *cb_ctx, uint max_hash,
65*4882a593Smuzhiyun uint filter_size, bcm_bloom_filter_t **bloom)
66*4882a593Smuzhiyun {
67*4882a593Smuzhiyun int err = BCME_OK;
68*4882a593Smuzhiyun bcm_bloom_filter_t *bp = NULL;
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun if (!bloom || !alloc_cb || (max_hash == 0)) {
71*4882a593Smuzhiyun err = BCME_BADARG;
72*4882a593Smuzhiyun goto done;
73*4882a593Smuzhiyun }
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun bp = (*alloc_cb)(cb_ctx, sizeof(*bp));
76*4882a593Smuzhiyun if (!bp) {
77*4882a593Smuzhiyun err = BCME_NOMEM;
78*4882a593Smuzhiyun goto done;
79*4882a593Smuzhiyun }
80*4882a593Smuzhiyun
81*4882a593Smuzhiyun memset(bp, 0, sizeof(*bp));
82*4882a593Smuzhiyun bp->cb_ctx = cb_ctx;
83*4882a593Smuzhiyun bp->max_hash = max_hash;
84*4882a593Smuzhiyun bp->hash = (*alloc_cb)(cb_ctx, sizeof(*bp->hash) * max_hash);
85*4882a593Smuzhiyun memset(bp->hash, 0, sizeof(*bp->hash) * max_hash);
86*4882a593Smuzhiyun
87*4882a593Smuzhiyun if (!bp->hash) {
88*4882a593Smuzhiyun err = BCME_NOMEM;
89*4882a593Smuzhiyun goto done;
90*4882a593Smuzhiyun }
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun if (filter_size > 0) {
93*4882a593Smuzhiyun bp->filter = (*alloc_cb)(cb_ctx, filter_size);
94*4882a593Smuzhiyun if (!bp->filter) {
95*4882a593Smuzhiyun err = BCME_NOMEM;
96*4882a593Smuzhiyun goto done;
97*4882a593Smuzhiyun }
98*4882a593Smuzhiyun bp->filter_size = filter_size;
99*4882a593Smuzhiyun memset(bp->filter, 0, filter_size);
100*4882a593Smuzhiyun }
101*4882a593Smuzhiyun
102*4882a593Smuzhiyun *bloom = bp;
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun done:
105*4882a593Smuzhiyun if (err != BCME_OK)
106*4882a593Smuzhiyun bcm_bloom_destroy(&bp, free_cb);
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun return err;
109*4882a593Smuzhiyun }
110*4882a593Smuzhiyun
111*4882a593Smuzhiyun int
bcm_bloom_destroy(bcm_bloom_filter_t ** bloom,bcm_bloom_free_t free_cb)112*4882a593Smuzhiyun bcm_bloom_destroy(bcm_bloom_filter_t **bloom, bcm_bloom_free_t free_cb)
113*4882a593Smuzhiyun {
114*4882a593Smuzhiyun int err = BCME_OK;
115*4882a593Smuzhiyun bcm_bloom_filter_t *bp;
116*4882a593Smuzhiyun
117*4882a593Smuzhiyun if (!bloom || !*bloom || !free_cb)
118*4882a593Smuzhiyun goto done;
119*4882a593Smuzhiyun
120*4882a593Smuzhiyun bp = *bloom;
121*4882a593Smuzhiyun *bloom = NULL;
122*4882a593Smuzhiyun
123*4882a593Smuzhiyun if (bp->filter)
124*4882a593Smuzhiyun (*free_cb)(bp->cb_ctx, bp->filter, bp->filter_size);
125*4882a593Smuzhiyun if (bp->hash)
126*4882a593Smuzhiyun (*free_cb)(bp->cb_ctx, bp->hash,
127*4882a593Smuzhiyun sizeof(*bp->hash) * bp->max_hash);
128*4882a593Smuzhiyun (*free_cb)(bp->cb_ctx, bp, sizeof(*bp));
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun done:
131*4882a593Smuzhiyun return err;
132*4882a593Smuzhiyun }
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun int
bcm_bloom_add_hash(bcm_bloom_filter_t * bp,bcm_bloom_hash_t hash,uint * idx)135*4882a593Smuzhiyun bcm_bloom_add_hash(bcm_bloom_filter_t *bp, bcm_bloom_hash_t hash, uint *idx)
136*4882a593Smuzhiyun {
137*4882a593Smuzhiyun uint i;
138*4882a593Smuzhiyun
139*4882a593Smuzhiyun if (!bp || !hash || !idx)
140*4882a593Smuzhiyun return BCME_BADARG;
141*4882a593Smuzhiyun
142*4882a593Smuzhiyun for (i = 0; i < bp->max_hash; ++i) {
143*4882a593Smuzhiyun if (bp->hash[i] == NULL)
144*4882a593Smuzhiyun break;
145*4882a593Smuzhiyun }
146*4882a593Smuzhiyun
147*4882a593Smuzhiyun if (i >= bp->max_hash)
148*4882a593Smuzhiyun return BCME_NORESOURCE;
149*4882a593Smuzhiyun
150*4882a593Smuzhiyun bp->hash[i] = hash;
151*4882a593Smuzhiyun *idx = i;
152*4882a593Smuzhiyun return BCME_OK;
153*4882a593Smuzhiyun }
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun int
bcm_bloom_remove_hash(bcm_bloom_filter_t * bp,uint idx)156*4882a593Smuzhiyun bcm_bloom_remove_hash(bcm_bloom_filter_t *bp, uint idx)
157*4882a593Smuzhiyun {
158*4882a593Smuzhiyun if (!bp)
159*4882a593Smuzhiyun return BCME_BADARG;
160*4882a593Smuzhiyun
161*4882a593Smuzhiyun if (idx >= bp->max_hash)
162*4882a593Smuzhiyun return BCME_NOTFOUND;
163*4882a593Smuzhiyun
164*4882a593Smuzhiyun bp->hash[idx] = NULL;
165*4882a593Smuzhiyun return BCME_OK;
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun bool
bcm_bloom_is_member(bcm_bloom_filter_t * bp,const uint8 * tag,uint tag_len,const uint8 * buf,uint buf_len)169*4882a593Smuzhiyun bcm_bloom_is_member(bcm_bloom_filter_t *bp,
170*4882a593Smuzhiyun const uint8 *tag, uint tag_len, const uint8 *buf, uint buf_len)
171*4882a593Smuzhiyun {
172*4882a593Smuzhiyun uint i;
173*4882a593Smuzhiyun int err = BCME_OK;
174*4882a593Smuzhiyun
175*4882a593Smuzhiyun if (!tag || (tag_len == 0)) /* empty tag is always a member */
176*4882a593Smuzhiyun goto done;
177*4882a593Smuzhiyun
178*4882a593Smuzhiyun /* use internal buffer if none was specified */
179*4882a593Smuzhiyun if (!buf || (buf_len == 0)) {
180*4882a593Smuzhiyun if (!bp->filter) /* every one is a member of empty filter */
181*4882a593Smuzhiyun goto done;
182*4882a593Smuzhiyun
183*4882a593Smuzhiyun buf = bp->filter;
184*4882a593Smuzhiyun buf_len = bp->filter_size;
185*4882a593Smuzhiyun }
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun for (i = 0; i < bp->max_hash; ++i) {
188*4882a593Smuzhiyun uint pos;
189*4882a593Smuzhiyun if (!bp->hash[i])
190*4882a593Smuzhiyun continue;
191*4882a593Smuzhiyun pos = (*bp->hash[i])(bp->cb_ctx, i, tag, tag_len);
192*4882a593Smuzhiyun
193*4882a593Smuzhiyun /* all bits must be set for a match */
194*4882a593Smuzhiyun CLANG_DIAGNOSTIC_PUSH_SUPPRESS_CAST()
195*4882a593Smuzhiyun if (isclr(buf, pos % BLOOM_BIT_LEN(buf_len))) {
196*4882a593Smuzhiyun CLANG_DIAGNOSTIC_POP()
197*4882a593Smuzhiyun err = BCME_NOTFOUND;
198*4882a593Smuzhiyun break;
199*4882a593Smuzhiyun }
200*4882a593Smuzhiyun }
201*4882a593Smuzhiyun
202*4882a593Smuzhiyun done:
203*4882a593Smuzhiyun return err;
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun int
bcm_bloom_add_member(bcm_bloom_filter_t * bp,const uint8 * tag,uint tag_len)207*4882a593Smuzhiyun bcm_bloom_add_member(bcm_bloom_filter_t *bp, const uint8 *tag, uint tag_len)
208*4882a593Smuzhiyun {
209*4882a593Smuzhiyun uint i;
210*4882a593Smuzhiyun
211*4882a593Smuzhiyun if (!bp || !tag || (tag_len == 0))
212*4882a593Smuzhiyun return BCME_BADARG;
213*4882a593Smuzhiyun
214*4882a593Smuzhiyun if (!bp->filter) /* validate only */
215*4882a593Smuzhiyun return BCME_UNSUPPORTED;
216*4882a593Smuzhiyun
217*4882a593Smuzhiyun for (i = 0; i < bp->max_hash; ++i) {
218*4882a593Smuzhiyun uint pos;
219*4882a593Smuzhiyun if (!bp->hash[i])
220*4882a593Smuzhiyun continue;
221*4882a593Smuzhiyun pos = (*bp->hash[i])(bp->cb_ctx, i, tag, tag_len);
222*4882a593Smuzhiyun setbit(bp->filter, pos % BLOOM_BIT_LEN(bp->filter_size));
223*4882a593Smuzhiyun }
224*4882a593Smuzhiyun
225*4882a593Smuzhiyun return BCME_OK;
226*4882a593Smuzhiyun }
227*4882a593Smuzhiyun
bcm_bloom_get_filter_data(bcm_bloom_filter_t * bp,uint buf_size,uint8 * buf,uint * buf_len)228*4882a593Smuzhiyun int bcm_bloom_get_filter_data(bcm_bloom_filter_t *bp,
229*4882a593Smuzhiyun uint buf_size, uint8 *buf, uint *buf_len)
230*4882a593Smuzhiyun {
231*4882a593Smuzhiyun if (!bp)
232*4882a593Smuzhiyun return BCME_BADARG;
233*4882a593Smuzhiyun
234*4882a593Smuzhiyun if (buf_len)
235*4882a593Smuzhiyun *buf_len = bp->filter_size;
236*4882a593Smuzhiyun
237*4882a593Smuzhiyun if (buf_size < bp->filter_size)
238*4882a593Smuzhiyun return BCME_BUFTOOSHORT;
239*4882a593Smuzhiyun
240*4882a593Smuzhiyun if (bp->filter && bp->filter_size)
241*4882a593Smuzhiyun memcpy(buf, bp->filter, bp->filter_size);
242*4882a593Smuzhiyun
243*4882a593Smuzhiyun return BCME_OK;
244*4882a593Smuzhiyun }
245