include/crypto/blake2b.h

Source file repositories/reference/linux-study-clean/include/crypto/blake2b.h

File Facts

System
Linux kernel
Corpus path
include/crypto/blake2b.h
Extension
.h
Size
4459 bytes
Lines
157
Domain
Repository Root And Misc
Bucket
include
Inferred role
Repository Root And Misc: implementation source
Status
source implementation candidate

Why This File Exists

Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.

Dependency Surface

Detected Declarations

Annotated Snippet

struct blake2b_ctx {
	/* 'h', 't', and 'f' are used in assembly code, so keep them as-is. */
	u64 h[8];
	u64 t[2];
	u64 f[2];
	u8 buf[BLAKE2B_BLOCK_SIZE];
	unsigned int buflen;
	unsigned int outlen;
};

enum blake2b_iv {
	BLAKE2B_IV0 = 0x6A09E667F3BCC908ULL,
	BLAKE2B_IV1 = 0xBB67AE8584CAA73BULL,
	BLAKE2B_IV2 = 0x3C6EF372FE94F82BULL,
	BLAKE2B_IV3 = 0xA54FF53A5F1D36F1ULL,
	BLAKE2B_IV4 = 0x510E527FADE682D1ULL,
	BLAKE2B_IV5 = 0x9B05688C2B3E6C1FULL,
	BLAKE2B_IV6 = 0x1F83D9ABFB41BD6BULL,
	BLAKE2B_IV7 = 0x5BE0CD19137E2179ULL,
};

static inline void __blake2b_init(struct blake2b_ctx *ctx, size_t outlen,
				  const void *key, size_t keylen)
{
	ctx->h[0] = BLAKE2B_IV0 ^ (0x01010000 | keylen << 8 | outlen);
	ctx->h[1] = BLAKE2B_IV1;
	ctx->h[2] = BLAKE2B_IV2;
	ctx->h[3] = BLAKE2B_IV3;
	ctx->h[4] = BLAKE2B_IV4;
	ctx->h[5] = BLAKE2B_IV5;
	ctx->h[6] = BLAKE2B_IV6;
	ctx->h[7] = BLAKE2B_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, BLAKE2B_BLOCK_SIZE - keylen);
		ctx->buflen = BLAKE2B_BLOCK_SIZE;
	}
}

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

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

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

/**
 * blake2b_update() - Update a BLAKE2b 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 blake2b_update(struct blake2b_ctx *ctx, const u8 *in, size_t inlen);

/**
 * blake2b_final() - Finish computing a BLAKE2b hash
 * @ctx: the context to finalize; must have been initialized

Annotation

Implementation Notes