crypto: randomBytes is non-blocking

Add NOTE section in documentation, mentioning that `randomBytes` won't
block when entropy sources are drained.

fix #6372
This commit is contained in:
Fedor Indutny 2013-10-19 14:38:58 +04:00
parent fce0eb416b
commit 88dc1fcb62

View File

@ -465,8 +465,14 @@ Generates cryptographically strong pseudo-random data. Usage:
console.log('Have %d bytes of random data: %s', buf.length, buf);
} catch (ex) {
// handle error
// most likely, entropy sources are drained
}
NOTE: Will throw error or invoke callback with error, if there is not enough
accumulated entropy to generate cryptographically strong data. In other words,
`crypto.randomBytes` without callback will not block even if all entropy sources
are drained.
## crypto.pseudoRandomBytes(size, [callback])
Generates *non*-cryptographically strong pseudo-random data. The data