Coverage Report

Created: 2025-08-28 07:07

/src/openssl30/crypto/siphash/siphash.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2017-2022 The OpenSSL Project Authors. All Rights Reserved.
3
 *
4
 * Licensed under the Apache License 2.0 (the "License").  You may not use
5
 * this file except in compliance with the License.  You can obtain a copy
6
 * in the file LICENSE in the source distribution or at
7
 * https://www.openssl.org/source/license.html
8
 */
9
10
/* Based on https://131002.net/siphash C reference implementation */
11
/*
12
   SipHash reference C implementation
13
14
   Copyright (c) 2012-2016 Jean-Philippe Aumasson
15
   Copyright (c) 2012-2014 Daniel J. Bernstein
16
17
   To the extent possible under law, the author(s) have dedicated all copyright
18
   and related and neighboring rights to this software to the public domain
19
   worldwide. This software is distributed without any warranty.
20
21
   You should have received a copy of the CC0 Public Domain Dedication along
22
   with this software. If not, see
23
   <http://creativecommons.org/publicdomain/zero/1.0/>.
24
 */
25
26
#include <stdlib.h>
27
#include <string.h>
28
#include <openssl/crypto.h>
29
30
#include "crypto/siphash.h"
31
32
261M
#define ROTL(x, b) (uint64_t)(((x) << (b)) | ((x) >> (64 - (b))))
33
34
#define U32TO8_LE(p, v)                                                        \
35
12.8M
    (p)[0] = (uint8_t)((v));                                                   \
36
12.8M
    (p)[1] = (uint8_t)((v) >> 8);                                              \
37
12.8M
    (p)[2] = (uint8_t)((v) >> 16);                                             \
38
12.8M
    (p)[3] = (uint8_t)((v) >> 24);
39
40
#define U64TO8_LE(p, v)                                                        \
41
6.41M
    U32TO8_LE((p), (uint32_t)((v)));                                           \
42
6.41M
    U32TO8_LE((p) + 4, (uint32_t)((v) >> 32));
43
44
#define U8TO64_LE(p)                                                           \
45
15.3M
    (((uint64_t)((p)[0])) | ((uint64_t)((p)[1]) << 8) |                        \
46
15.3M
     ((uint64_t)((p)[2]) << 16) | ((uint64_t)((p)[3]) << 24) |                 \
47
15.3M
     ((uint64_t)((p)[4]) << 32) | ((uint64_t)((p)[5]) << 40) |                 \
48
15.3M
     ((uint64_t)((p)[6]) << 48) | ((uint64_t)((p)[7]) << 56))
49
50
#define SIPROUND                                                               \
51
56.4M
    do {                                                                       \
52
43.6M
        v0 += v1;                                                              \
53
43.6M
        v1 = ROTL(v1, 13);                                                     \
54
43.6M
        v1 ^= v0;                                                              \
55
43.6M
        v0 = ROTL(v0, 32);                                                     \
56
43.6M
        v2 += v3;                                                              \
57
43.6M
        v3 = ROTL(v3, 16);                                                     \
58
43.6M
        v3 ^= v2;                                                              \
59
43.6M
        v0 += v3;                                                              \
60
43.6M
        v3 = ROTL(v3, 21);                                                     \
61
43.6M
        v3 ^= v0;                                                              \
62
43.6M
        v2 += v1;                                                              \
63
43.6M
        v1 = ROTL(v1, 17);                                                     \
64
43.6M
        v1 ^= v2;                                                              \
65
43.6M
        v2 = ROTL(v2, 32);                                                     \
66
43.6M
    } while (0)
