crypto/chacha20poly1305.c

File Facts

System

Linux kernel

Corpus path

crypto/chacha20poly1305.c

Extension

.c

Size

12637 bytes

Lines

494

Domain

Kernel Services

Bucket

crypto

Inferred role

Kernel Services: exported/initcall integration point

Status

integration 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.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• 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

• crypto/internal/aead.h
• crypto/internal/hash.h
• crypto/internal/skcipher.h
• crypto/scatterwalk.h
• crypto/chacha.h
• crypto/poly1305.h
• linux/err.h
• linux/kernel.h
• linux/mm.h
• linux/module.h
• linux/string.h

Detected Declarations

• struct chachapoly_instance_ctx
• struct chachapoly_ctx
• struct chacha_req
• struct chachapoly_req_ctx
• function async_done_continue
• function chacha_iv
• function poly_verify_tag
• function chacha_decrypt_done
• function chacha_decrypt
• function poly_hash
• function poly_genkey_done
• function poly_genkey
• function chacha_encrypt_done
• function chacha_encrypt
• function chachapoly_encrypt
• function chachapoly_decrypt
• function chachapoly_setkey
• function chachapoly_setauthsize
• function chachapoly_init
• function chachapoly_exit
• function chachapoly_free
• function chachapoly_create
• function rfc7539_create
• function rfc7539esp_create
• function chacha20poly1305_module_init
• function chacha20poly1305_module_exit
• module init chacha20poly1305_module_init

Annotated Snippet

module_init(chacha20poly1305_module_init);
module_exit(chacha20poly1305_module_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Martin Willi <martin@strongswan.org>");
MODULE_DESCRIPTION("ChaCha20-Poly1305 AEAD");
MODULE_ALIAS_CRYPTO("rfc7539");
MODULE_ALIAS_CRYPTO("rfc7539esp");

Annotation

• Immediate include surface: `crypto/internal/aead.h`, `crypto/internal/hash.h`, `crypto/internal/skcipher.h`, `crypto/scatterwalk.h`, `crypto/chacha.h`, `crypto/poly1305.h`, `linux/err.h`, `linux/kernel.h`.
• Detected declarations: `struct chachapoly_instance_ctx`, `struct chachapoly_ctx`, `struct chacha_req`, `struct chachapoly_req_ctx`, `function async_done_continue`, `function chacha_iv`, `function poly_verify_tag`, `function chacha_decrypt_done`, `function chacha_decrypt`, `function poly_hash`.
• Atlas domain: Kernel Services / crypto.
• Implementation status: integration 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.