File: README

package info (click to toggle)
hare 0.25.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,948 kB
  • sloc: asm: 1,264; makefile: 123; sh: 114; lisp: 101
file content (18 lines) | stat: -rw-r--r-- 943 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
cipher: block cipher encryption modes

The crypto::cipher module provides block cipher encryption modes. The [[block]]
type provides an abstraction over a block cipher algorithm, and functions like
[[cbc_decryptor]] create encryptors or decryptors for specific block encryption
modes.

Block ciphers in Hare rely upon caller-provided buffer allocations, and do not
allocate memory at runtime. Consult the documentation for the underlying
algorithm, e.g. [[crypto::aes::]], for the appropriate buffer sizes to use.

This is a low-level module which implements cryptographic primitives. Direct use
of cryptographic primitives is not recommended for non-experts, as incorrect use
of these primitives can easily lead to the introduction of security
vulnerabilities. Non-experts are advised to use the high-level operations
available in the top-level [[crypto::]] module.

Be advised that Hare's cryptography implementations have not been audited.