Struct SystemRng 

pub struct SystemRng;

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

The system random number generator.

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).

If you need to fill a buffer with random bytes, use SystemRng.fill_bytes(&mut buf).

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, Cygwin	getrandom
AIX, Hurd, L4Re, QNX	/dev/urandom
Redox	/scheme/rand
RTEMS	arc4random_buf
SGX	rdrand
SOLID	SOLID_RNG_SampleRandomBytes
TEEOS	TEE_GenerateRandom
UEFI	EFI_RNG_PROTOCOL
VxWorks	randABytes after waiting for randSecure to become ready
WASIp1	random_get
WASIp2	get-random-bytes
WASIp3	get-random-bytes
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 SystemRng

fn clone(&self) -> SystemRng

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SystemRng

impl Debug for SystemRng

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

Formats the value using the given formatter.

impl Default for SystemRng

fn default() -> SystemRng

Returns the “default value” for a type.

impl Rng for SystemRng

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

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

Fills bytes with random bytes.