doc: Mention getcpu.

* doc/glibc-functions/getcpu.texi: New file.
* doc/gnulib.texi (Glibc sched.h): Include it.

2 files changed, 31 insertions, 0 deletions

diff --git a/doc/glibc-functions/getcpu.texi b/doc/glibc-functions/getcpu.texi
new file mode 100644
index 0000000000..091304d285
--- /dev/null
+++ b/doc/glibc-functions/getcpu.texi
@@ -0,0 +1,29 @@
+@node getcpu
+@subsection @code{getcpu}
+@findex getcpu
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{CPU Affinity,,Limiting execution to certain CPUs,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/CPU-Affinity.html},
+@end ifnotinfo
+@item
+@uref{https://www.kernel.org/doc/man-pages/online/pages/man2/getcpu.2.html,,man getcpu}.
+@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 all non-glibc platforms:
+glibc 2.28, Mac OS X 10.5, FreeBSD 12.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.4, Cygwin, mingw, MSVC 14, Interix 3.5, BeOS, Android 9.0.
+@end itemize
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 3554005493..6edf92954b 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -5458,6 +5458,7 @@ This list of functions is sorted according to the header that declares them.
 
 @menu
 * clone::
+* getcpu::
 * sched_getaffinity::
 * sched_getcpu::
 * sched_setaffinity::
@@ -5465,6 +5466,7 @@ This list of functions is sorted according to the header that declares them.
 @end menu
 
 @include glibc-functions/clone.texi
+@include glibc-functions/getcpu.texi
 @include glibc-functions/sched_getaffinity.texi
 @include glibc-functions/sched_getcpu.texi
 @include glibc-functions/sched_setaffinity.texi