Skip to content

Commit

Permalink
Modified the StdRng documentation
Browse files Browse the repository at this point in the history
- Correctly identifies the engine used as ChaCha12 (not ChaCha20).
- Cites the relevant rand crate issue.
  • Loading branch information
JJPennington committed Dec 18, 2020
1 parent 34423a6 commit 9aa8bc1
Showing 1 changed file with 4 additions and 3 deletions.
7 changes: 4 additions & 3 deletions src/rngs/std.rs
Expand Up @@ -22,16 +22,17 @@ pub(crate) use rand_hc::Hc128Core as Core;
/// on the current platform, to be statistically strong and unpredictable
/// (meaning a cryptographically secure PRNG).
///
/// The current algorithm used is the ChaCha block cipher with 20 rounds.
/// This may change as new evidence of cipher security and performance
/// becomes available.
/// The current algorithm used is the ChaCha block cipher with 12 rounds. Please
/// see this relevant [rand issue] for the discussion. This may change as new
/// evidence of cipher security and performance becomes available.
///
/// The algorithm is deterministic but should not be considered reproducible
/// due to dependence on configuration and possible replacement in future
/// library versions. For a secure reproducible generator, we recommend use of
/// the [rand_chacha] crate directly.
///
/// [rand_chacha]: https://crates.io/crates/rand_chacha
/// [rand issue]: https://github.com/rust-random/rand/issues/932
#[cfg_attr(doc_cfg, doc(cfg(feature = "std_rng")))]
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct StdRng(Rng);
Expand Down

0 comments on commit 9aa8bc1

Please sign in to comment.