Coverage Report

Created: 2026-02-21 06:33

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/frr/lib/jhash.c
Line
Count
Source
1
/* jhash.h: Jenkins hash support.
2
 *
3
 * Copyright (C) 1996 Bob Jenkins (bob_jenkins@burtleburtle.net)
4
 *
5
 * http://burtleburtle.net/bob/hash/
6
 *
7
 * These are the credits from Bob's sources:
8
 *
9
 * lookup2.c, by Bob Jenkins, December 1996, Public Domain.
10
 * hash(), hash2(), hash3, and mix() are externally useful functions.
11
 * Routines to test the hash are included if SELF_TEST is defined.
12
 * You can use this free for any purpose.  It has no warranty.
13
 *
14
 * Copyright (C) 2003 David S. Miller (davem@redhat.com)
15
 *
16
 * I've modified Bob's hash to be useful in the Linux kernel, and
17
 * any bugs present are surely my fault.  -DaveM
18
 */
19
20
#include "zebra.h"
21
#include "jhash.h"
22
23
/* The golden ration: an arbitrary value */
24
1.71M
#define JHASH_GOLDEN_RATIO  0x9e3779b9
25
26
/* NOTE: Arguments are modified. */
27
#define __jhash_mix(a, b, c)                                                   \
28
1.39M
  {                                                                      \
29
1.39M
    a -= b;                                                        \
30
1.39M
    a -= c;                                                        \
31
1.39M
    a ^= (c >> 13);                                                \
32
1.39M
    b -= c;                                                        \
33
1.39M
    b -= a;                                                        \
34
1.39M
    b ^= (a << 8);                                                 \
35
1.39M
    c -= a;                                                        \
36
1.39M
    c -= b;                                                        \
37
1.39M
    c ^= (b >> 13);                                                \
38
1.39M
    a -= b;                                                        \
39
1.39M
    a -= c;                                                        \
40
1.39M
    a ^= (c >> 12);                                                \
41
1.39M
    b -= c;                                                        \
42
1.39M
    b -= a;                                                        \
43
1.39M
    b ^= (a << 16);                                                \
44
1.39M
    c -= a;                                                        \
45
1.39M
    c -= b;                                                        \
46
1.39M
    c ^= (b >> 5);                                                 \
47
1.39M
    a -= b;                                                        \
48
1.39M
    a -= c;                                                        \
49
1.39M
    a ^= (c >> 3);                                                 \
50
1.39M
    b -= c;                                                        \
51
1.39M
    b -= a;                                                        \
52
1.39M
    b ^= (a << 10);                                                \
53
1.39M
    c -= a;                                                        \
54
1.39M
    c -= b;                                                        \
55
1.39M
    c ^= (b >> 15);                                                \
56
1.39M
  }
57
58
/* The most generic version, hashes an arbitrary sequence
59
 * of bytes.  No alignment or length assumptions are made about
60
 * the input key.
61
 */
62
uint32_t jhash(const void *key, uint32_t length, uint32_t initval)
63
  __attribute__((no_sanitize("unsigned-integer-overflow")))
