[−][src]Struct rand::prng::hc128::Hc128Rng
A cryptographically secure random number generator that uses the HC-128 algorithm.
HC-128 is a stream cipher designed by Hongjun Wu1, that we use as an RNG. It is selected as one of the "stream ciphers suitable for widespread adoption" by eSTREAM2.
HC-128 is an array based RNG. In this it is similar to RC-4 and ISAAC before it, but those have never been proven cryptographically secure (or have even been significantly compromised, as in the case of RC-43).
Because HC-128 works with simple indexing into a large array and with a few operations that parallelize well, it has very good performance. The size of the array it needs, 4kb, can however be a disadvantage.
This implementation is not based on the version of HC-128 submitted to the eSTREAM contest, but on a later version by the author with a few small improvements from December 15, 20094.
HC-128 has no known weaknesses that are easier to exploit than doing a brute-force search of 2128. A very comprehensive analysis of the current state of known attacks / weaknesses of HC-128 is given in Some Results On Analysis And Implementation Of HC-128 Stream Cipher5.
The average cycle length is expected to be 21024*32+10-1 = 232777. We support seeding with a 256-bit array, which matches the 128-bit key concatenated with a 128-bit IV from the stream cipher.
This implementation uses an output buffer of sixteen u32
words, and uses
BlockRng
to implement the RngCore
methods.
References
Hongjun Wu (2008). "The Stream Cipher HC-128". The eSTREAM Finalists, LNCS 4986, pp. 39–47, Springer-Verlag. ↩
Internet Engineering Task Force (February 2015), "Prohibiting RC4 Cipher Suites". ↩
Hongjun Wu, Stream Ciphers HC-128 and HC-256 ↩
Shashwat Raizada (January 2015),"Some Results On Analysis And Implementation Of HC-128 Stream Cipher". ↩
Trait Implementations
impl Clone for Hc128Rng
[src]
impl CryptoRng for Hc128Rng
[src]
impl Debug for Hc128Rng
[src]
impl RngCore for Hc128Rng
[src]
fn next_u32(&mut self) -> u32
[src]
fn next_u64(&mut self) -> u64
[src]
fn fill_bytes(&mut self, dest: &mut [u8])
[src]
fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>
[src]
impl SeedableRng for Hc128Rng
[src]
type Seed = <Hc128Core as SeedableRng>::Seed
Seed type, which is restricted to types mutably-dereferencable as u8
arrays (we recommend [u8; N]
for some N
). Read more
fn from_seed(seed: Self::Seed) -> Self
[src]
fn from_rng<R: RngCore>(rng: R) -> Result<Self, Error>
[src]
fn seed_from_u64(state: u64) -> Self
[src]
Auto Trait Implementations
impl RefUnwindSafe for Hc128Rng
impl Send for Hc128Rng
impl Sync for Hc128Rng
impl Unpin for Hc128Rng
impl UnwindSafe for Hc128Rng
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<R> FromEntropy for R where
R: SeedableRng,
[src]
R: SeedableRng,
fn from_entropy() -> R
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<R> Rng for R where
R: RngCore + ?Sized,
[src]
R: RngCore + ?Sized,
fn gen<T>(&mut self) -> T where
Standard: Distribution<T>,
[src]
Standard: Distribution<T>,
fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T
[src]
fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T
[src]
fn sample_iter<'a, T, D: Distribution<T>>(
&'a mut self,
distr: &'a D
) -> DistIter<'a, D, Self, T>ⓘ where
Self: Sized,
[src]
&'a mut self,
distr: &'a D
) -> DistIter<'a, D, Self, T>ⓘ where
Self: Sized,
fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)
[src]
fn try_fill<T: AsByteSliceMut + ?Sized>(
&mut self,
dest: &mut T
) -> Result<(), Error>
[src]
&mut self,
dest: &mut T
) -> Result<(), Error>
fn gen_bool(&mut self, p: f64) -> bool
[src]
fn choose<'a, T>(&mut self, values: &'a [T]) -> Option<&'a T>
[src]
fn choose_mut<'a, T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
[src]
fn shuffle<T>(&mut self, values: &mut [T])
[src]
fn gen_iter<T>(&mut self) -> Generator<T, &mut Self>ⓘ where
Standard: Distribution<T>,
[src]
Standard: Distribution<T>,
fn gen_weighted_bool(&mut self, n: u32) -> bool
[src]
fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>ⓘImportant traits for AsciiGenerator<R>
impl<R: RngCore> Iterator for AsciiGenerator<R> type Item = char;
[src]
Important traits for AsciiGenerator<R>
impl<R: RngCore> Iterator for AsciiGenerator<R> type Item = char;
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,