summaryrefslogtreecommitdiff
path: root/include/crypto/blake2s.h
blob: 648cb78243588723a634195d8595981cf24ab644 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
/* SPDX-License-Identifier: GPL-2.0 OR MIT */
/*
 * Copyright (C) 2015-2019 Jason A. Donenfeld <Jason@zx2c4.com>. All Rights Reserved.
 */

#ifndef _CRYPTO_BLAKE2S_H
#define _CRYPTO_BLAKE2S_H

#include <linux/bug.h>
#include <linux/kconfig.h>
#include <linux/types.h>
#include <linux/string.h>

enum blake2s_lengths {
	BLAKE2S_BLOCK_SIZE = 64,
	BLAKE2S_HASH_SIZE = 32,
	BLAKE2S_KEY_SIZE = 32,

	BLAKE2S_128_HASH_SIZE = 16,
	BLAKE2S_160_HASH_SIZE = 20,
	BLAKE2S_224_HASH_SIZE = 28,
	BLAKE2S_256_HASH_SIZE = 32,
};

/**
 * struct blake2s_ctx - Context for hashing a message with BLAKE2s
 * @h: compression function state
 * @t: block counter
 * @f: finalization indicator
 * @buf: partial block buffer; 'buflen' bytes are valid
 * @buflen: number of bytes buffered in @buf
 * @outlen: length of output hash value in bytes, at most BLAKE2S_HASH_SIZE
 */
struct blake2s_ctx {
	/* 'h', 't', and 'f' are used in assembly code, so keep them as-is. */
	u32 h[8];
	u32 t[2];
	u32 f[2];
	u8 buf[BLAKE2S_BLOCK_SIZE];
	unsigned int buflen;
	unsigned int outlen;
};

enum blake2s_iv {
	BLAKE2S_IV0 = 0x6A09E667UL,
	BLAKE2S_IV1 = 0xBB67AE85UL,
	BLAKE2S_IV2 = 0x3C6EF372UL,
	BLAKE2S_IV3 = 0xA54FF53AUL,
	BLAKE2S_IV4 = 0x510E527FUL,
	BLAKE2S_IV5 = 0x9B05688CUL,
	BLAKE2S_IV6 = 0x1F83D9ABUL,
	BLAKE2S_IV7 = 0x5BE0CD19UL,
};

static inline void __blake2s_init(struct blake2s_ctx *ctx, size_t outlen,
				  const void *key, size_t keylen)
{
	ctx->h[0] = BLAKE2S_IV0 ^ (0x01010000 | keylen << 8 | outlen);
	ctx->h[1] = BLAKE2S_IV1;
	ctx->h[2] = BLAKE2S_IV2;
	ctx->h[3] = BLAKE2S_IV3;
	ctx->h[4] = BLAKE2S_IV4;
	ctx->h[5] = BLAKE2S_IV5;
	ctx->h[6] = BLAKE2S_IV6;
	ctx->h[7] = BLAKE2S_IV7;
	ctx->t[0] = 0;
	ctx->t[1] = 0;
	ctx->f[0] = 0;
	ctx->f[1] = 0;
	ctx->buflen = 0;
	ctx->outlen = outlen;
	if (keylen) {
		memcpy(ctx->buf, key, keylen);
		memset(&ctx->buf[keylen], 0, BLAKE2S_BLOCK_SIZE - keylen);
		ctx->buflen = BLAKE2S_BLOCK_SIZE;
	}
}

/**
 * blake2s_init() - Initialize a BLAKE2s context for a new message (unkeyed)
 * @ctx: the context to initialize
 * @outlen: length of output hash value in bytes, at most BLAKE2S_HASH_SIZE
 *
 * Context: Any context.
 */
static inline void blake2s_init(struct blake2s_ctx *ctx, size_t outlen)
{
	__blake2s_init(ctx, outlen, NULL, 0);
}

/**
 * blake2s_init_key() - Initialize a BLAKE2s context for a new message (keyed)
 * @ctx: the context to initialize
 * @outlen: length of output hash value in bytes, at most BLAKE2S_HASH_SIZE
 * @key: the key
 * @keylen: the key length in bytes, at most BLAKE2S_KEY_SIZE
 *
 * Context: Any context.
 */
static inline void blake2s_init_key(struct blake2s_ctx *ctx, size_t outlen,
				    const void *key, size_t keylen)
{
	WARN_ON(IS_ENABLED(DEBUG) && (!outlen || outlen > BLAKE2S_HASH_SIZE ||
		!key || !keylen || keylen > BLAKE2S_KEY_SIZE));

	__blake2s_init(ctx, outlen, key, keylen);
}

/**
 * blake2s_update() - Update a BLAKE2s context with message data
 * @ctx: the context to update; must have been initialized
 * @in: the message data
 * @inlen: the data length in bytes
 *
 * This can be called any number of times.
 *
 * Context: Any context.
 */
void blake2s_update(struct blake2s_ctx *ctx, const u8 *in, size_t inlen);

/**
 * blake2s_final() - Finish computing a BLAKE2s hash
 * @ctx: the context to finalize; must have been initialized
 * @out: (output) the resulting BLAKE2s hash.  Its length will be equal to the
 *	 @outlen that was passed to blake2s_init() or blake2s_init_key().
 *
 * After finishing, this zeroizes @ctx.  So the caller does not need to do it.
 *
 * Context: Any context.
 */
void blake2s_final(struct blake2s_ctx *ctx, u8 *out);

/**
 * blake2s() - Compute BLAKE2s hash in one shot
 * @key: the key, or NULL for an unkeyed hash
 * @keylen: the key length in bytes (at most BLAKE2S_KEY_SIZE), or 0 for an
 *	    unkeyed hash
 * @in: the message data
 * @inlen: the data length in bytes
 * @out: (output) the resulting BLAKE2s hash, with length @outlen
 * @outlen: length of output hash value in bytes, at most BLAKE2S_HASH_SIZE
 *
 * Context: Any context.
 */
static inline void blake2s(const u8 *key, size_t keylen,
			   const u8 *in, size_t inlen,
			   u8 *out, size_t outlen)
{
	struct blake2s_ctx ctx;

	WARN_ON(IS_ENABLED(DEBUG) && ((!in && inlen > 0) || !out || !outlen ||
		outlen > BLAKE2S_HASH_SIZE || keylen > BLAKE2S_KEY_SIZE ||
		(!key && keylen)));

	__blake2s_init(&ctx, outlen, key, keylen);
	blake2s_update(&ctx, in, inlen);
	blake2s_final(&ctx, out);
}

#endif /* _CRYPTO_BLAKE2S_H */