Struct ring::rand::SystemRandom
source · [−]pub struct SystemRandom(_);
Expand description
A secure random number generator where the random values come directly from the operating system.
A single SystemRandom
may be shared across multiple threads safely.
new()
is guaranteed to always succeed and to have low latency; it won’t
try to open or read from a file or do similar things. The first call to
fill()
may block a substantial amount of time since any and all
initialization is deferred to it. Therefore, it may be a good idea to call
fill()
once at a non-latency-sensitive time to minimize latency for
future calls.
On Linux (including Android), fill()
will use the getrandom
syscall.
If the kernel is too old to support getrandom
then by default fill()
falls back to reading from /dev/urandom
. This decision is made the first
time fill
succeeds. The fallback to /dev/urandom
can be disabled by
disabling the dev_urandom_fallback
default feature; this should be done
whenever the target system is known to support getrandom
. When
/dev/urandom
is used, a file handle for /dev/urandom
won’t be opened
until fill
is called; SystemRandom::new()
will not open /dev/urandom
or do other potentially-high-latency things. The file handle will never be
closed, until the operating system closes it at process shutdown. All
instances of SystemRandom
will share a single file handle. To properly
implement seccomp filtering when the dev_urandom_fallback
default feature
is disabled, allow getrandom
through. When the fallback is enabled, allow
file opening, getrandom
, and read
up until the first call to fill()
succeeds; after that, allow getrandom
and read
.
On macOS and iOS, fill()
is implemented using SecRandomCopyBytes
.
On wasm32-unknown-unknown (non-WASI), fill()
is implemented using
window.crypto.getRandomValues()
. It must be used in a context where the
global object is a Window
; i.e. it must not be used in a Worker or a
non-browser context.
On Windows, fill
is implemented using the platform’s API for secure
random number generation.
Implementations
sourceimpl SystemRandom
impl SystemRandom
Trait Implementations
sourceimpl Clone for SystemRandom
impl Clone for SystemRandom
sourcefn clone(&self) -> SystemRandom
fn clone(&self) -> SystemRandom
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
Auto Trait Implementations
impl RefUnwindSafe for SystemRandom
impl Send for SystemRandom
impl Sync for SystemRandom
impl Unpin for SystemRandom
impl UnwindSafe for SystemRandom
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> SecureRandom for T where
T: SecureRandom,
impl<T> SecureRandom for T where
T: SecureRandom,
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more