mirror of
https://https.git.savannah.gnu.org/git/gnulib.git
synced 2026-04-28 06:33:36 +00:00
d4429157c1
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.
41 lines
1.3 KiB
Plaintext
41 lines
1.3 KiB
Plaintext
@node getrandom
|
|
@subsection @code{getrandom}
|
|
@findex getrandom
|
|
|
|
Documentation:
|
|
@itemize
|
|
@item
|
|
@ifinfo
|
|
@ref{Unpredictable Bytes,,Generating Unpredictable Bytes,libc},
|
|
@end ifinfo
|
|
@ifnotinfo
|
|
@url{https://www.gnu.org/software/libc/manual/html_node/Unpredictable-Bytes.html},
|
|
@end ifnotinfo
|
|
@item
|
|
@uref{https://www.kernel.org/doc/man-pages/online/pages/man2/getrandom.2.html,,man getrandom}.
|
|
@end itemize
|
|
|
|
Gnulib module: getrandom
|
|
|
|
Portability problems fixed by Gnulib:
|
|
@itemize
|
|
@item
|
|
This function is missing on some platforms:
|
|
glibc 2.24, Mac OS X 10.5, FreeBSD 11.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.0, Cygwin, mingw, MSVC 14, Android 9.0.
|
|
@item
|
|
This function has a different return type on some platforms:
|
|
Solaris 11.4.
|
|
@end itemize
|
|
|
|
Portability problems not fixed by Gnulib:
|
|
@itemize
|
|
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}.
|