vibe.d beta banner
get vibe.d
0.7.31

Class SystemRNG

Operating system specific cryptography secure random number generator.

class SystemRNG
  : RandomNumberStream;

It uses the "CryptGenRandom" function for Windows and "/dev/urandom" for Posix. It's recommended to combine the output use additional processing generated random numbers via provided functions for systems where security matters.

Constructors

Constructors

NameDescription
thisCreates new system random generator

Properties

Properties

NameTypeDescription
dataAvailableForRead[get]boolQueries if there is data available for immediate, non-blocking read.
empty[get]boolReturns true iff the end of the input stream has been reached.
leastSize[get]ulongReturns the maximum number of bytes that are known to remain in this stream until the end is reached. After leastSize() bytes have been read, the stream will either have reached EOS and empty() returns true, or leastSize() returns again a number > 0.

Methods

Methods

NameDescription
peekReturns a temporary reference to the data that is currently buffered.
readFills the buffer new random numbers.

Remarks

Windows "CryptGenRandom" RNG has known security vulnerabilities on Windows 2000 and Windows XP (assuming the attacker has control of the machine). Fixed for Windows XP Service Pack 3 and Windows Vista.

See Also

http://en.wikipedia.org/wiki/CryptGenRandom

Authors

Ilya Shipunov

Copyright

© 2013 RejectedSoftware e.K.

License

Subject to the terms of the MIT license, as written in the included LICENSE.txt file.