Skip to contentSkip to conversation

Subject: [PATCH v3] copy_file_range.2: glibc no longer provides fallback after 2.30

PATCH In review Wes Gibbs 2 participants 2 messages Nov 2, 2025 – Nov 9, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Wes Gibbs

author
#0 lore raw

PATCH v3 1/1 Subject: [PATCH v3] copy_file_range.2: glibc no longer provides fallback after 2.30

v3:
- Modified Signed-off, Wes Gibbs <[email protected]> is the author
- Clarify that glibc wrapper was introduced in 2.27
- Fixed commit link and ensured semantic newlines
- Updated to correct URL in comment to avoid 404 - Unknown commit object

Fixes: https://bugzilla.kernel.org/show_bug.cgi?id=220489
Author: Wes Gibbs <[email protected]>

---
 man/man2/copy_file_range.2 | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)
man/man2/copy_file_range.2 +9 -3
index e9e9e9945..e1e36dd5e 100644
@@ -202,10 +202,16 @@ 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.
+Linux 4.5.
+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.
+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 ().
+.\" Fallback introduced in glibc 2.27:
 .\" https://sourceware.org/git/?p=glibc.git;a=commit;f=posix/unistd.h;h=bad7a0c81f501fbbcc79af9eaa4b8254441c4a1f
+.\" Fallback removed in glibc 2.30:
+.\" https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=5a659ccc0ec217ab02a4c273a1f6d346a359560a
 .SH NOTES
 If
 .I fd_in
Signature · 1 line
2.48.1
#1 lore raw

Hi Wes,

Quoted 10 lines · Wes Gibbs

v3:
- Modified Signed-off, Wes Gibbs <[email protected]> is the author
- Clarify that glibc wrapper was introduced in 2.27
- Fixed commit link and ensured semantic newlines
- Updated to correct URL in comment to avoid 404 - Unknown commit object

Fixes: https://bugzilla.kernel.org/show_bug.cgi?id=220489
Author: Wes Gibbs <[email protected]>

---

Thanks! I've applied the patch.
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=b983fe3aa92bf8713d214f599d487569b39ca818>

Have a lovely day!
Alex

Quoted 31 lines
 man/man2/copy_file_range.2 | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)
man/man2/copy_file_range.2 +9 -3
index e9e9e9945..e1e36dd5e 100644
@@ -202,10 +202,16 @@ 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.
+Linux 4.5.
+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.
+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 ().
+.\" Fallback introduced in glibc 2.27:
 .\" https://sourceware.org/git/?p=glibc.git;a=commit;f=posix/unistd.h;h=bad7a0c81f501fbbcc79af9eaa4b8254441c4a1f
+.\" Fallback removed in glibc 2.30:
+.\" https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=5a659ccc0ec217ab02a4c273a1f6d346a359560a
 .SH NOTES
 If
 .I fd_in
Signature · 1 line
2.48.1
Signature · 2 lines
<https://www.alejandro-colomar.es>
Use port 80 (that is, <...:80/>).