Index: head/lib/libc/sys/copy_file_range.2
===================================================================
--- head/lib/libc/sys/copy_file_range.2	(revision 350324)
+++ head/lib/libc/sys/copy_file_range.2	(revision 350325)
@@ -1,191 +1,191 @@
 .\" SPDX-License-Identifier: BSD-2-Clause
 .\"
 .\" Copyright (c) 2019 Rick Macklem
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd July 24, 2019
 .Dt COPY_FILE_RANGE 2
 .Os
 .Sh NAME
 .Nm copy_file_range
 .Nd kernel copy of a byte range from one file to another
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In sys/types.h
 .In unistd.h
 .Ft ssize_t
 .Fo copy_file_range
 .Fa "int infd"
 .Fa "off_t *inoffp"
 .Fa "int outfd"
 .Fa "off_t *outoffp"
 .Fa "size_t len"
 .Fa "unsigned int flags"
 .Fc
 .Sh DESCRIPTION
 The
 .Fn copy_file_range
 system call
 copies up to
 .Fa len
 bytes from
 .Fa infd
 to
 .Fa outfd
 in the kernel.
 It may do this using a file system specific technique if
 .Fa infd
 and
 .Fa outfd
 are on the same file system.
 The
 .Fa infd
 argument must be opened for reading and the
 .Fa outfd
 argument must be opened for writing, but not
 .Dv O_APPEND .
 If
 .Fa inoffp
 or
 .Fa outoffp
 is
 .Dv NULL ,
 the file offset for
 .Fa infd
 or
 .Fa outfd
 respectively will be used and updated by
 the number of bytes copied.
 If
 .Fa inoffp
 or
 .Fa outoffp
 is not
 .Dv NULL ,
 the byte offset pointed to by
 .Fa inoffp
 or
 .Fa outoffp
 respectively will be used/updated and the file offset for
 .Fa infd
 or
 .Fa outfd
 respectively will not be affected.
 The
 .Fa flags
 argument must be 0.
 .Pp
 This system call attempts to maintain holes in the output file for
 the byte range being copied.
 However, this does not always work well.
 It is recommended that sparse files be copied in a loop using
 .Xr lseek 2
 with
 .Dv SEEK_HOLE ,
 .Dv SEEK_DATA
 arguments and this system call for the
 data ranges found.
 .Pp
 .Sh RETURN VALUES
-If it succeeds, the call returns the number of bytes copied, which can be less
+If it succeeds, the call returns the number of bytes copied, which can be fewer
 than
 .Fa len .
 .Fn copy_file_range
 should be used in a loop until copying of the desired byte range has been
 completed.
 If an error has occurred, a \-1 is returned and the error code is placed in
 the global variable
 .Va errno .
 .Sh ERRORS
 The
 .Fn copy_file_range
 system call
 will fail if:
 .Bl -tag -width Er
 .It Bq Er EBADF
 If
 .Fa
 infd
 is not open for reading or
 .Fa
 outfd
 is not open for writing, or opened for writing with
 .Dv O_APPEND ,
 or if
 .Fa infd
 and
 .Fa outfd
 refer to the same file.
 .It Bq Er EFBIG
 If the copy exceeds the process's file size limit or the maximum file size
 for the file system
 .Fa outfd
 resides on.
 .It Bq Er EINTR
 A signal interrupted the system call
 before it could be completed.
 This may happen for files on some NFS mounts.
 When this happens, the values pointed to by
 .Fa inoffp
 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.
 .It Bq Er EIO
 An I/O error occurred while reading/writing the files.
 .It Bq Er EISDIR
 If either
 .Fa infd
 or
 .Fa outfd
 refers to a directory.
 .It Bq Er ENOSPC
 File system that stores
 .Fa outfd
 is full.
 .El
 .Sh SEE ALSO
 .Xr lseek 2
 .Sh STANDARDS
 The
 .Fn copy_file_range
 system call is expected to be compatible with the Linux system call of
 the same name.
 .Sh HISTORY
 The
 .Fn copy_file_range
 function appeared in
 .Fx 13.0 .
Index: head/share/man/man9/VOP_COPY_FILE_RANGE.9
===================================================================
--- head/share/man/man9/VOP_COPY_FILE_RANGE.9	(revision 350324)
+++ head/share/man/man9/VOP_COPY_FILE_RANGE.9	(revision 350325)
@@ -1,124 +1,124 @@
 .\" SPDX-License-Identifier: BSD-2-Clause
 .\"
 .\" Copyright (c) 2019 Rick Macklem
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd July 24, 2019
 .Dt VOP_COPY_FILE_RANGE 9
 .Os
 .Sh NAME
 .Nm VOP_COPY_FILE_RANGE
 .Nd copy a byte range from one regular file to another within a file system
 .Sh SYNOPSIS
 .In sys/param.h
 .In sys/vnode.h
 .Ft int
 .Fo VOP_COPY_FILE_RANGE
 .Fa "struct vnode *invp"
 .Fa "off_t *inoff"
 .Fa "struct vnode *outvp"
 .Fa "off_t *outoff"
 .Fa "size_t *len"
 .Fa "unsigned int flags"
 .Fa "struct ucred *incred"
 .Fa "struct ucred *outcred"
 .Fa "struct thread *fsize_td"
 .Sh DESCRIPTION
 This entry point copies a byte range from one regular file to another within a
 file system.
 .Pp
 The arguments are:
 .Bl -tag -width ioflag
 .It Fa invp
 The vnode of the input file.
 .It Fa inoff
 A pointer to the file offset for the input file.
 .It Fa outvp
 The vnode of the output file.
 .It Fa outoff
 A pointer to the file offset for the output file.
 .It Fa len
 A pointer to the number of bytes to be copied.
 .It Fa flags
 Flags, should be set to 0 for now.
 .It Fa incred
 The credentials used to read
 .Fa invp .
 .It Fa outcred
 The credentials used to write
 .Fa outvp .
 .It Fa fsize_td
 The thread pointer to be passed to vn_rlimit_fsize().
 This will be
 .Dv NULL
 for a server thread without limits, such as for the NFS
 server or
 .Dv curthread
 otherwise.
 .El
 .Pp
 On entry and on return, the
 .Fa inoff
 and
 .Fa outoff
 arguments point to the locations of the file offsets.
 These file offsets should be updated by the number of bytes copied.
 The
 .Fa len
 argument points to the location that stores the number of bytes
 to be copied.
 It should be reduced by the number of bytes copied, which implies that
 the value pointed to by
 .Fa len
 will normally be zero for a non-error return.
-However, a copy of less bytes than requested is permitted.
+However, a copy of fewer bytes than requested is permitted.
 .Sh LOCKS
 The vnode are unlocked on entry and must be unlocked on return.
 The byte ranges for both
 .Fa invp
 and
 .Fa outvp
 should be range locked when this call is done.
 .Sh RETURN VALUES
 Zero is returned on success, otherwise an error code is returned.
 .Sh ERRORS
 .Bl -tag -width Er
 .It Bq Er EFBIG
 If the copy exceeds the process's file size limit or the maximum file size
 for the file system
 .Fa invp
 and
 .Fa outvp
 reside on.
 .It Bq Er EINTR
 A signal interrupted the VOP call before it could be completed.
 .It Bq Er EIO
 An I/O error occurred while reading/writing the files.
 .It Bq Er ENOSPC
 The file system is full.
 .El
 .Sh SEE ALSO
 .Xr vn_rdwr 9 ,
 .Xr vnode 9