wanderer/ BLAKE3
1
0
Fork 0
mirror of https://github.com/BLAKE3-team/BLAKE3 synced 2024-04-27 21:05:05 +02:00
Code Issues Releases Activity

replace a copy-pasted Rust API reference in the C docs

This commit is contained in:
Jack O'Connor 2022-07-22 10:47:04 -07:00
parent 79d270283f
commit 09df11731e
1 changed files with 7 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
c/README.md
View File

@ -196,14 +196,13 @@ BLAKE3 output is intended to provide N bits of first and second preimage resista
bits of collision resistance, for any N up to 256. Longer outputs don't provide any additional bits of collision resistance, for any N up to 256. Longer outputs don't provide any additional
security. security.
Avoid relying on the secrecy of the output offset, that is, the number of output bytes read or Avoid relying on the secrecy of the output offset, that is, the `seek` argument of
the arguments to [`seek`](struct.OutputReader.html#method.seek) or `blake3_hasher_finalize_seek`. [_Block-Cipher-Based Tree Hashing_ by Aldo
[`set_position`](struct.OutputReader.html#method.set_position). [_Block-Cipher-Based Tree Gunsing](https://eprint.iacr.org/2022/283) shows that an attacker who knows both the message
Hashing_ by Aldo Gunsing](https://eprint.iacr.org/2022/283) shows that an attacker who knows and the key (if any) can easily determine the offset of an extended output. For comparison,
both the message and the key (if any) can easily determine the offset of an extended output. AES-CTR has a similar property: if you know the key, you can decrypt a block from an unknown
For comparison, AES-CTR has a similar property: if you know the key, you can decrypt a block position in the output stream to recover its block index. Callers with strong secret keys
from an unknown position in the output stream to recover its block index. Callers with strong aren't affected in practice, but secret offsets are a [design
secret keys aren't affected in practice, but secret offsets are a [design
smell](https://en.wikipedia.org/wiki/Design_smell) in any case. smell](https://en.wikipedia.org/wiki/Design_smell) in any case.
# Building # Building