Debian Codegraph @

crypto/cipher/README

raw
1 cipher: block cipher encryption modes
2
3 The crypto::cipher module provides block cipher encryption modes. The [[block]]
4 type provides an abstraction over a block cipher algorithm, and functions like
5 [[cbc_decryptor]] create encryptors or decryptors for specific block encryption
6 modes.
7
8 Block ciphers in Hare rely upon caller-provided buffer allocations, and do not
9 allocate memory at runtime. Consult the documentation for the underlying
10 algorithm, e.g. [[crypto::aes::]], for the appropriate buffer sizes to use.
11
12 This is a low-level module which implements cryptographic primitives. Direct use
13 of cryptographic primitives is not recommended for non-experts, as incorrect use
14 of these primitives can easily lead to the introduction of security
15 vulnerabilities. Non-experts are advised to use the high-level operations
16 available in the top-level [[crypto::]] module.
17
18 Be advised that Hare's cryptography implementations have not been audited.