]> Savannah Git Hosting - gnulib.git/commitdiff
getrandom, getentropy: Mention the crypto/gc-random module.
authorBruno Haible <bruno@clisp.org>
Sun, 31 May 2020 19:01:19 +0000 (21:01 +0200)
committerBruno Haible <bruno@clisp.org>
Sun, 31 May 2020 19:01:19 +0000 (21:01 +0200)
Suggested by Simon Josefsson in
<https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00400.html>.

* doc/glibc-functions/getrandom.texi: Mention the quality issues and the
crypto/gc-random module.
* doc/glibc-functions/getentropy.texi: Likewise.

ChangeLog
doc/glibc-functions/getentropy.texi
doc/glibc-functions/getrandom.texi

index 0eb0ba8e511619190104d9792dc1aeb3870ec5cd..e6ba65b0889a5c2d90db2227cbe869f3a0ae72ce 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2020-05-31  Bruno Haible  <bruno@clisp.org>
+
+       getrandom, getentropy: Mention the crypto/gc-random module.
+       Suggested by Simon Josefsson in
+       <https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00400.html>.
+       * doc/glibc-functions/getrandom.texi: Mention the quality issues and the
+       crypto/gc-random module.
+       * doc/glibc-functions/getentropy.texi: Likewise.
+
 2020-05-31  Bruno Haible  <bruno@clisp.org>
 
        getentropy: Enhance tests.
index b7717e514b52a95826d6de2ce06b167bee1fd24d..998bcf46d68e65d4104e93aed2d35a333be616d3 100644 (file)
@@ -31,3 +31,9 @@ Mac OS X 10.13, Solaris 11.4, Android 9.0.
 Portability problems not fixed by Gnulib:
 @itemize
 @end itemize
+
+Note: This function does not provides high-quality random numbers, as needed
+by some crypto applications.  If you want such high-quality random numbers,
+use the function @code{getrandom} with the @code{GRND_RANDOM} flag or (better)
+use the @samp{crypto/gc-random} module and configure with
+@samp{--with-libgcrypt}.
index 3baf3905e21936cff861e991f140068de4ceb624..7488f6faaa02eea3743222dea463fb49b25fa1ca 100644 (file)
@@ -29,6 +29,12 @@ Solaris 11.4.
 
 Portability problems not fixed by Gnulib:
 @itemize
-This function cannot produce truly random numbers on some platforms:
+This function cannot produce truly random numbers, even when the
+@code{GRND_RANDOM} flag is given, on some platforms:
 GNU/Hurd, Mac OS X, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5, Minix 3.3, AIX 7.1, Haiku, mingw, MSVC 14.
 @end itemize
+
+Note: This function does not provides high-quality random numbers, as needed
+by some crypto applications, even when the @code{GRND_RANDOM} flag is given.
+If you want such high-quality random numbers, use the @samp{crypto/gc-random}
+module and configure with @samp{--with-libgcrypt}.