lib/crypto/s390/gf128hash.h
Source file repositories/reference/linux-study-clean/lib/crypto/s390/gf128hash.h
File Facts
- System
- Linux kernel
- Corpus path
lib/crypto/s390/gf128hash.h- Extension
.h- Size
- 1580 bytes
- Lines
- 55
- 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/cpacf.hlinux/cpufeature.h
Detected Declarations
function ghash_preparekey_archfunction ghash_blocks_archfunction gf128hash_mod_init_arch
Annotated Snippet
#include <asm/cpacf.h>
#include <linux/cpufeature.h>
static __ro_after_init DEFINE_STATIC_KEY_FALSE(have_cpacf_ghash);
#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 CPACF_KIMD_GHASH */
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_cpacf_ghash)) {
/*
* CPACF_KIMD_GHASH requires the accumulator and key in a single
* buffer, each using the GHASH convention.
*/
u8 ctx[2][GHASH_BLOCK_SIZE] __aligned(8);
polyval_acc_to_ghash(acc, ctx[0]);
memcpy(ctx[1], key->h_raw, GHASH_BLOCK_SIZE);
cpacf_kimd(CPACF_KIMD_GHASH, ctx, data,
nblocks * GHASH_BLOCK_SIZE);
ghash_acc_to_polyval(ctx[0], acc);
memzero_explicit(ctx, sizeof(ctx));
} 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 (cpu_have_feature(S390_CPU_FEATURE_MSA) &&
cpacf_query_func(CPACF_KIMD, CPACF_KIMD_GHASH))
static_branch_enable(&have_cpacf_ghash);
}
Annotation
- Immediate include surface: `asm/cpacf.h`, `linux/cpufeature.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.