Function getrandom::getrandom

source · [−]

pub fn getrandom(dest: &mut [u8]) -> Result<(), Error>

Expand description

Fill dest with random bytes from the system’s preferred random number -source.

-

This function returns an error on any failure, including partial reads. We -make no guarantees regarding the contents of dest on error. If dest is -empty, getrandom immediately returns success, making no calls to the -underlying operating system.

-

Blocking is possible, at least during early boot; see module documentation.

-

In general, getrandom will be fast enough for interactive usage, though -significantly slower than a user-space CSPRNG; for the latter consider -rand::thread_rng.

-