67
68
size_t SipHash_ctx_size(void)
69
0
{
70
0
    return sizeof(SIPHASH);
71
0
}
72
73
size_t SipHash_hash_size(SIPHASH *ctx)
74
4.81k
{
75
4.81k
    return ctx->hash_size;
76
4.81k
}
77
78
static size_t siphash_adjust_hash_size(size_t hash_size)
79
19.2M
{
80
19.2M
    if (hash_size == 0)
81
6.41M
        hash_size = SIPHASH_MAX_DIGEST_SIZE;
82
19.2M
    return hash_size;
83
19.2M
}
84
85
int SipHash_set_hash_size(SIPHASH *ctx, size_t hash_size)
86
6.41M
{
87
6.41M
    hash_size = siphash_adjust_hash_size(hash_size);
88
6.41M
    if (hash_size != SIPHASH_MIN_DIGEST_SIZE
89
6.41M
        && hash_size != SIPHASH_MAX_DIGEST_SIZE)
90
34
        return 0;
91
92
    /*
93
     * It's possible that the key was set first.  If the hash size changes,
94
     * we need to adjust v1 (see SipHash_Init().
95
     */
96
97
    /* Start by adjusting the stored size, to make things easier */
98
6.41M
    ctx->hash_size = siphash_adjust_hash_size(ctx->hash_size);
99
100
    /* Now, adjust ctx->v1 if the old and the new size differ */
101
6.41M
    if ((size_t)ctx->hash_size != hash_size) {
102
6.41M
        ctx->v1 ^= 0xee;
103
6.41M
        ctx->hash_size = hash_size;
104
6.41M
    }
105
6.41M
    return 1;
106
6.41M
}
107
108
/* hash_size = crounds = drounds = 0 means SipHash24 with 16-byte output */
109
int SipHash_Init(SIPHASH *ctx, const unsigned char *k, int crounds, int drounds)
110
6.41M
{
111
6.41M
    uint64_t k0 = U8TO64_LE(k);
112
6.41M
    uint64_t k1 = U8TO64_LE(k + 8);
113
114
    /* If the hash size wasn't set, i.e. is zero */
115
6.41M
    ctx->hash_size = siphash_adjust_hash_size(ctx->hash_size);
116
117
6.41M
    if (drounds == 0)
118
6.41M
        drounds = SIPHASH_D_ROUNDS;
119
6.41M
    if (crounds == 0)
120
6.41M
        crounds = SIPHASH_C_ROUNDS;
121
122
6.41M
    ctx->crounds = crounds;
123
6.41M
    ctx->drounds = drounds;
124
125
6.41M
    ctx->len = 0;
126
6.41M
    ctx->total_inlen = 0;
127
128
6.41M
    ctx->v0 = 0x736f6d6570736575ULL ^ k0;
129
6.41M
    ctx->v1 = 0x646f72616e646f6dULL ^ k1;
130
6.41M
    ctx->v2 = 0x6c7967656e657261ULL ^ k0;
131
6.41M
    ctx->v3 = 0x7465646279746573ULL ^ k1;
132
133
6.41M
    if (ctx->hash_size == SIPHASH_MAX_DIGEST_SIZE)
134
2.42k
        ctx->v1 ^= 0xee;
135
136
6.41M
    return 1;
137
6.41M
}
138
139
void SipHash_Update(SIPHASH *ctx, const unsigned char *in, size_t inlen)
140
6.41M
{
141
6.41M
    uint64_t m;
142
6.41M
    const uint8_t *end;
143
6.41M
    int left;
144
6.41M
    unsigned int i;
145
6.41M
    uint64_t v0 = ctx->v0;
146
6.41M
    uint64_t v1 = ctx->v1;
147
6.41M
    uint64_t v2 = ctx->v2;
148
6.41M
    uint64_t v3 = ctx->v3;
149
150
6.41M
    ctx->total_inlen += inlen;
151
152
6.41M
    if (ctx->len) {
153
        /* deal with leavings */
154
78
        size_t available = SIPHASH_BLOCK_SIZE - ctx->len;
155
156
        /* not enough to fill leavings */
157
78
        if (inlen < available) {
158
0
            memcpy(&ctx->leavings[ctx->len], in, inlen);
159
0
            ctx->len += inlen;
160
0
            return;
161
0
        }
162
163
        /* copy data into leavings and reduce input */
164
78
        memcpy(&ctx->leavings[ctx->len], in, available);
165
78
        inlen -= available;
166
78
        in += available;
167
168
        /* process leavings */
169
78
        m = U8TO64_LE(ctx->leavings);
170
78
        v3 ^= m;
171
234
        for (i = 0; i < ctx->crounds; ++i)
172
156
            SIPROUND;
173
78
        v0 ^= m;
174
78
    }
175
6.41M
    left = inlen & (SIPHASH_BLOCK_SIZE-1); /* gets put into leavings */
176
6.41M
    end = in + inlen - left;
177
178
8.97M
    for (; in != end; in += 8) {
179
2.55M
        m = U8TO64_LE(in);
180
2.55M
        v3 ^= m;
181
7.67M
        for (i = 0; i < ctx->crounds; ++i)
182
5.11M
            SIPROUND;
183
2.55M
        v0 ^= m;
184
2.55M
    }
185
186
    /* save leavings and other ctx */
187
6.41M
    if (left)
188
3.30M
        memcpy(ctx->leavings, end, left);
189
6.41M
    ctx->len = left;
190
191
6.41M
    ctx->v0 = v0;
192
6.41M
    ctx->v1 = v1;
193
6.41M
    ctx->v2 = v2;
194
6.41M
    ctx->v3 = v3;
195
6.41M
}
196
197
int SipHash_Final(SIPHASH *ctx, unsigned char *out, size_t outlen)
198
6.41M
{
199
    /* finalize hash */
200
6.41M
    unsigned int i;
201
6.41M
    uint64_t b = ctx->total_inlen << 56;
202
6.41M
    uint64_t v0 = ctx->v0;
203
6.41M
    uint64_t v1 = ctx->v1;
204
6.41M
    uint64_t v2 = ctx->v2;
205
6.41M
    uint64_t v3 = ctx->v3;
206
207
6.41M
    if (ctx->crounds == 0 || outlen == 0 || outlen != (size_t)ctx->hash_size)
208
0
        return 0;
209
210
6.41M
    switch (ctx->len) {
211
289k
    case 7:
212
289k
        b |= ((uint64_t)ctx->leavings[6]) << 48;
213
        /* fall thru */
214
339k
    case 6:
215
339k
        b |= ((uint64_t)ctx->leavings[5]) << 40;
216
        /* fall thru */
217
528k
    case 5:
218
528k
        b |= ((uint64_t)ctx->leavings[4]) << 32;
219
        /* fall thru */
220
1.01M
    case 4:
221
1.01M
        b |= ((uint64_t)ctx->leavings[3]) << 24;
222
        /* fall thru */
223
2.53M
    case 3:
224
2.53M
        b |= ((uint64_t)ctx->leavings[2]) << 16;
225
        /* fall thru */
226
2.70M
    case 2:
227
2.70M
        b |= ((uint64_t)ctx->leavings[1]) <<  8;
228
        /* fall thru */
229
3.30M
    case 1:
230
3.30M
        b |= ((uint64_t)ctx->leavings[0]);
231
6.41M
    case 0:
232
6.41M
        break;
233
6.41M
    }
234
235
6.41M
    v3 ^= b;
236
19.2M
    for (i = 0; i < ctx->crounds; ++i)
237
12.8M
        SIPROUND;
238
6.41M
    v0 ^= b;
239
6.41M
    if (ctx->hash_size == SIPHASH_MAX_DIGEST_SIZE)
240
2.40k
        v2 ^= 0xee;
241
6.41M
    else
242
6.41M
        v2 ^= 0xff;
243
32.0M
    for (i = 0; i < ctx->drounds; ++i)
244
25.6M
        SIPROUND;
245
6.41M
    b = v0 ^ v1 ^ v2  ^ v3;
246
6.41M
    U64TO8_LE(out, b);
247
6.41M
    if (ctx->hash_size == SIPHASH_MIN_DIGEST_SIZE)
248
6.41M
        return 1;
249
2.40k
    v1 ^= 0xdd;
250
12.0k
    for (i = 0; i < ctx->drounds; ++i)
251
9.62k
        SIPROUND;
252
2.40k
    b = v0 ^ v1 ^ v2  ^ v3;
253
2.40k
    U64TO8_LE(out + 8, b);
254
2.40k
    return 1;
255
6.41M
}