git: 3e9515846f8c - main - read.2: Describe debug.iosize_max_clamp

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Sat, 10 Feb 2024 09:43:35 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=3e9515846f8cbff0ecccaab65d9f70890d04429e

commit 3e9515846f8cbff0ecccaab65d9f70890d04429e
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-02-10 09:40:07 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-02-10 09:43:29 +0000

    read.2: Describe debug.iosize_max_clamp
    
    same as it is done for write.2.
    
    PR:     276937
    Reported by:    bugs.freebsd.org@masklinn.net
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
---
 lib/libsys/read.2 | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/lib/libsys/read.2 b/lib/libsys/read.2
index d18584a4fa55..94644045afc1 100644
--- a/lib/libsys/read.2
+++ b/lib/libsys/read.2
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd June 4, 2020
+.Dd February 10, 2024
 .Dt READ 2
 .Os
 .Sh NAME
@@ -220,7 +220,12 @@ for this file system.
 The value
 .Fa nbytes
 is greater than
-.Dv INT_MAX .
+.Dv SSIZE_MAX
+(or greater than
+.Dv INT_MAX ,
+if the sysctl
+.Va debug.iosize_max_clamp
+is non-zero).
 .El
 .Pp
 In addition,
@@ -246,7 +251,13 @@ The sum of the
 .Fa iov_len
 values in the
 .Fa iov
-array overflowed a 32-bit integer.
+array is greater than
+.Dv SSIZE_MAX
+(or greater than
+.Dv INT_MAX ,
+if the sysctl
+.Va debug.iosize_max_clamp
+is non-zero).
 .It Bq Er EFAULT
 Part of the
 .Fa iov