blob: 4984023a1a2d7544d8534ff4c8162a6db8620a9b [file] [log] [blame]
Qu Wenruob98e8a22021-12-27 14:12:07 +08001/* SPDX-License-Identifier: CC0-1.0 */
2/*
3 BLAKE2 reference source code package - reference C implementations
4
5 Copyright 2012, Samuel Neves <sneves@dei.uc.pt>. You may use this under the
6 terms of the CC0, the OpenSSL Licence, or the Apache Public License 2.0, at
7 your option. The terms of these licenses can be found at:
8
9 - CC0 1.0 Universal : http://creativecommons.org/publicdomain/zero/1.0
10 - OpenSSL license : https://www.openssl.org/source/license.html
11 - Apache 2.0 : http://www.apache.org/licenses/LICENSE-2.0
12
13 More information about the BLAKE2 hash function can be found at
14 https://blake2.net.
15*/
16
17/*
18 * Cross-ported from BLAKE2 (https://github.com/BLAKE2/BLAKE2).
19 * Modifications includes:
20 *
21 * - Remove unsupported compilers like MSC/CPP
22 * - Remove blake2s/blake2sp/blake2bp
23 * This blake2 implementation is mostly for btrfs, which only utilizes
24 * blake2b.
25 */
26#ifndef BLAKE2_H
27#define BLAKE2_H
28
29#include <stddef.h>
30#include <stdint.h>
31
32#if defined(_MSC_VER)
33#define BLAKE2_PACKED(x) __pragma(pack(push, 1)) x __pragma(pack(pop))
34#else
35#define BLAKE2_PACKED(x) x __attribute__((packed))
36#endif
37
38 enum blake2b_constant
39 {
40 BLAKE2B_BLOCKBYTES = 128,
41 BLAKE2B_OUTBYTES = 64,
42 BLAKE2B_KEYBYTES = 64,
43 BLAKE2B_SALTBYTES = 16,
44 BLAKE2B_PERSONALBYTES = 16
45 };
46
47 typedef struct blake2b_state__
48 {
49 uint64_t h[8];
50 uint64_t t[2];
51 uint64_t f[2];
52 uint8_t buf[BLAKE2B_BLOCKBYTES];
53 size_t buflen;
54 size_t outlen;
55 uint8_t last_node;
56 } blake2b_state;
57
58 BLAKE2_PACKED(struct blake2b_param__
59 {
60 uint8_t digest_length; /* 1 */
61 uint8_t key_length; /* 2 */
62 uint8_t fanout; /* 3 */
63 uint8_t depth; /* 4 */
64 uint32_t leaf_length; /* 8 */
65 uint32_t node_offset; /* 12 */
66 uint32_t xof_length; /* 16 */
67 uint8_t node_depth; /* 17 */
68 uint8_t inner_length; /* 18 */
69 uint8_t reserved[14]; /* 32 */
70 uint8_t salt[BLAKE2B_SALTBYTES]; /* 48 */
71 uint8_t personal[BLAKE2B_PERSONALBYTES]; /* 64 */
72 });
73
74 typedef struct blake2b_param__ blake2b_param;
75
76 /* Padded structs result in a compile-time error */
77 enum {
78 BLAKE2_DUMMY_2 = 1/(int)(sizeof(blake2b_param) == BLAKE2B_OUTBYTES)
79 };
80
81 /* Streaming API */
82 int blake2b_init( blake2b_state *S, size_t outlen );
83 int blake2b_init_key( blake2b_state *S, size_t outlen, const void *key, size_t keylen );
84 int blake2b_init_param( blake2b_state *S, const blake2b_param *P );
85 int blake2b_update( blake2b_state *S, const void *in, size_t inlen );
86 int blake2b_final( blake2b_state *S, void *out, size_t outlen );
87
88 /* Simple API */
89 int blake2b( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
90
91 /* This is simply an alias for blake2b */
92 int blake2( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
93
94#endif