aboutsummaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/copy_file_range.2
diff options
context:
space:
mode:
authorRick Macklem <rmacklem@FreeBSD.org>2019-11-08 23:49:27 +0000
committerRick Macklem <rmacklem@FreeBSD.org>2019-11-08 23:49:27 +0000
commitfef163e11732a866e02923497b11fd29b4760e1a (patch)
treeffc0c11f6d2b03f3401223b058303197f2f4336b /lib/libc/sys/copy_file_range.2
parent15930ae1802643296b60b1058a4b446c376cf806 (diff)
downloadsrc-fef163e11732a866e02923497b11fd29b4760e1a.tar.gz
src-fef163e11732a866e02923497b11fd29b4760e1a.zip
Update the copy_file_range.2 man page to reflect the semantic change
implemented by r354564. This is a content change.
Notes
Notes: svn path=/head/; revision=354565
Diffstat (limited to 'lib/libc/sys/copy_file_range.2')
-rw-r--r--lib/libc/sys/copy_file_range.217
1 files changed, 9 insertions, 8 deletions
diff --git a/lib/libc/sys/copy_file_range.2 b/lib/libc/sys/copy_file_range.2
index 2c688008356b..033a8f64a1fb 100644
--- a/lib/libc/sys/copy_file_range.2
+++ b/lib/libc/sys/copy_file_range.2
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd July 24, 2019
+.Dd November 8, 2019
.Dt COPY_FILE_RANGE 2
.Os
.Sh NAME
@@ -113,6 +113,14 @@ data ranges found.
If it succeeds, the call returns the number of bytes copied, which can be fewer
than
.Fa len .
+Returning fewer bytes than
+.Fa len
+does not necessarily indicate that EOF was reached.
+However, a return of zero for a non-zero
+.Fa len
+argument indicates that the offset for
+.Fa infd
+is at or beyond EOF.
.Fn copy_file_range
should be used in a loop until copying of the desired byte range has been
completed.
@@ -154,13 +162,6 @@ and
.Fa outoffp
are reset to the initial values for the system call.
.It Bq Er EINVAL
-If the initial offset for
-.Fa infd
-plus
-.Fa len
-exceeds EOF for
-.Fa infd
-or
.Fa
flags
is not zero.