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