From owner-svn-src-all@freebsd.org Fri Nov 8 06:40:18 2019 Return-Path: Delivered-To: svn-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 504C61A8CB4; Fri, 8 Nov 2019 06:40:18 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 478VyB1SWHz3xJ1; Fri, 8 Nov 2019 06:40:18 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 13E3922210; Fri, 8 Nov 2019 06:40:18 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id xA86eHNW022708; Fri, 8 Nov 2019 06:40:17 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id xA86eHMw022707; Fri, 8 Nov 2019 06:40:17 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201911080640.xA86eHMw022707@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Fri, 8 Nov 2019 06:40:17 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r354528 - head/share/man/man9 X-SVN-Group: head X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: head/share/man/man9 X-SVN-Commit-Revision: 354528 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 08 Nov 2019 06:40:18 -0000 Author: rmacklem Date: Fri Nov 8 06:40:17 2019 New Revision: 354528 URL: https://svnweb.freebsd.org/changeset/base/354528 Log: Fix the man page to correctly describe the use of the "len" argument. The man page incorrectly described the use of the"len" argument, which is updated to the number of bytes copied and not reduced by the number of bytes copied. This is a content change. Modified: head/share/man/man9/VOP_COPY_FILE_RANGE.9 Modified: head/share/man/man9/VOP_COPY_FILE_RANGE.9 ============================================================================== --- head/share/man/man9/VOP_COPY_FILE_RANGE.9 Fri Nov 8 04:26:19 2019 (r354527) +++ head/share/man/man9/VOP_COPY_FILE_RANGE.9 Fri Nov 8 06:40:17 2019 (r354528) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 24, 2019 +.Dd November 7, 2019 .Dt VOP_COPY_FILE_RANGE 9 .Os .Sh NAME @@ -60,7 +60,7 @@ 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. +A pointer to the byte count for the copy. .It Fa flags Flags, should be set to 0 for now. .It Fa incred @@ -89,11 +89,11 @@ 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 +Upon a successful return .Fa len -will normally be zero for a non-error return. -However, a copy of fewer bytes than requested is permitted. +will be updated to the number of bytes actually copied. +Normally, this will be the number of bytes requested to be copied, +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