From d358d60bd8b44c3fec651b398ca41c4aa1f10377 Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Mon, 10 Jun 2019 14:08:31 +0200
Subject: doc: Mention getrandom, getentropy.

* doc/glibc-functions/getrandom.texi: New file.
* doc/glibc-functions/getentropy.texi: New file.
* doc/gnulib.texi (Glibc sys/random.h): New section.
---
 doc/glibc-functions/getentropy.texi | 29 +++++++++++++++++++++++++++++
 doc/glibc-functions/getrandom.texi  | 29 +++++++++++++++++++++++++++++
 doc/gnulib.texi                     | 12 ++++++++++++
 3 files changed, 70 insertions(+)
 create mode 100644 doc/glibc-functions/getentropy.texi
 create mode 100644 doc/glibc-functions/getrandom.texi

(limited to 'doc')

diff --git a/doc/glibc-functions/getentropy.texi b/doc/glibc-functions/getentropy.texi
new file mode 100644
index 0000000000..abdfd45c49
--- /dev/null
+++ b/doc/glibc-functions/getentropy.texi
@@ -0,0 +1,29 @@
+@node getentropy
+@subsection @code{getentropy}
+@findex getentropy
+
+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/man3/getentropy.3.html,,man getentropy}.
+@end itemize
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on many non-glibc 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, OSF/1 5.1, Solaris 11.0, Cygwin, mingw, MSVC 14, Interix 3.5, BeOS, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/getrandom.texi b/doc/glibc-functions/getrandom.texi
new file mode 100644
index 0000000000..57d55bcdd8
--- /dev/null
+++ b/doc/glibc-functions/getrandom.texi
@@ -0,0 +1,29 @@
+@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: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on many non-glibc 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, OSF/1 5.1, Solaris 11.0, Cygwin, mingw, MSVC 14, Interix 3.5, BeOS, Android 9.0.
+@end itemize
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 60d5e6f498..b37b3401e0 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -3736,6 +3736,7 @@ This list of functions is sorted according to the header that declares them.
 * Glibc sys/profil.h::
 * Glibc sys/ptrace.h::
 * Glibc sys/quota.h::
+* Glibc sys/random.h::
 * Glibc sys/reboot.h::
 * Glibc sys/resource.h::
 * Glibc sys/sem.h::
@@ -5904,6 +5905,17 @@ This list of functions is sorted according to the header that declares them.
 
 @include glibc-functions/quotactl.texi
 
+@node Glibc sys/random.h
+@section Glibc @code{<sys/random.h>}
+
+@menu
+* getentropy::
+* getrandom::
+@end menu
+
+@include glibc-functions/getentropy.texi
+@include glibc-functions/getrandom.texi
+
 @node Glibc sys/reboot.h
 @section Glibc @code{<sys/reboot.h>}
 
-- 
cgit v1.2.1