64
614k
{
65
614k
  uint32_t a, b, c, len;
66
614k
  const uint8_t *k = key;
67
68
614k
  len = length;
69
614k
  a = b = JHASH_GOLDEN_RATIO;
70
614k
  c = initval;
71
72
711k
  while (len >= 12) {
73
96.1k
    a += (k[0] + ((uint32_t)k[1] << 8) + ((uint32_t)k[2] << 16)
74
96.1k
          + ((uint32_t)k[3] << 24));
75
96.1k
    b += (k[4] + ((uint32_t)k[5] << 8) + ((uint32_t)k[6] << 16)
76
96.1k
          + ((uint32_t)k[7] << 24));
77
96.1k
    c += (k[8] + ((uint32_t)k[9] << 8) + ((uint32_t)k[10] << 16)
78
96.1k
          + ((uint32_t)k[11] << 24));
79
80
96.1k
    __jhash_mix(a, b, c);
81
82
96.1k
    k += 12;
83
96.1k
    len -= 12;
84
96.1k
  }
85
86
614k
  c += length;
87
614k
  switch (len) {
88
70.2k
  case 11:
89
70.2k
    c += ((uint32_t)k[10] << 24);
90
  /* fallthru */
91
79.5k
  case 10:
92
79.5k
    c += ((uint32_t)k[9] << 16);
93
  /* fallthru */
94
496k
  case 9:
95
496k
    c += ((uint32_t)k[8] << 8);
96
  /* fallthru */
97
541k
  case 8:
98
541k
    b += ((uint32_t)k[7] << 24);
99
  /* fallthru */
100
541k
  case 7:
101
541k
    b += ((uint32_t)k[6] << 16);
102
  /* fallthru */
103
542k
  case 6:
104
542k
    b += ((uint32_t)k[5] << 8);
105
  /* fallthru */
106
542k
  case 5:
107
542k
    b += k[4];
108
  /* fallthru */
109
592k
  case 4:
110
592k
    a += ((uint32_t)k[3] << 24);
111
  /* fallthru */
112
594k
  case 3:
113
594k
    a += ((uint32_t)k[2] << 16);
114
  /* fallthru */
115
595k
  case 2:
116
595k
    a += ((uint32_t)k[1] << 8);
117
  /* fallthru */
118
596k
  case 1:
119
596k
    a += k[0];
120
614k
  }
121
122
614k
  __jhash_mix(a, b, c);
123
124
614k
  return c;
125
614k
}
126
127
/* A special optimized version that handles 1 or more of uint32_ts.
128
 * The length parameter here is the number of uint32_ts in the key.
129
 */
130
uint32_t jhash2(const uint32_t *k, uint32_t length, uint32_t initval)
131
  __attribute__((no_sanitize("unsigned-integer-overflow")))
132
232k
{
133
232k
  uint32_t a, b, c, len;
134
135
232k
  a = b = JHASH_GOLDEN_RATIO;
136
232k
  c = initval;
137
232k
  len = length;
138
139
244k
  while (len >= 3) {
140
12.0k
    a += k[0];
141
12.0k
    b += k[1];
142
12.0k
    c += k[2];
143
12.0k
    __jhash_mix(a, b, c);
144
12.0k
    k += 3;
145
12.0k
    len -= 3;
146
12.0k
  }
147
148
232k
  c += length * 4;
149
150
232k
  switch (len) {
151
232k
  case 2:
152
232k
    b += k[1];
153
  /* fallthru */
154
232k
  case 1:
155
232k
    a += k[0];
156
232k
  }
157
158
232k
  __jhash_mix(a, b, c);
159
160
232k
  return c;
161
232k
}
162
163
164
/* A special ultra-optimized versions that knows they are hashing exactly
165
 * 3, 2 or 1 word(s).
166
 *
167
 * NOTE: In partilar the "c += length; __jhash_mix(a,b,c);" normally
168
 *       done at the end is not done here.
169
 */
170
uint32_t jhash_3words(uint32_t a, uint32_t b, uint32_t c, uint32_t initval)
171
  __attribute__((no_sanitize("unsigned-integer-overflow")))
172
435k
{
173
435k
  a += JHASH_GOLDEN_RATIO;
174
435k
  b += JHASH_GOLDEN_RATIO;
175
435k
  c += initval;
176
177
435k
  __jhash_mix(a, b, c);
178
179
435k
  return c;
180
435k
}
181
182
uint32_t jhash_2words(uint32_t a, uint32_t b, uint32_t initval)
183
18.5k
{
184
18.5k
  return jhash_3words(a, b, 0, initval);
185
18.5k
}
186
187
uint32_t jhash_1word(uint32_t a, uint32_t initval)
188
406k
{
189
406k
  return jhash_3words(a, 0, 0, initval);
190
406k
}