From: Fedor Indutny <fedor.indutny@gmail.com>
Date: Sat, 19 Oct 2013 10:38:58 +0000 (+0400)
Subject: crypto: `randomBytes` is non-blocking
X-Git-Tag: v0.10.23~31
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=88dc1fcb62f40c3c906802dcaa8a8e9dfef2a264;p=platform%2Fupstream%2Fnodejs.git

crypto: `randomBytes` is non-blocking

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

fix #6372
---

diff --git a/doc/api/crypto.markdown b/doc/api/crypto.markdown
index e0fe26f..1aba68e 100644
--- a/doc/api/crypto.markdown
+++ b/doc/api/crypto.markdown
@@ -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