LLVM 22.0.0git
blake3.h
Go to the documentation of this file.
1/*===-- llvm-c/blake3.h - BLAKE3 C Interface ----------------------*- C -*-===*\
2|* *|
3|* Released into the public domain with CC0 1.0 *|
4|* See 'llvm/lib/Support/BLAKE3/LICENSE' for info. *|
5|* SPDX-License-Identifier: CC0-1.0 *|
6|* *|
7|*===----------------------------------------------------------------------===*|
8|* *|
9|* This header declares the C interface to LLVM's BLAKE3 implementation. *|
10|* Original BLAKE3 C API: https://github.com/BLAKE3-team/BLAKE3/tree/1.3.1/c *|
11|* *|
12|* Symbols are prefixed with 'llvm' to avoid a potential conflict with *|
13|* another BLAKE3 version within the same program. *|
14|* *|
15\*===----------------------------------------------------------------------===*/
16
17#ifndef LLVM_C_BLAKE3_H
18#define LLVM_C_BLAKE3_H
19
20#include "llvm-c/Visibility.h"
21#include <stddef.h>
22#include <stdint.h>
23
24#ifdef __cplusplus
25extern "C" {
26#endif
27
28#define LLVM_BLAKE3_VERSION_STRING "1.8.2"
29#define LLVM_BLAKE3_KEY_LEN 32
30#define LLVM_BLAKE3_OUT_LEN 32
31#define LLVM_BLAKE3_BLOCK_LEN 64
32#define LLVM_BLAKE3_CHUNK_LEN 1024
33#define LLVM_BLAKE3_MAX_DEPTH 54
34
35// This struct is a private implementation detail. It has to be here because
36// it's part of llvm_blake3_hasher below.
37typedef struct {
38 uint32_t cv[8];
45
46typedef struct {
47 uint32_t key[8];
50 // The stack size is MAX_DEPTH + 1 because we do lazy merging. For example,
51 // with 7 chunks, we have 3 entries in the stack. Adding an 8th chunk
52 // requires a 4th entry, rather than merging everything down to 1, because we
53 // don't know whether more input is coming. This is different from how the
54 // reference implementation does things.
57
58LLVM_C_ABI const char *llvm_blake3_version(void);
60LLVM_C_ABI void
62 const uint8_t key[LLVM_BLAKE3_KEY_LEN]);
64 const char *context);
66 const void *context,
67 size_t context_len);
69 const void *input, size_t input_len);
71 uint8_t *out, size_t out_len);
73 uint64_t seek, uint8_t *out,
74 size_t out_len);
76
77#ifdef __cplusplus
78}
79#endif
80
81#endif /* LLVM_C_BLAKE3_H */
#define LLVM_C_ABI
LLVM_C_ABI is the export/visibility macro used to mark symbols declared in llvm-c as exported when bu...
Definition: Visibility.h:40
LLVM_C_ABI void llvm_blake3_hasher_init_derive_key_raw(llvm_blake3_hasher *self, const void *context, size_t context_len)
LLVM_C_ABI void llvm_blake3_hasher_finalize(const llvm_blake3_hasher *self, uint8_t *out, size_t out_len)
#define LLVM_BLAKE3_BLOCK_LEN
Definition: blake3.h:31
LLVM_C_ABI void llvm_blake3_hasher_init(llvm_blake3_hasher *self)
LLVM_C_ABI void llvm_blake3_hasher_finalize_seek(const llvm_blake3_hasher *self, uint64_t seek, uint8_t *out, size_t out_len)
#define LLVM_BLAKE3_OUT_LEN
Definition: blake3.h:30
LLVM_C_ABI void llvm_blake3_hasher_init_keyed(llvm_blake3_hasher *self, const uint8_t key[LLVM_BLAKE3_KEY_LEN])
#define LLVM_BLAKE3_MAX_DEPTH
Definition: blake3.h:33
LLVM_C_ABI const char * llvm_blake3_version(void)
Definition: blake3.c:15
LLVM_C_ABI void llvm_blake3_hasher_init_derive_key(llvm_blake3_hasher *self, const char *context)
#define LLVM_BLAKE3_KEY_LEN
Definition: blake3.h:29
LLVM_C_ABI void llvm_blake3_hasher_update(llvm_blake3_hasher *self, const void *input, size_t input_len)
LLVM_C_ABI void llvm_blake3_hasher_reset(llvm_blake3_hasher *self)
uint64_t chunk_counter
Definition: blake3.h:39
uint8_t blocks_compressed
Definition: blake3.h:42
uint8_t cv_stack_len
Definition: blake3.h:49
llvm_blake3_chunk_state chunk
Definition: blake3.h:48