From: Wes Gibbs <wg21908@gmail.com>
Date: Sun, 2 Nov 2025 00:03:30 +0000 (-0400)
Subject: man/man2/copy_file_range.2: glibc no longer provides fallback after 2.30
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b983fe3aa92bf8713d214f599d487569b39ca818;p=thirdparty%2Fman-pages.git

man/man2/copy_file_range.2: glibc no longer provides fallback after 2.30

Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=220489>
Signed-off-by: Wes Gibbs <wg21908@gmail.com>
Message-ID: <20251102000330.155591-1-wg21908@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man2/copy_file_range.2 b/man/man2/copy_file_range.2
index e9e9e9945..9da71660c 100644
--- a/man/man2/copy_file_range.2
+++ b/man/man2/copy_file_range.2
@@ -202,10 +202,15 @@ that was also backported to earlier stable kernels.
 .SH STANDARDS
 Linux, GNU.
 .SH HISTORY
-Linux 4.5,
-but glibc 2.27 provides a user-space
-emulation when it is not available.
-.\" https://sourceware.org/git/?p=glibc.git;a=commit;f=posix/unistd.h;h=bad7a0c81f501fbbcc79af9eaa4b8254441c4a1f
+Linux 4.5.
+.P
+.\" glibc.git bad7a0c81f50 (2017-12-22; "copy_file_range: New function to copy file data")
+Before glibc 2.30, starting with glibc 2.27, the glibc wrapper function
+provided a user-space fallback implementation when the kernel did not
+implement this system call.
+.\" glibc.git 5a659ccc0ec2 (2019-06-28; "io: Remove copy_file_range emulation [BZ #24744]")
+Since glibc 2.30, that fallback has been removed; the function now
+fails with ENOSYS if the kernel lacks support for .BR copy_file_range ().
 .SH NOTES
 If
 .I fd_in