1berry/nodejs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

crypto: randomBytes is non-blocking

Browse Source 
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
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/api/crypto.markdown
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); console.log('Have %d bytes of random data: %s', buf.length, buf);
} catch (ex) { } catch (ex) {
// handle error // 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]) ## crypto.pseudoRandomBytes(size, [callback])
Generates *non*-cryptographically strong pseudo-random data. The data Generates *non*-cryptographically strong pseudo-random data. The data