lib/crypto/riscv/gf128hash.h
Source file repositories/reference/linux-study-clean/lib/crypto/riscv/gf128hash.h
File Facts
- System
- Linux kernel
- Corpus path
lib/crypto/riscv/gf128hash.h- Extension
.h- Size
- 1564 bytes
- Lines
- 58
- Domain
- Kernel Services
- Bucket
- lib
- Inferred role
- Kernel Services: implementation source
- Status
- source implementation candidate
Why This File Exists
Shared kernel service surface used by multiple subsystems, including helpers, cryptography, virtualization support, and async I/O infrastructure.
- Shared kernel service surface used by multiple subsystems, including helpers, cryptography, virtualization support, and async I/O infrastructure.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
asm/simd.hasm/vector.h
Detected Declarations
function ghash_preparekey_archfunction ghash_blocks_archfunction gf128hash_mod_init_arch
Annotated Snippet
#include <asm/simd.h>
#include <asm/vector.h>
static __ro_after_init DEFINE_STATIC_KEY_FALSE(have_zvkg);
asmlinkage void ghash_zvkg(u8 accumulator[GHASH_BLOCK_SIZE],
const u8 key[GHASH_BLOCK_SIZE],
const u8 *data, size_t nblocks);
#define ghash_preparekey_arch ghash_preparekey_arch
static void ghash_preparekey_arch(struct ghash_key *key,
const u8 raw_key[GHASH_BLOCK_SIZE])
{
/* Save key in POLYVAL format for fallback */
ghash_key_to_polyval(raw_key, &key->h);
/* Save key in GHASH format for zvkg */
memcpy(key->h_raw, raw_key, GHASH_BLOCK_SIZE);
}
#define ghash_blocks_arch ghash_blocks_arch
static void ghash_blocks_arch(struct polyval_elem *acc,
const struct ghash_key *key,
const u8 *data, size_t nblocks)
{
if (static_branch_likely(&have_zvkg) && likely(may_use_simd())) {
u8 ghash_acc[GHASH_BLOCK_SIZE];
polyval_acc_to_ghash(acc, ghash_acc);
kernel_vector_begin();
ghash_zvkg(ghash_acc, key->h_raw, data, nblocks);
kernel_vector_end();
ghash_acc_to_polyval(ghash_acc, acc);
memzero_explicit(ghash_acc, sizeof(ghash_acc));
} else {
ghash_blocks_generic(acc, &key->h, data, nblocks);
}
}
#define gf128hash_mod_init_arch gf128hash_mod_init_arch
static void gf128hash_mod_init_arch(void)
{
if (riscv_isa_extension_available(NULL, ZVKG) &&
riscv_vector_vlen() >= 128)
static_branch_enable(&have_zvkg);
}
Annotation
- Immediate include surface: `asm/simd.h`, `asm/vector.h`.
- Detected declarations: `function ghash_preparekey_arch`, `function ghash_blocks_arch`, `function gf128hash_mod_init_arch`.
- Atlas domain: Kernel Services / lib.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.