Coverage Report

Created: 2026-04-02 07:09

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/boringssl/crypto/blake2/blake2.cc
Line
Count
Source
1
// Copyright 2021 The BoringSSL Authors
2
//
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
//     https://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
#include <openssl/blake2.h>
16
17
#include <assert.h>
18
19
#include <iterator>
20
21
#include "../internal.h"
22
23
using namespace bssl;
24
25
// https://tools.ietf.org/html/rfc7693#section-2.6
26
static const uint64_t kIV[8] = {
27
    UINT64_C(0x6a09e667f3bcc908), UINT64_C(0xbb67ae8584caa73b),
28
    UINT64_C(0x3c6ef372fe94f82b), UINT64_C(0xa54ff53a5f1d36f1),
29
    UINT64_C(0x510e527fade682d1), UINT64_C(0x9b05688c2b3e6c1f),
30
    UINT64_C(0x1f83d9abfb41bd6b), UINT64_C(0x5be0cd19137e2179),
31
};
32
33
// https://tools.ietf.org/html/rfc7693#section-2.7
34
static const uint8_t kSigma[10 * 16] = {
35
    // clang-format off
36
    0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
37
    14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3,
38
    11, 8, 12, 0, 5, 2, 15, 13, 10, 14, 3, 6, 7, 1, 9, 4,
39
    7, 9, 3, 1, 13, 12, 11, 14, 2, 6, 5, 10, 4, 0, 15, 8,
40
    9, 0, 5, 7, 2, 4, 10, 15, 14, 1, 11, 12, 6, 8, 3, 13,
41
    2, 12, 6, 10, 0, 11, 8, 3, 4, 13, 7, 5, 15, 14, 1, 9,
42
    12, 5, 1, 15, 14, 13, 4, 10, 0, 7, 6, 3, 9, 2, 8, 11,
43
    13, 11, 7, 14, 12, 1, 3, 9, 5, 0, 15, 4, 8, 6, 2, 10,
44
    6, 15, 14, 9, 11, 3, 0, 8, 12, 2, 13, 7, 1, 4, 10, 5,
45
    10, 2, 8, 4, 7, 6, 1, 5, 15, 11, 9, 14, 3, 12, 13, 0,
46
    // clang-format on
47
};
48
49
// https://tools.ietf.org/html/rfc7693#section-3.1
50
static void blake2b_mix(uint64_t v[16], int a, int b, int c, int d, uint64_t x,
51
0
                        uint64_t y) {
52
0
  v[a] = v[a] + v[b] + x;
53
0
  v[d] = CRYPTO_rotr_u64(v[d] ^ v[a], 32);
54
0
  v[c] = v[c] + v[d];
55
0
  v[b] = CRYPTO_rotr_u64(v[b] ^ v[c], 24);
56
0
  v[a] = v[a] + v[b] + y;
57
0
  v[d] = CRYPTO_rotr_u64(v[d] ^ v[a], 16);
58
0
  v[c] = v[c] + v[d];
59
0
  v[b] = CRYPTO_rotr_u64(v[b] ^ v[c], 63);
60
0
}
61
62
0
static uint64_t blake2b_load(const uint8_t block[BLAKE2B_CBLOCK], size_t i) {
63
0
  return CRYPTO_load_u64_le(block + 8 * i);
64
0
}
65
66
static void blake2b_transform(BLAKE2B_CTX *b2b,
67
                              const uint8_t block[BLAKE2B_CBLOCK],
68
0
                              size_t num_bytes, int is_final_block) {
69
  // https://tools.ietf.org/html/rfc7693#section-3.2
70
0
  uint64_t v[16];
71
0
  static_assert(sizeof(v) == sizeof(b2b->h) + sizeof(kIV));
72
0
  OPENSSL_memcpy(v, b2b->h, sizeof(b2b->h));
73
0
  OPENSSL_memcpy(&v[8], kIV, sizeof(kIV));
74
75
0
  b2b->t_low += num_bytes;
76
0
  if (b2b->t_low < num_bytes) {
77
0
    b2b->t_high++;
78
0
  }
79
0
  v[12] ^= b2b->t_low;
80
0
  v[13] ^= b2b->t_high;
81
82
0
  if (is_final_block) {
83
0
    v[14] = ~v[14];
84
0
  }
85
86
0
  for (int round = 0; round < 12; round++) {
87
0
    const uint8_t *const s = &kSigma[16 * (round % 10)];
88
0
    blake2b_mix(v, 0, 4, 8, 12, blake2b_load(block, s[0]),
89
0
                blake2b_load(block, s[1]));
90
0
    blake2b_mix(v, 1, 5, 9, 13, blake2b_load(block, s[2]),
91
0
                blake2b_load(block, s[3]));
92
0
    blake2b_mix(v, 2, 6, 10, 14, blake2b_load(block, s[4]),
93
0
                blake2b_load(block, s[5]));
94
0
    blake2b_mix(v, 3, 7, 11, 15, blake2b_load(block, s[6]),
95
0
                blake2b_load(block, s[7]));
96
0
    blake2b_mix(v, 0, 5, 10, 15, blake2b_load(block, s[8]),
97
0
                blake2b_load(block, s[9]));
98
0
    blake2b_mix(v, 1, 6, 11, 12, blake2b_load(block, s[10]),
99
0
                blake2b_load(block, s[11]));
100
0
    blake2b_mix(v, 2, 7, 8, 13, blake2b_load(block, s[12]),
101
0
                blake2b_load(block, s[13]));
102
0
    blake2b_mix(v, 3, 4, 9, 14, blake2b_load(block, s[14]),
103
0
                blake2b_load(block, s[15]));
104
0
  }
105
106
0
  for (size_t i = 0; i < std::size(b2b->h); i++) {
107
0
    b2b->h[i] ^= v[i];
108
0
    b2b->h[i] ^= v[i + 8];
109
0
  }
110
0
}
111
112
0
void BLAKE2B256_Init(BLAKE2B_CTX *b2b) {
113
0
  OPENSSL_memset(b2b, 0, sizeof(BLAKE2B_CTX));
114
115
0
  static_assert(sizeof(kIV) == sizeof(b2b->h));
116
0
  OPENSSL_memcpy(&b2b->h, kIV, sizeof(kIV));
117
118
  // https://tools.ietf.org/html/rfc7693#section-2.5
119
0
  b2b->h[0] ^= 0x01010000 | BLAKE2B256_DIGEST_LENGTH;
120
0
}
121
122
0
void BLAKE2B256_Update(BLAKE2B_CTX *b2b, const void *in_data, size_t len) {
123
0
  if (len == 0) {
124
    // Work around a C language bug. See https://crbug.com/1019588.
125
0
    return;
126
0
  }
127
128
0
  const uint8_t *data = reinterpret_cast<const uint8_t *>(in_data);
129
0
  size_t todo = sizeof(b2b->block) - b2b->block_used;
130
0
  if (todo > len) {
131
0
    todo = len;
132
0
  }
133
0
  OPENSSL_memcpy(&b2b->block[b2b->block_used], data, todo);
134
0
  b2b->block_used += todo;
135
0
  data += todo;
136
0
  len -= todo;
137
138
0
  if (!len) {
139
0
    return;
140
0
  }
141
142
  // More input remains therefore we must have filled |b2b->block|.
143
0
  assert(b2b->block_used == BLAKE2B_CBLOCK);
144
0
  blake2b_transform(b2b, b2b->block, BLAKE2B_CBLOCK,
145
0
                    /*is_final_block=*/0);
146
0
  b2b->block_used = 0;
147
148
0
  while (len > BLAKE2B_CBLOCK) {
149
0
    blake2b_transform(b2b, data, BLAKE2B_CBLOCK, /*is_final_block=*/0);
150
0
    data += BLAKE2B_CBLOCK;
151
0
    len -= BLAKE2B_CBLOCK;
152
0
  }
153
154
0
  OPENSSL_memcpy(b2b->block, data, len);
155
0
  b2b->block_used = len;
156
0
}
157
158
0
void BLAKE2B256_Final(uint8_t out[BLAKE2B256_DIGEST_LENGTH], BLAKE2B_CTX *b2b) {
159
0
  OPENSSL_memset(&b2b->block[b2b->block_used], 0,
160
0
                 sizeof(b2b->block) - b2b->block_used);
161
0
  blake2b_transform(b2b, b2b->block, b2b->block_used,
162
0
                    /*is_final_block=*/1);
163
0
  static_assert(BLAKE2B256_DIGEST_LENGTH <= sizeof(b2b->h));
164
0
  memcpy(out, b2b->h, BLAKE2B256_DIGEST_LENGTH);
165
0
}
166
167
void BLAKE2B256(const uint8_t *data, size_t len,
168
0
                uint8_t out[BLAKE2B256_DIGEST_LENGTH]) {
169
0
  BLAKE2B_CTX ctx;
170
0
  BLAKE2B256_Init(&ctx);
171
0
  BLAKE2B256_Update(&ctx, data, len);
172
0
  BLAKE2B256_Final(out, &ctx);
173
0
}