From 0618b6eff3e4a985e28bf6ccc5b96fe635398a18 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Mon, 10 Jun 2019 14:08:35 +0200 Subject: [PATCH] doc: Mention copy_file_range. * doc/glibc-functions/copy_file_range.texi: New file. * doc/gnulib.texi (Glibc unistd.h): Include it. --- doc/glibc-functions/copy_file_range.texi | 30 ++++++++++++++++++++++++ doc/gnulib.texi | 2 ++ 2 files changed, 32 insertions(+) create mode 100644 doc/glibc-functions/copy_file_range.texi diff --git a/doc/glibc-functions/copy_file_range.texi b/doc/glibc-functions/copy_file_range.texi new file mode 100644 index 0000000000..b257ff88f7 --- /dev/null +++ b/doc/glibc-functions/copy_file_range.texi @@ -0,0 +1,30 @@ +@node copy_file_range +@subsection @code{copy_file_range} +@findex copy_file_range + +Documentation: +@itemize +@item +@ifinfo +@ref{Copying File Data,,Copying data between two files,libc}, +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Copying-File-Data.html}, +@end ifnotinfo +@item +@uref{https://www.kernel.org/doc/man-pages/online/pages/man2/copy_file_range.2.html,,man copy_file_range}. +@end itemize + +Gnulib module: copy-file-range + +Portability problems fixed by Gnulib: +@itemize +@item +This function is missing on all non-glibc platforms: +glibc 2.26, 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. +But the replacement function is only a stub: It always fails with error ENOSYS. +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@end itemize diff --git a/doc/gnulib.texi b/doc/gnulib.texi index a8f328e5de..42ae9bfb5a 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -6301,6 +6301,7 @@ This list of functions is sorted according to the header that declares them. * acct:: * brk:: * chroot:: +* copy_file_range:: * daemon:: * dup3:: * eaccess:: @@ -6336,6 +6337,7 @@ This list of functions is sorted according to the header that declares them. @include glibc-functions/acct.texi @include glibc-functions/brk.texi @include glibc-functions/chroot.texi +@include glibc-functions/copy_file_range.texi @include glibc-functions/daemon.texi @include glibc-functions/dup3.texi @include glibc-functions/eaccess.texi -- 2.39.5