Skip to contentSkip to conversation

Subject: copy_file_range.2: glibc no longer provides fallback after 2.30

PATCH Superseded Wes Gibbs 1 participant 1 message Oct 29, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

v2 of 3 Superseded Latest is v3 →

lore
Share & tools
lore

Wes Gibbs

author
#0 lore raw

PATCH v2 1/1 Subject: copy_file_range.2: glibc no longer provides fallback after 2.30

Update the documentation to note that glibc no longer provides a user-space fallback for copy_file_range() when the system call is not available, as of glibc 2.30. Applications must now handle ENOSYS themselves.

---
 man/man2/copy_file_range.2 | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)
man/man2/copy_file_range.2 +9 -3
index e9e9e9945..5146c0d11 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, 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/?p=glibc.git;a=commit;h=50c6ee3e74e08b8205f18dfb2830e9ec1bcf2ad4
 .SH NOTES
 If
 .I fd_in
Signature · 1 line
2.48.1