System Entropy¶
-
randomgen.entropy.random_entropy(size=
None, source='system')¶ Read entropy from the system cryptographic provider
- Parameters:¶
- size=
None¶ Output shape. If the given shape is, e.g.,
(m, n, k), thenm * n * ksamples are drawn. Default is None, in which case a single value is returned.- source=
'system'¶ Source of entropy. ‘system’ uses system cryptographic pool. ‘fallback’ uses a hash of the time and process id. ‘auto’ attempts ‘system’ before automatically falling back to ‘fallback’
- size=
- Returns:¶
entropy – Entropy bits in 32-bit unsigned integers. A scalar is returned if size is None.
- Return type:¶
intornumpy.ndarray
Notes
On Unix-like machines, reads from
/dev/urandom. On Windows machines reads from the system-preferred random number generator usingBCryptGenRandom.This function reads from the system entropy pool and so samples are not reproducible. In particular, it does NOT make use of a bit generator, and so
seedand settingstatehave no effect.Raises RuntimeError if the command fails.