[Python-checkins] cpython (merge 3.4 -> default): Issue #23025: Add a mention of os.urandom to RAND_bytes and RAND_pseudo_bytes

[berker.peksag]

https://hg.python.org/cpython/rev/7aa42cea8968
changeset:   95523:7aa42cea8968
parent:      95521:157b59609cbd
parent:      95522:f85ac33b12a1
user:        Berker Peksag <berker.peksag at gmail.com>
date:        Fri Apr 10 16:19:44 2015 +0300
summary:
  Issue #23025: Add a mention of os.urandom to RAND_bytes and RAND_pseudo_bytes docs.

Patch by Alex Gaynor.

files:
  Doc/library/ssl.rst |  4 ++++
  1 files changed, 4 insertions(+), 0 deletions(-)


diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -292,6 +292,8 @@
    can be used to check the status of the PRNG and :func:`RAND_add` can be used
    to seed the PRNG.
 
+   For almost all applications :func:`os.urandom` is preferable.
+
    Read the Wikipedia article, `Cryptographically secure pseudorandom number
    generator (CSPRNG)
    <http://en.wikipedia.org/wiki/Cryptographically_secure_pseudorandom_number_generator>`_,
@@ -311,6 +313,8 @@
    for non-cryptographic purposes and for certain purposes in cryptographic
    protocols, but usually not for key generation etc.
 
+   For almost all applications :func:`os.urandom` is preferable.
+
    .. versionadded:: 3.3
 
 .. function:: RAND_status()

-- 
Repository URL: https://hg.python.org/cpython