Struct DefaultRandomSource

pub struct DefaultRandomSource;

🔬This is a nightly-only experimental API. (random #130703)

The default random source.

This asks the system for random data suitable for cryptographic purposes such as key generation. If security is a concern, consult the platform documentation below for the specific guarantees your target provides.

The high quality of randomness provided by this source means it can be quite slow on some targets. If you need a large quantity of random numbers and security is not a concern, consider using an alternative random number generator (potentially seeded from this one).

Underlying sources

Platform	Source
Linux	getrandom or /dev/urandom after polling /dev/random
Windows	ProcessPrng
Apple	CCRandomGenerateBytes
DragonFly	arc4random_buf
ESP-IDF	esp_fill_random
FreeBSD	arc4random_buf
Fuchsia	cprng_draw
Haiku	arc4random_buf
Illumos	arc4random_buf
NetBSD	arc4random_buf
OpenBSD	arc4random_buf
Solaris	arc4random_buf
Vita	arc4random_buf
Hermit	read_entropy
Horizon	getrandom shim
Hurd, L4Re, QNX	/dev/urandom
Redox	/scheme/rand
SGX	rdrand
SOLID	SOLID_RNG_SampleRandomBytes
TEEOS	TEE_GenerateRandom
UEFI	EFI_RNG_PROTOCOL
VxWorks	randABytes after waiting for randSecure to become ready
WASI	random_get
ZKVM	sys_rand

Note that the sources used might change over time.

Consult the documentation for the underlying operations on your supported targets to determine whether they provide any particular desired properties, such as support for reseeding on VM fork operations.

Trait Implementations

impl Clone for DefaultRandomSource

fn clone(&self) -> DefaultRandomSource

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DefaultRandomSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DefaultRandomSource

fn default() -> DefaultRandomSource

Returns the “default value” for a type.

impl RandomSource for DefaultRandomSource

fn fill_bytes(&mut self, bytes: &mut [u8])

🔬This is a nightly-only experimental API. (random #130703)

Fills bytes with random bytes.

impl Copy for DefaultRandomSource