arch/s390/crypto/phmac_s390.c

File Facts

System

Linux kernel

Corpus path

arch/s390/crypto/phmac_s390.c

Extension

.c

Size

27576 bytes

Lines

1075

Domain

Architecture Layer

Bucket

arch/s390

Inferred role

Architecture Layer: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.

• CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• asm/cpacf.h
• asm/pkey.h
• crypto/engine.h
• crypto/hash.h
• crypto/internal/hash.h
• crypto/sha2.h
• linux/atomic.h
• linux/cpufeature.h
• linux/delay.h
• linux/miscdevice.h
• linux/module.h
• linux/spinlock.h

Detected Declarations

• struct hash_walk_helper
• struct phmac_protkey
• struct phmac_tfm_ctx
• struct kmac_sha2_ctx
• struct phmac_req_ctx
• struct hmac_clrkey_token
• struct sha256_paramblock
• struct sha512_paramblock
• enum async_op
• function hwh_prepare
• function hwh_advance
• function hash_key
• function make_clrkey_token
• function phmac_tfm_ctx_setkey
• function convert_key
• function convert_key
• function kmac_sha2_set_imbl
• function phmac_kmac_update
• function phmac_kmac_final
• function phmac_init
• function setkey
• function phmac_update
• function phmac_final
• function phmac_finup
• function phmac_digest
• function phmac_setkey
• function phmac_export
• function phmac_import
• function phmac_init_tfm
• function phmac_exit_tfm
• function phmac_do_one_request
• function s390_phmac_exit
• function s390_phmac_init
• module init s390_phmac_init

Annotated Snippet

module_init(s390_phmac_init);
module_exit(s390_phmac_exit);

MODULE_ALIAS_CRYPTO("phmac(sha224)");
MODULE_ALIAS_CRYPTO("phmac(sha256)");
MODULE_ALIAS_CRYPTO("phmac(sha384)");
MODULE_ALIAS_CRYPTO("phmac(sha512)");

MODULE_DESCRIPTION("S390 HMAC driver for protected keys");
MODULE_LICENSE("GPL");

Annotation

• Immediate include surface: `asm/cpacf.h`, `asm/pkey.h`, `crypto/engine.h`, `crypto/hash.h`, `crypto/internal/hash.h`, `crypto/sha2.h`, `linux/atomic.h`, `linux/cpufeature.h`.
• Detected declarations: `struct hash_walk_helper`, `struct phmac_protkey`, `struct phmac_tfm_ctx`, `struct kmac_sha2_ctx`, `struct phmac_req_ctx`, `struct hmac_clrkey_token`, `struct sha256_paramblock`, `struct sha512_paramblock`, `enum async_op`, `function hwh_prepare`.
• Atlas domain: Architecture Layer / arch/s390.
• Implementation status: integration implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.

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.